Re: Postgres and --config-file option

On 02.02.24 22:27, David G. Johnston wrote:
> On Fri, Feb 2, 2024 at 2:23 PM David G. Johnston 
> <david.g.johnston@gmail.com <mailto:david.g.johnston@gmail.com>> wrote:
> 
>     On Mon, Jan 15, 2024 at 4:35 AM Aleksander Alekseev
>     <aleksander@timescale.com <mailto:aleksander@timescale.com>> wrote:
> 
>         PFA the patch. It's short but I think it mitigates the problem.
> 
> 
>     I took a look at where these options are discussed in the
>     documentation and now feel that we should make these options clear
>     more broadly (config and libpq, plus pointing to --name from -c in a
>     couple of places).  It doesn't add much verbosity and, frankly, if I
>     was to pick one "--name=value" would win and so I'd rather document
>     it, leaving -c alone for historical reasons.
> 
>     I've attached a replacement patch with the additional changes.
> 
> 
> And I just saw one more apparently undocumented requirement (or a typo)
> 
> You must specify the --config-file
> 
> The actual parameter is "config_file", so apparently we are supposed to 
> either convert underscores to hyphens or we have a typo.

We convert '-' to '_' when parsing long options (see ParseLongOption() 
in guc.c).  So writing the long options with hyphens should generally be 
preferred in documentation.