From fe626982182bd1c8cd2606027a4d49a2f31a01c3 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Tue, 20 Jan 2009 02:38:37 +0000
Subject: [PATCH] Update \d*S documentation to be more accurate;  system
 objects are added to the display, not restricted in the display; new text:

        The letter <literal>S</literal> adds the listing of system
        objects; without <literal>S</literal>, only non-system
        objects are shown.
---
 doc/src/sgml/ref/psql-ref.sgml | 50 +++++++++++++++++++---------------
 1 file changed, 28 insertions(+), 22 deletions(-)

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index b200e23bf9..5dd019d7f7 100644
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.217 2009/01/09 19:27:14 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.218 2009/01/20 02:38:37 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -833,8 +833,9 @@ testdb=&gt;
         more information is displayed: any comments associated with the
         columns of the table are shown, as is the presence of OIDs in the
         table.
-        The letter <literal>S</literal> restricts the listing to system objects; without
-        <literal>S</literal>, only non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         </para>
 
         <note>
@@ -858,9 +859,9 @@ testdb=&gt;
         return type and the data types they operate on. If <replaceable
         class="parameter">pattern</replaceable>
         is specified, only aggregates whose names match the pattern are shown.
-        The letter <literal>S</literal> restricts the listing
-        to system objects; without <literal>S</literal>, only
-        non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         </para>
         </listitem>
       </varlistentry>
@@ -889,8 +890,9 @@ testdb=&gt;
         If <replaceable class="parameter">pattern</replaceable>
         is specified, only conversions whose names match the pattern are
         listed.
-        The letter <literal>S</literal> restricts the listing to system objects; without
-        <literal>S</literal>, only non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         </para>
         </listitem>
       </varlistentry>
@@ -917,8 +919,9 @@ testdb=&gt;
         class="parameter">pattern</replaceable>, or of all visible objects if
         no argument is given.  But in either case, only objects that have
         a description are listed.
-        The letter <literal>S</literal> restricts the listing to system objects; without
-        <literal>S</literal>, only non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         (<quote>Object</quote> covers aggregates, functions, operators,
         types, relations (tables, views, indexes, sequences, large
         objects), rules, and triggers.) For example:
@@ -948,8 +951,9 @@ testdb=&gt;
         Lists all available domains. If <replaceable
         class="parameter">pattern</replaceable>
         is specified, only matching domains are shown.
-        The letter <literal>S</literal> restricts the listing to system objects; without
-        <literal>S</literal>, only non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         </para>
         </listitem>
       </varlistentry>
@@ -1021,8 +1025,9 @@ testdb=&gt;
         is specified, only functions whose names match the pattern are shown.
         If the form <literal>\df+</literal> is used, additional information about
         each function, including volatility, language, source code and description, is shown.
-        The letter <literal>S</literal> restricts the listing to system objects; without
-        <literal>S</literal>, only non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         </para>
 
         <note>
@@ -1130,9 +1135,9 @@ testdb=&gt;
         and tables.  If <literal>+</literal> is
         appended to the command name, each object is listed with its
         physical size on disk and its associated description, if any.
-        The letter <literal>S</literal> restricts the listing
-        to system objects; without <literal>S</literal>, only
-        non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         </para>
 
         <para>
@@ -1177,9 +1182,9 @@ testdb=&gt;
         Lists available operators with their operand and return types.
         If <replaceable class="parameter">pattern</replaceable> is
         specified, only operators whose names match the pattern are listed.
-        The letter <literal>S</literal> restricts the listing
-        to system objects; without <literal>S</literal>, only
-        non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         </para>
         </listitem>
       </varlistentry>
@@ -1212,8 +1217,9 @@ testdb=&gt;
         class="parameter">pattern</replaceable>. The command form
         <literal>\dT+</literal> shows extra information, namely the type's internal name, size, and
         allowed values for <type>enum</> types.
-        The letter <literal>S</literal> restricts the listing to system objects; without
-        <literal>S</literal>, only non-system objects are shown.
+        The letter <literal>S</literal> adds the listing of system
+        objects; without <literal>S</literal>, only non-system
+        objects are shown.
         </para>
         </listitem>
       </varlistentry>