On Tue, Feb 24, 2026 at 1:48 AM Daniel Gustafsson <[email protected]> wrote:
>
> > On 17 Feb 2026, at 02:08, Peter Smith <[email protected]> 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.
>

You are correct. Thanks for pointing it out.

> > 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.
>

This patch/thread was primarily about #1, which turned out to be
mistaken. The #2 re-ordering part was just done at the same time, but
got it no support

So, I am withdrawing this patch.

======
Kind Regards,
Peter Smith.
Fujitsu Australia


Reply via email to