On Sat, Jan 13, 2024 at 01:39:50PM +0300, Aleksander Alekseev wrote:
> OK, let's check section "20.1.4. Parameter Interaction via the Shell"
> [1] of the documentation. Currently it doesn't tell anything about the
> ability to specify GUCs --like-this, unless I missed something.
It appears to be documented for 'postgres' as follows [0]:
--name=value
Sets a named run-time parameter; a shorter form of -c.
and similarly within the --help output:
--NAME=VALUE set run-time parameter
Its documentation also describes this method of specifying parameters in
the 'Examples' section. The section you refer to calls out "-c", so it is
sort-of indirectly mentioned, but that might be a bit of a generous
assessment.
> 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.
Separately, I noticed that this is implemented in postmaster.c by looking
for the '-' option character returned by getopt(), and I'm wondering why
this doesn't use getopt_long() instead. AFAICT this dates back to the
introduction of GUCs in 6a68f426 (May 2000).
[0] https://www.postgresql.org/docs/devel/app-postgres.html
--
Nathan Bossart
Amazon Web Services: https://aws.amazon.com
