From 116572c86e9dfe164b7d8507d9e41c7be493d9be Mon Sep 17 00:00:00 2001
From: Ian Barwick <ian@2ndquadrant.com>
Date: Wed, 18 Mar 2020 17:08:08 +0900
Subject: [PATCH] doc: add note about alternative passfile locations

---
 doc/configuration-password-management.xml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/configuration-password-management.xml b/doc/configuration-password-management.xml
index 4a6a2c0b..2a535996 100644
--- a/doc/configuration-password-management.xml
+++ b/doc/configuration-password-management.xml
@@ -129,6 +129,18 @@ node3:5432:repmgr:repmgr:foo
 node3:5432:replication:repluser:foo</programlisting>
 
     </para>
+    <note>
+      <para>
+        It's possible to specify an alternative location for the <filename>~/.pgpass</filename> file, either via
+        the environment variable <envar>PGPASSFILE</envar>, or (from PostgreSQL 9.6) using the
+        <varname>passfile</varname> parameter in connection strings.
+      </para>
+      <para>
+        If using the <varname>passfile</varname> parameter, it's essential to ensure the file is in the same
+        location on all nodes, as when connecting to a remote node, the file referenced is the one on the
+        local node.
+      </para>
+    </note>
 
   </sect2>