> > I had great difficulty in finding how to change the search path, so here

> > is a patch to add some cross-referencing.

Oliver Elphick

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 51745a681da636fe80703a6cc90cdcb44c47000f..fb387584ed574b1b0cf6198e4313827c5cfa2217 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.115 2002/08/21 16:08:19 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.116 2002/08/22 04:52:16 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -5144,6 +5144,17 @@ SELECT NULLIF(value, '(none)') ...
     path returned.
    </para>
 
+   <para id=set-search-path xreflabel="SET SEARCH_PATH">
+    <indexterm>
+     <primary>search path</primary>
+     <secondary>changing at runtime</secondary>
+    </indexterm>
+    The search path may be altered by a runtime-alterable GUC setting.  The
+    command to use is <command>
+     SET SEARCH_PATH '<varname>schema</varname>'[,'<varname>schema</varname>']...
+    </command>
+   </para>
+
    <table>
     <title>System Information Functions</title>
     <tgroup cols="3">

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 05efc5056612336b26a45b20b9128cac6f2e84e7..b2d7e4d84f0cf186205e8828a2fe7968e6a16b57 100644 (file)
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.126 2002/08/18 03:03:25 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.127 2002/08/22 04:52:17 momjian Exp $
 -->
 
 <Chapter Id="runtime">
@@ -1608,6 +1608,10 @@ dynamic_library_path = '/usr/local/lib/postgresql:/home/my_project/lib:$libdir'
        </para>
 
        <para>
+        <indexterm>
+         <primary>schemas</primary>
+         <secondary>current schema</secondary>
+        </indexterm>
         The current effective value of the search path can be examined
        via the SQL function <function>current_schemas()</>.  This is not
        quite the same as examining the value of

diff --git a/doc/src/sgml/syntax.sgml b/doc/src/sgml/syntax.sgml
index a99a526db186749bb9b0a213899feb5ee1913301..67d57883c3aa88eda104ceafa55e5e2e56ba85ac 100644 (file)
--- a/doc/src/sgml/syntax.sgml
+++ b/doc/src/sgml/syntax.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/syntax.sgml,v 1.66 2002/08/13 20:40:43 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/syntax.sgml,v 1.67 2002/08/22 04:52:17 momjian Exp $
 -->
 
 <chapter id="sql-syntax">
@@ -965,6 +965,11 @@ SELECT 3 OPERATOR(pg_catalog.+) 4;
     place <literal>pg_catalog</> at the end of your search path if you
     prefer to have user-defined names override built-in names.
    </para>
+
+    <para>
+     The search path is determined by the GUC variable SEARCH_PATH and
+     may be changed at any time.  See <xref linkend="set-search-path">.
+    </para>
   </sect2>
 
   <sect2 id="sql-reserved-names">