On Saturday, January 13, 2024, Nathan Bossart <nathandboss...@gmail.com>
wrote:

> On Sat, Jan 13, 2024 at 01:39:50PM +0300, Aleksander Alekseev wrote:
>
> > Should we remove --config-file from the error message to avoid any
> > confusion? Should we correct --help output? Should we update the
> > documentation?
>
> It might be worthwhile to update the documentation if it would've helped
> prevent confusion here.
>

Pointing out the long form in the -c definition makes sense.

As for the help message, I’d minimally add:

“You must specify the --config-file (or equivalent -c) or -D invocation …”

I’m fine with the status quo regarding the overview documentation
mentioning both forms.  I also haven’t tested whether PGOPTIONS accepts
both forms or only the -c form as presently documented.  Presently the
—name=value form seems discouraged in favor of -c which I’m ok with and
trying to mention both everywhere seems needlessly verbose.   But I’d be
interested in reviewing against an informed patch improving this area more
broadly than dealing with this single deviant usage.  I do like this
specific usage of the long-form option.

David J.

Reply via email to