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 b200e23bf91..5dd019d7f72 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=>
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=>
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=>
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=>
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=>
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=>
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=>
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=>
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=>
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>
--
GitLab