Date: Mon, 3 Oct 2022 23:11:28 +0800
From: Julien Rouhaud <rjuju123@gmail.com>
To: geoff.michaels@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: More explicit documentation neede on "pgpass"
Message-ID: <20221003151128.oo4lsjevvrdlhjl5@jrouhaud>
References: <166480502693.662.15878694899221143205@wrigleys.postgresql.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <166480502693.662.15878694899221143205@wrigleys.postgresql.org>
Archived-At: 
 <https://www.postgresql.org/message-id/20221003151128.oo4lsjevvrdlhjl5%40jrouhaud>
Precedence: bulk

Hi,

On Mon, Oct 03, 2022 at 01:50:26PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/14/libpq-pgpass.html
> Description:
> 
> The subdirectory of $APPDATA$ should be stated explicitly in the
> documentation. The choices are "\AppData\Local", "\AppData\LocalLow", and
> "\AppData\Roaming". There is no good reason to make the user guess where to
> create it when the address C:\Users\geoff\AppData is known and loved (but
> obviously not the correct answer).

The documentation says %APPDATA%, not $APPDATA$.  That's a system variable
that you can use in the explorer or a command prompt, that will tell you where
it the directory on your machine (you could alternatively look at Windows
documentation to get the same answer).  It seems to have frequently changed
across Windows versions, which is why we can't document where it actually is.