Re: confusing positioning of notes in connection settings

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>
Cc: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: confusing positioning of notes in connection settings
Date: 2023-05-31 11:53:53
Message-ID: A21C7848-0B4A-4216-A528-92B41F220A76@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 31 May 2023, at 13:16, Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com> wrote:

> The first two hunks are pretty straightforward, they just move the existing text around.
>
> For the other two, which are not supported on Windows, I added an explicit parenthetical note. We don't list which of the Unix-like platforms support the respective options, but I suspect that it's all of them in practice? (Otherwise we should be more explicit.) So I think calling out Windows explicitly is sensible, also considering that the first two settings are supported on Windows but the latter two are not.

I think this is a clear improvement over the current docs.

Should we call out Windows explicitly in the same way in the corresponding
options in the libpq connection string param docs as well?

--
Daniel Gustafsson

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2023-05-31 22:57:52 pass open cursor via USING in execute staement
Previous Message Peter Eisentraut 2023-05-31 11:16:56 Re: confusing positioning of notes in connection settings