doc: explain how the home directory is found on Unix-like syst.

Done for libpq, postgres-fdw, and psql.

Reported-by: [email protected]
Discussion: https://postgr.es/m/CAKFQuwZ-T-zsVM7gApS9-XU9vGxC7Oa-UyRQPVcJFagNU=AjOw@mail.gmail.com

Backpatch-through: master

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index afc9346757a7241db84b294a576994b32ea56633..bfefb1289e8a777753808034a3391599db665dfc 100644 (file)
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -9256,7 +9256,9 @@ myEventProc(PGEventId evtId, void *evtInfo, void *passThrough)
    The file .pgpass in a user's home directory can
    contain passwords to
    be used if the connection requires a password (and no password has been
-   specified otherwise). On Microsoft Windows the file is named
+   specified otherwise). On Unix systems, the directory can be specified by
+   the HOME environment variable, or if undefined, the home
+   directory of the effective user.  On Microsoft Windows the file is named
    %APPDATA%\postgresql\pgpass.conf (where
    %APPDATA% refers to the Application Data subdirectory in
    the user's profile).

diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml
index 627bb5ab5ccd1ad096edfb417cf9f308801a739d..188e8f0b4d0e862edb0d218b8e341a90db98da88 100644 (file)
--- a/doc/src/sgml/postgres-fdw.sgml
+++ b/doc/src/sgml/postgres-fdw.sgml
@@ -194,7 +194,9 @@ OPTIONS (ADD password_required 'false');
     user can potentially use any client certificates,
     .pgpass,
     .pg_service.conf etc. in the unix home directory of the
-    system user the postgres server runs as. They can also use any trust
+    system user the postgres server runs as.   (For details on how home
+    directories are found, see .)  They can
+    also use any trust
     relationship granted by authentication modes like peer
     or ident authentication.
    

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index b825ca96a2373154221923f6b68f9c62a0918df1..e42073ed7483aa32b23acf420a86d12cead86538 100644 (file)
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -1048,7 +1048,8 @@ INSERT INTO tbls1 VALUES ($1, $2) \parse stmt1
         
          Changes the current working directory to
          directory. Without argument, changes
-         to the current user's home directory.
+         to the current user's home directory.  For details on how home
+         directories are found, see .