Re: More explicit documentation neede on "pgpass"

Поиск
Список
Период
Сортировка
От Geoff Michaels
Тема Re: More explicit documentation neede on "pgpass"
Дата
Msg-id CAHBD1Un-TuC=xBhBAo7y2GJrbBKyUeR74ascZ1-NuS2hFo1M7w@mail.gmail.com
обсуждение исходный текст
Ответ на Re: More explicit documentation neede on "pgpass"  (Julien Rouhaud <rjuju123@gmail.com>)
Список pgsql-docs
Thanks. I had missed the distinction between $APPDATA$ and %APPDATA%. I will assume that I will find that %APPDATA% defaults to ...\APPDATA\ROAMING. 

If one is inspired to try to "idiot-proof" the documentation, one could insert the parenthetical expression "(typically \AppData\Roaming)" for those that use Windows out of the box and are directed to bonafide documentation that assumes a lot about the users.


--
Geoff Michaels, President
G. Michaels Consulting Ltd
Phone (866 or 780) 438-2101

Prod me to add more DBDOC Techniques and News


On Mon, Oct 3, 2022 at 9:11 AM Julien Rouhaud <rjuju123@gmail.com> wrote:
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.

В списке pgsql-docs по дате отправления:

Предыдущее
От: Julien Rouhaud
Дата:
Сообщение: Re: More explicit documentation neede on "pgpass"
Следующее
От: Julien Rouhaud
Дата:
Сообщение: Re: More explicit documentation neede on "pgpass"