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

From Andreas Karlsson
Subject Re: DOCS - Server Applications [option] should be [option...]
Date
Msg-id 5678434a-568e-4c79-afc7-2a924c0235c4@proxel.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 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]

Andreas




pgsql-hackers by date:

Previous
From: Nazir Bilal Yavuz
Date:
Subject: Re: Improve docs syntax checking and enable it in the meson build
Next
From: Ajit Awekar
Date:
Subject: Re: [OAuth2] Infrastructure for tracking token expiry time