Re: DOCS - Server Applications [option] should be [option...] - Mailing list pgsql-hackers

On Wed, Feb 18, 2026 at 7:32 PM Andreas Karlsson <andreas@proxel.se> wrote:
>
> On 2/17/26 2:08 AM, Peter Smith wrote:
> > Hi.
> >
> > Make the "option" part consistent in the synopses of all Server Applications:
> >
> > 1. "[option]" should be "[option...]"
>
> Agreed.
>
> > 2. It should be first
> I am not sure that is an improvement. I would rather move things with
> less signal towards the end. Also how many examples have we of each?
> Most seem to be on the format below which I feel indicates [option...]
> is last (but before order dependent arguments like dbname.)
>
>    pg_dump [connection-option...] [option...] [dbname]
>

Thanks for the feedback

The scope of my patch is only the Server Applications [1]. Maybe it is
still correct that it is not much of an improvement, but you are
citing examples from Client Applications.

======
[1]  https://www.postgresql.org/docs/devel/reference-server.html

Kind Regards,
Peter Smith.
Fujitsu Australia