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 

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 24212b545bf7babdc2ca280f42829d9bb9da00b1..3f76fd8d04114c52ea26fc4815ed0479b745a75d 100644 (file)
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -1,5 +1,5 @@
 
 
@@ -1124,13 +1124,15 @@ testdb=>
 
 
       
-        \dg [ pattern ]
+        \dg[+] [ pattern ]
         
         
         Lists all database roles. If 
         class="parameter">pattern is specified, only
         those roles whose names match the pattern are listed.
-        (This command is now effectively the same as \du.)
+        (This command is now effectively the same as \du).
+        If the form \dg+ is used, additional information 
+        is shown about each role, including the comment for each role.  
         
         
       
@@ -1247,12 +1249,14 @@ testdb=>
 
 
       
-        \du [ pattern ]
+        \du[+] [ pattern ]
         
         
         Lists all database roles. If 
         class="parameter">pattern is specified, only
         those roles whose names match the pattern are listed.
+        If the form \du+ is used, additional information
+        is shown about each role, including the comment for each role.
         
         
       


diff --git a/src/bin/psql/help.c b/src/bin/psql/help.c

index b04db7582eefec85d8ae13f2bd04105dba199ecb..ef297fe0095094383404451d6139fdb7547f3bb6 100644 (file)

--- a/src/bin/psql/help.c
+++ b/src/bin/psql/help.c
@@ -3,7 +3,7 @@
  *
  * Copyright (c) 2000-2009, PostgreSQL Global Development Group
  *
- * $PostgreSQL: pgsql/src/bin/psql/help.c,v 1.150 2009/06/11 14:49:08 momjian Exp $
+ * $PostgreSQL: pgsql/src/bin/psql/help.c,v 1.151 2009/07/24 19:35:44 petere Exp $
  */
 #include "postgres_fe.h"
 
@@ -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"));

diff --git a/src/bin/psql/help.c b/src/bin/psql/help.c
index b04db7582eefec85d8ae13f2bd04105dba199ecb..ef297fe0095094383404451d6139fdb7547f3bb6 100644 (file)
--- a/src/bin/psql/help.c
+++ b/src/bin/psql/help.c
@@ -3,7 +3,7 @@
  *
  * Copyright (c) 2000-2009, PostgreSQL Global Development Group
  *
- * $PostgreSQL: pgsql/src/bin/psql/help.c,v 1.150 2009/06/11 14:49:08 momjian Exp $
+ * $PostgreSQL: pgsql/src/bin/psql/help.c,v 1.151 2009/07/24 19:35:44 petere Exp $
  */
 #include "postgres_fe.h"
 
@@ -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"));