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/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml
index b25845ffc6703f24abc6695281daea16d32d95d5..218094f086de4b2cca0ed5ddf42443ab9c9f671a 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 3fbdb337164a16c1daee85c75649b17a405d2c1e..38da0c25034b6181432415a2d32b148f033143ad 100644 (file)
--- a/doc/src/sgml/ref/dropdb.sgml
+++ b/doc/src/sgml/ref/dropdb.sgml
@@ -233,8 +233,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 fc9e222f8d0b8dec3cdf9c747d1b6c0ec097415e..37d9efdc28495f4235b44eb811eaf60e36e5bb6f 100644 (file)
--- a/doc/src/sgml/ref/pg_basebackup.sgml
+++ b/doc/src/sgml/ref/pg_basebackup.sgml
@@ -690,8 +690,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 ac142d22fcd11ad5d1022c0ea6ccacf87bbf790a..76a0c7327ad0db45cdfdfadf7b195027c0c1a94e 100644 (file)
--- a/doc/src/sgml/ref/pg_rewind.sgml
+++ b/doc/src/sgml/ref/pg_rewind.sgml
@@ -239,8 +239,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 11fa7c48e0236f09ca57d8bf10cf25b46af49da4..3c2bcc4c4e880625b8bfb6ab1899344a636ac210 100644 (file)
--- a/doc/src/sgml/ref/pgbench.sgml
+++ b/doc/src/sgml/ref/pgbench.sgml
@@ -823,6 +823,30 @@ 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 ).
+  
+ 
+ 
  
   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 c6c20de24347237d7e043ced0579509c7bd1e3ee..cfd0918751fd2740dc278cf0ea02bf8826b5a5de 100644 (file)
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -4378,8 +4378,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 25b5a72770571b79c192f3d85faa4a42e1adc772..860c579a3f004a89a21419bcc63f77d28c223862 100644 (file)
--- a/doc/src/sgml/ref/reindexdb.sgml
+++ b/doc/src/sgml/ref/reindexdb.sgml
@@ -357,8 +357,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 47d93456f862009cb3519d13c4d71e7c59c03a02..1c301bb6d7f72c8f1cbd2ab471338041a1fee433 100644 (file)
--- a/doc/src/sgml/ref/vacuumdb.sgml
+++ b/doc/src/sgml/ref/vacuumdb.sgml
@@ -456,8 +456,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.