Document \dg+ and \du+

The fact that \dg and \du take the + option was missing in the documentation.

backpatched to 8.4

Author: Andreas Wenk <a.wenk@netzmeister-st-pauli.de>

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index cd94af11f653dcd1c872454ef17344e09033a247..56f61349a88a6d681bd4b414871e77b25503abe0 100644 (file)
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -1124,13 +1124,15 @@ testdb=>
 
 
       <varlistentry>
-        <term><literal>\dg [ <replaceable class="parameter">pattern</replaceable> ]</literal></term>
+        <term><literal>\dg[+] [ <replaceable class="parameter">pattern</replaceable> ]</literal></term>
         <listitem>
         <para>
         Lists all database roles. If <replaceable
         class="parameter">pattern</replaceable> is specified, only
         those roles whose names match the pattern are listed.
-        (This command is now effectively the same as <literal>\du</>.)
+        (This command is now effectively the same as <literal>\du</literal>).
+        If the form <literal>\dg+</literal> is used, additional information 
+        is shown about each role, including the comment for each role.  
         </para>
         </listitem>
       </varlistentry>
@@ -1247,12 +1249,14 @@ testdb=&gt;
 
 
       <varlistentry>
-        <term><literal>\du [ <replaceable class="parameter">pattern</replaceable> ]</literal></term>
+        <term><literal>\du[+] [ <replaceable class="parameter">pattern</replaceable> ]</literal></term>
         <listitem>
         <para>
         Lists all database roles. If <replaceable
         class="parameter">pattern</replaceable> is specified, only
         those roles whose names match the pattern are listed.
+        If the form <literal>\du+</literal> is used, additional information
+        is shown about each role, including the comment for each role.
         </para>
         </listitem>
       </varlistentry>

diff --git a/src/bin/psql/help.c b/src/bin/psql/help.c
index 5f13b8abda3f79209b7fc80422345df6b2592202..74c379f2612d1ce351a160be5d78cb6f85dceb28 100644 (file)
--- a/src/bin/psql/help.c
+++ b/src/bin/psql/help.c
@@ -210,7 +210,7 @@ slashUsage(unsigned short int pager)
        fprintf(output, _("  \\dFd[+] [PATTERN]      list text search dictionaries\n"));
        fprintf(output, _("  \\dFp[+] [PATTERN]      list text search parsers\n"));
        fprintf(output, _("  \\dFt[+] [PATTERN]      list text search templates\n"));
-       fprintf(output, _("  \\dg     [PATTERN]      list roles (groups)\n"));
+       fprintf(output, _("  \\dg[+]  [PATTERN]      list roles (groups)\n"));
        fprintf(output, _("  \\di[S+] [PATTERN]      list indexes\n"));
        fprintf(output, _("  \\dl                    list large objects, same as \\lo_list\n"));
        fprintf(output, _("  \\dn[+]  [PATTERN]      list schemas\n"));
@@ -219,7 +219,7 @@ slashUsage(unsigned short int pager)
        fprintf(output, _("  \\ds[S+] [PATTERN]      list sequences\n"));
        fprintf(output, _("  \\dt[S+] [PATTERN]      list tables\n"));
        fprintf(output, _("  \\dT[S+] [PATTERN]      list data types\n"));
-       fprintf(output, _("  \\du     [PATTERN]      list roles (users)\n"));
+       fprintf(output, _("  \\du[+]  [PATTERN]      list roles (users)\n"));
        fprintf(output, _("  \\dv[S+] [PATTERN]      list views\n"));
        fprintf(output, _("  \\l[+]                  list all databases\n"));
        fprintf(output, _("  \\z      [PATTERN]      same as \\dp\n"));