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.
This commit is contained in:
Bruce Momjian 2009-01-20 02:38:37 +00:00
parent 71928e7b9f
commit fe62698218

View File

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