doc: Add standard Environment section to pg_upgrade ref page

Reviewed-by: Daniel Gustafsson 
Discussion: https://www.postgresql.org/message-id/flat/8458c9c5-18f1-46d7-94c4-1c30e4f44908%40eisentraut.org

diff --git a/doc/src/sgml/ref/pgupgrade.sgml b/doc/src/sgml/ref/pgupgrade.sgml
index 10c842adb1442493a2c639d74c1ffa93b5ffab53..9877f2f01c69139887b7cc32eba5c6abb9ca9b64 100644 (file)
--- a/doc/src/sgml/ref/pgupgrade.sgml
+++ b/doc/src/sgml/ref/pgupgrade.sgml
@@ -939,6 +939,104 @@ psql --username=postgres --file=script.sql postgres
 
  
 
+ 
+  Environment
+
+  
+   Some environment variables can be used to provide defaults for command-line options:
+
+   
+    
+     PGBINOLD
+
+     
+      
+       The old PostgreSQL executable directory; option
+       -b/--old-bindir.
+      
+     
+    
+
+    
+     PGBINNEW
+
+     
+      
+       The new PostgreSQL executable directory; option
+       -B/--new-bindir.
+      
+     
+    
+
+    
+     PGDATAOLD
+
+     
+      
+       The old database cluster configuration directory; option
+       -d/--old-datadir.
+      
+     
+    
+
+    
+     PGDATANEW
+
+     
+      
+       The new database cluster configuration directory; option
+       -D/--new-datadir.
+      
+     
+    
+
+    
+     PGPORTOLD
+
+     
+      
+       The old cluster port number; option
+       -p/--old-port.
+      
+     
+    
+
+    
+     PGPORTNEW
+
+     
+      
+       The new cluster port number; option
+       -P/--new-port.
+      
+     
+    
+
+    
+     PGSOCKETDIR
+
+     
+      
+       Directory to use for postmaster sockets during upgrade; option
+       -s/--socketdir.
+      
+     
+    
+
+    
+     PGUSER
+
+     
+      
+       Cluster's install user name; option
+       -U/--username.
+      
+     
+    
+   
+  
+ 
+
  
   Notes