Doc: fix some description of environment variables with frontend tools

This addresses a couple of issues in the documentation:
- Description of PG_COLOR was missing for some tools (pg_archivecleanup
and pg_test_fsync), while the other descriptions had grammar mistakes.
- pgbench supports more environment variables: PGUSER, PGHOST and
PGPORT.
- vacuumlo, oid2name and pgbench support coloring (HEAD only)

Author: Michael Paquier
Reviewed-by: Fabien Coelho, Daniel Gustafsson, Juan José Santamaría
Flecha
Discussion: https://postgr.es/m/20200304075418[email protected]
Backpatch-through: 12

diff --git a/doc/src/sgml/oid2name.sgml b/doc/src/sgml/oid2name.sgml
index c7ebd61c6bf1caa3875e9fc634de3155f3039159..dfe368273918181c634cc99f727d6317d40d074b 100644 (file)
--- a/doc/src/sgml/oid2name.sgml
+++ b/doc/src/sgml/oid2name.sgml
@@ -223,6 +223,13 @@
    utilities, also uses the environment variables supported by
    libpq (see ).
   
+
+  
+   The environment variable PG_COLOR specifies whether to use
+   color in diagnostic messages. Possible values are
+   always, auto and
+   never.
+  
  
 
  

diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml
index d11ac2dc9c410132bfd7d7fc3bf3a934e9aa4a91..177856ca74d257a54e0b5f01d5caa6236f6b5604 100644 (file)
--- a/doc/src/sgml/ref/clusterdb.sgml
+++ b/doc/src/sgml/ref/clusterdb.sgml
@@ -279,8 +279,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml
index 8fc8128bf9c4c50a5b55ef618c837e32b330155e..2fca26237e3ab43268c8a9a0917f9fb437ef9d5c 100644 (file)
--- a/doc/src/sgml/ref/createdb.sgml
+++ b/doc/src/sgml/ref/createdb.sgml
@@ -327,8 +327,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml
index abe25f17d015b8ebec47fbefbfe16c1ccff3a51a..9d24df8b7a8879e5e3de695f943eced5dd1ebbe4 100644 (file)
--- a/doc/src/sgml/ref/createuser.sgml
+++ b/doc/src/sgml/ref/createuser.sgml
@@ -405,8 +405,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml
index f79bbb9a85ae7766e0e75b4d4ac36ab96add29f2..28b18bfcb0c096f409dc86089df42a6bf8cdb768 100644 (file)
--- a/doc/src/sgml/ref/dropdb.sgml
+++ b/doc/src/sgml/ref/dropdb.sgml
@@ -245,8 +245,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml
index 72bb7e8535cd8a6e8c27634e957b4a375bea988a..f9aab340d3bad8ad15f89b421643bdeb135ddf8e 100644 (file)
--- a/doc/src/sgml/ref/dropuser.sgml
+++ b/doc/src/sgml/ref/dropuser.sgml
@@ -225,8 +225,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml
index da5c8f53075ca934295fa221b56bb33699075da4..a04a180165007aefd34ff3b21f4b6493c00b7a03 100644 (file)
--- a/doc/src/sgml/ref/initdb.sgml
+++ b/doc/src/sgml/ref/initdb.sgml
@@ -466,8 +466,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/pg_basebackup.sgml b/doc/src/sgml/ref/pg_basebackup.sgml
index fc9ba2e8b00eb4b26a7e4963c681762e2f467e85..29bf2f9b9795257be475233d3ad2ee8bb50cff7a 100644 (file)
--- a/doc/src/sgml/ref/pg_basebackup.sgml
+++ b/doc/src/sgml/ref/pg_basebackup.sgml
@@ -706,8 +706,8 @@ PostgreSQL documentation
 
   
    The environment variable PG_COLOR specifies whether to use
-   color in diagnostics messages.  Possible values are
-   always, auto,
+   color in diagnostic messages. Possible values are
+   always, auto and
    never.
   
  

diff --git a/doc/src/sgml/ref/pg_checksums.sgml b/doc/src/sgml/ref/pg_checksums.sgml
index 162bafdb33134d43d2a1a61c6d76b0c4f332ff66..6baf9deaaeae2b2e652de696a539592a44de9aa6 100644 (file)
--- a/doc/src/sgml/ref/pg_checksums.sgml
+++ b/doc/src/sgml/ref/pg_checksums.sgml
@@ -191,8 +191,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/pg_controldata.sgml b/doc/src/sgml/ref/pg_controldata.sgml
index abac59aa500b8e5e997ce0b57241a57263b3d487..4aae8b193dea7fe4a1dabd588a6f15e84df46cdc 100644 (file)
--- a/doc/src/sgml/ref/pg_controldata.sgml
+++ b/doc/src/sgml/ref/pg_controldata.sgml
@@ -73,8 +73,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 4bcd4bdaefea8d9d9852db1e0fd32888f787481f..13bd320b3135a45e5e92c7d5c671032e42da16c0 100644 (file)
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -1229,8 +1229,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml
index 7268be9f3efcdefcbea9efd2c59d060e896e8b58..f0859896c547a3c06b1e53e5feffd533dbecbbc3 100644 (file)
--- a/doc/src/sgml/ref/pg_dumpall.sgml
+++ b/doc/src/sgml/ref/pg_dumpall.sgml
@@ -701,8 +701,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/pg_isready.sgml b/doc/src/sgml/ref/pg_isready.sgml
index 68447b5093d708e06920bef7edde78edaea45df7..3d5b551b87f26493476dee1e8fe0b7ca7adf39d9 100644 (file)
--- a/doc/src/sgml/ref/pg_isready.sgml
+++ b/doc/src/sgml/ref/pg_isready.sgml
@@ -167,8 +167,8 @@ PostgreSQL documentation
 
   
    The environment variable PG_COLOR specifies whether to use
-   color in diagnostics messages.  Possible values are
-   always, auto,
+   color in diagnostic messages. Possible values are
+   always, auto and
    never.
   
  

diff --git a/doc/src/sgml/ref/pg_receivewal.sgml b/doc/src/sgml/ref/pg_receivewal.sgml
index 177e9211c08f3584cfd8f92c3cedc28c1e8d3291..febfc0ba135a90ec066f9a83a8b16cf96a309f85 100644 (file)
--- a/doc/src/sgml/ref/pg_receivewal.sgml
+++ b/doc/src/sgml/ref/pg_receivewal.sgml
@@ -420,8 +420,8 @@ PostgreSQL documentation
 
   
    The environment variable PG_COLOR specifies whether to use
-   color in diagnostics messages.  Possible values are
-   always, auto,
+   color in diagnostic messages. Possible values are
+   always, auto and
    never.
   
  

diff --git a/doc/src/sgml/ref/pg_recvlogical.sgml b/doc/src/sgml/ref/pg_recvlogical.sgml
index 4c79f90414da226e3897640939e1f3a54658c87d..41508fdc1e56cc6c9c9322c371580a1f3ba54315 100644 (file)
--- a/doc/src/sgml/ref/pg_recvlogical.sgml
+++ b/doc/src/sgml/ref/pg_recvlogical.sgml
@@ -400,8 +400,8 @@ PostgreSQL documentation
 
   
    The environment variable PG_COLOR specifies whether to use
-   color in diagnostics messages.  Possible values are
-   always, auto,
+   color in diagnostic messages. Possible values are
+   always, auto and
    never.
   
  

diff --git a/doc/src/sgml/ref/pg_resetwal.sgml b/doc/src/sgml/ref/pg_resetwal.sgml
index 8a9e22d050fb622eec5f09c44a88cced7289e3fa..3b6c32c8d32eaf9d4c72b40a7565366068d56510 100644 (file)
--- a/doc/src/sgml/ref/pg_resetwal.sgml
+++ b/doc/src/sgml/ref/pg_resetwal.sgml
@@ -328,8 +328,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index c6013546a0e611d8081683c59c63f41d6e3dad72..e9a145ad6eadbb7d844ddafb33477e88f82957f7 100644 (file)
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -827,8 +827,8 @@
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/pg_rewind.sgml b/doc/src/sgml/ref/pg_rewind.sgml
index 42d29edd4e963ab2aeeca220f6119b4b1a654ded..f64d659522eed0c55b3afa10cd50c5174ed774dc 100644 (file)
--- a/doc/src/sgml/ref/pg_rewind.sgml
+++ b/doc/src/sgml/ref/pg_rewind.sgml
@@ -269,8 +269,8 @@ PostgreSQL documentation
 
   
    The environment variable PG_COLOR specifies whether to use
-   color in diagnostics messages.  Possible values are
-   always, auto,
+   color in diagnostic messages. Possible values are
+   always, auto and
    never.
   
  

diff --git a/doc/src/sgml/ref/pg_waldump.sgml b/doc/src/sgml/ref/pg_waldump.sgml
index 329c10e43037ebd88bd6bb959c0d6944a2fe2826..667093f06014ccf2dc5400a56ce598c952b27be2 100644 (file)
--- a/doc/src/sgml/ref/pg_waldump.sgml
+++ b/doc/src/sgml/ref/pg_waldump.sgml
@@ -223,8 +223,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/pgarchivecleanup.sgml b/doc/src/sgml/ref/pgarchivecleanup.sgml
index a3d3538b28a274604f33c2fa47d213892bc4c29a..84c2df572a67bf1c5f06cd2c35328458b089dc1f 100644 (file)
--- a/doc/src/sgml/ref/pgarchivecleanup.sgml
+++ b/doc/src/sgml/ref/pgarchivecleanup.sgml
@@ -147,6 +147,18 @@ pg_archivecleanup:  removing file "archive/00000001000000370000000E"
    
  
 
+ 
+  Environment
+
+  
+   The environment variable PG_COLOR specifies whether to use
+   color in diagnostic messages. Possible values are
+   always, auto and
+   never.
+  
+ 
+ 
+ 
  
   Notes
 

diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml
index 4c48a58ed271d996675d6637f72d945ac3a2fc90..41b3880c91f7ce16a70d2c998722b8451d922947 100644 (file)
--- a/doc/src/sgml/ref/pgbench.sgml
+++ b/doc/src/sgml/ref/pgbench.sgml
@@ -883,6 +883,37 @@ pgbench  options  d
   
  
 
+ 
+  Environment
+
+  
+   
+    PGHOST
+    PGPORT
+    PGUSER
+
+    
+     
+      Default connection parameters.
+     
+    
+   
+   
+
+  
+   This utility, like most other PostgreSQL utilities,
+   uses the environment variables supported by libpq
+   (see ).
+  
+  
+  
+   The environment variable PG_COLOR specifies whether to use
+   color in diagnostic messages. Possible values are
+   always, auto and
+   never.
+  
+ 
+ 
  
   Notes
 

diff --git a/doc/src/sgml/ref/pgtestfsync.sgml b/doc/src/sgml/ref/pgtestfsync.sgml
index 501157cb3695027a13a422126c4e2d0cfa5fd006..c6aa5673f145c45d51ceb1f294cd33b329b461f7 100644 (file)
--- a/doc/src/sgml/ref/pgtestfsync.sgml
+++ b/doc/src/sgml/ref/pgtestfsync.sgml
@@ -103,6 +103,17 @@
 
  
 
+ 
+  Environment
+
+  
+   The environment variable PG_COLOR specifies whether to use
+   color in diagnostic messages. Possible values are
+   always, auto and
+   never.
+  
+ 
+ 
  
   See Also
 

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 67ecec27cf909026e066e6c438fa05267f1a7437..402c4b1b266d3de104073ef00a87ebaa39f2cb1f 100644 (file)
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -4501,8 +4501,8 @@ $endif
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/reindexdb.sgml b/doc/src/sgml/ref/reindexdb.sgml
index 0128118cc7a34c53d3e688480a3f791477c23626..f6c3d9538bb359666e55fdb95170fd3fd006491f 100644 (file)
--- a/doc/src/sgml/ref/reindexdb.sgml
+++ b/doc/src/sgml/ref/reindexdb.sgml
@@ -380,8 +380,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml
index cf7f77ba30a661115129ae9783197c6e1dcbc8c0..fd1dc140abadf2ce0259cc89200445488420191f 100644 (file)
--- a/doc/src/sgml/ref/vacuumdb.sgml
+++ b/doc/src/sgml/ref/vacuumdb.sgml
@@ -474,8 +474,8 @@ PostgreSQL documentation
     PG_COLOR
     
      
-      Specifies whether to use color in diagnostics messages.  Possible values
-      are always, auto,
+      Specifies whether to use color in diagnostic messages. Possible values
+      are always, auto and
       never.
      
     

diff --git a/doc/src/sgml/vacuumlo.sgml b/doc/src/sgml/vacuumlo.sgml
index 0b57a77af417ed3a3a885933c03a340deef220e3..26b764d54b7d0dcbbebb41e7d4fbf723155dad56 100644 (file)
--- a/doc/src/sgml/vacuumlo.sgml
+++ b/doc/src/sgml/vacuumlo.sgml
@@ -196,6 +196,13 @@
    also uses the environment variables supported by libpq
    (see ).
   
+
+  
+   The environment variable PG_COLOR specifies whether to use
+   color in diagnostic messages. Possible values are
+   always, auto and
+   never.
+