From 1d3a47af0ce4bff7c3b92e614266b8bf45a118ef Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Sat, 13 Oct 2001 04:23:50 +0000
Subject: Attached patch for unconditional enabling of pltcl-unknown support.

Enabling this feature adds very light overhead of 1 select from pg_class on
first using of pl/tcl in backend if unknown suppport is really unused.
But pl/tcl with this support has very improved functionality.

Patch includes changes to documentation.
---
 doc/src/sgml/installation.sgml | 11 +----------
 doc/src/sgml/pltcl.sgml        | 31 ++++++++++++++-----------------
 2 files changed, 15 insertions(+), 27 deletions(-)

(limited to 'doc/src')

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index aaf2c0e4c02..4bb0fcca3ff 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1,4 +1,4 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.61 2001/10/09 22:32:32 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.62 2001/10/13 04:23:50 momjian Exp $ -->
 
 <chapter id="installation">
  <title><![%standalone-include[<productname>PostgreSQL</>]]>
@@ -683,15 +683,6 @@ su - postgres
        </listitem>
       </varlistentry>
 
-      <varlistentry>
-       <term><option>--enable-pltcl-unknown</option></term>
-       <listitem>
-        <para>
-         Enables enables PL/Tcl unknown support.
-        </para>
-       </listitem>
-      </varlistentry>
-
       <varlistentry>
        <term><option>--enable-odbc</option></term>
        <listitem>
diff --git a/doc/src/sgml/pltcl.sgml b/doc/src/sgml/pltcl.sgml
index 0c2e541e3fa..4f3f42a0274 100644
--- a/doc/src/sgml/pltcl.sgml
+++ b/doc/src/sgml/pltcl.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/pltcl.sgml,v 2.14 2001/09/13 15:55:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/pltcl.sgml,v 2.15 2001/10/13 04:23:50 momjian Exp $
 -->
 
  <chapter id="pltcl">
@@ -513,11 +513,13 @@ CREATE FUNCTION t1_count(int4, int4) RETURNS int4 AS '
       </listitem>
      </varlistentry>
 
-     <varlistentry>
-      <term>
-       Modules and the <function>unknown</> command
-      </term>
-      <listitem>
+
+    </variablelist>
+
+   </sect2>
+
+   <sect2>
+       <title> Modules and the <function>unknown</> command</title>
        <para>
 	PL/Tcl has a special support for things often used. It
 	recognizes two magic tables, <literal>pltcl_modules</> and
@@ -526,20 +528,15 @@ CREATE FUNCTION t1_count(int4, int4) RETURNS int4 AS '
 	creation. Whenever an unknown Tcl procedure is called, the
 	unknown proc is asked to check if the procedure is defined in
 	one of the modules. If this is true, the module is loaded on
-	demand.  To enable this behavior, the
-	<productname>PostgreSQL</> must be configured with the option
-	<option>--enable-pltcl-unknown</option>.
+	demand.
        </para>
        <para>
-	There are support scripts to maintain these tables in the modules
-	subdirectory of the PL/Tcl source including the source for the
-	unknown module that must get installed initially.
+	There are support scripts to maintain these tables:
+	<command>pltcl_loadmod</>,<command>pltcl_listmod</>,
+	<command>pltcl_delmod</> and source for the
+	unknown module <filename>share/unknown.pltcl</> that must be loaded
+	into database initially for getting unknown support.
        </para>
-      </listitem>
-     </varlistentry>
-
-    </variablelist>
-
    </sect2>
 
   </sect1>
-- 
cgit v1.2.3