Re: Improve initdb and pg_controldata manual pages

Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > I have applied the attached patch to improve the initdb and
> > pg_controldata manual pages. Patch from gabrielle <gorthx(at)gmail(dot)com>.
>
> This seems like the most bizarre choice you could have made.
> It now looks like the preferred spelling of initdb's switch,
> for instance, is
>
> initdb --pgdata= /path/name
>
> ie, *both* an equal sign and a space. Please rethink this.

Well, it actually looks like this:

initdb [option...] --pgdata= | -D directory

and this gets back to whether we are going to show '=' for long
switches, which I am waiting on a reply about. If we are, we probably
have to accept the above output --- if not, it will be removed along
with other cases. I have now removed the '=' from initdb, but it is an
open issue.

Also, keep in mind that the --help output often shows '=', e.g. from
pg_dump:

-E, --encoding=ENCODING dump the data in encoding ENCODING
-n, --schema=SCHEMA dump the named schema(s) only
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +