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

From Daniel Gustafsson
Subject Re: DOCS - Server Applications [option] should be [option...]
Date
Msg-id 18D6F77A-A3FD-4DEE-8C79-D719F56D262F@yesql.se
Whole thread Raw
In response to DOCS - Server Applications [option] should be [option...]  (Peter Smith <smithpb2250@gmail.com>)
Responses Re: DOCS - Server Applications [option] should be [option...]
List pgsql-hackers
> On 17 Feb 2026, at 02:08, Peter Smith <smithpb2250@gmail.com> wrote:

> Make the "option" part consistent in the synopses of all Server Applications:
>
> 1. "[option]" should be "[option...]"

Only if the application can take multiple options.  pg_controldata can for
example only take a single parameter so [option] is correct there.

> 2. It should be first

Why?  I think it makes more sense to list [option...] after required parameters
just like how pg_upgrade does it.  We might not be consistent as is, but I'm
not sure it's a net improvement to always list it first as opposed to what we
have.

--
Daniel Gustafsson




pgsql-hackers by date:

Previous
From: Daniel Gustafsson
Date:
Subject: Re: Add ssl_(supported|shared)_groups to sslinfo
Next
From: Tom Lane
Date:
Subject: Re: Wrong results with grouping sets