"--version" flag missing from man pages

Started by Josh Kupershmidtover 16 years ago2 messagesdocs
Jump to latest
#1Josh Kupershmidt
schmiddy@gmail.com

I noticed that the "--version" flag is not in the man pages for pg_dump,
pg_dumpall, initdb, and various other commands. Out of all the files in
./doc/src/sgml/ref/ , I can see only these three which have "--version"
listed:

josh@hades:~/src/postgresql/doc/src/sgml/ref$ grep "\-\-version" *.sgml
ecpg-ref.sgml: <term><option>--version</option></term>
pg_config-ref.sgml: <term><option>--version</option></>
psql-ref.sgml: <term><option>--version</></term>

Yet many other commands support a -V or --version flag which isn't in their
man pages.

$ initdb --version
initdb (PostgreSQL) 8.5devel

Josh

#2Bruce Momjian
bruce@momjian.us
In reply to: Josh Kupershmidt (#1)
Re: "--version" flag missing from man pages

Josh Kupershmidt wrote:

I noticed that the "--version" flag is not in the man pages for pg_dump,
pg_dumpall, initdb, and various other commands. Out of all the files in
./doc/src/sgml/ref/ , I can see only these three which have "--version"
listed:

josh@hades:~/src/postgresql/doc/src/sgml/ref$ grep "\-\-version" *.sgml
ecpg-ref.sgml: <term><option>--version</option></term>
pg_config-ref.sgml: <term><option>--version</option></>
psql-ref.sgml: <term><option>--version</></term>

Yet many other commands support a -V or --version flag which isn't in their
man pages.

$ initdb --version
initdb (PostgreSQL) 8.5devel

Interesting, I never noticed they were not documented. I have applied
the attached patch which adds documentation for those options. These
new documentation changes will appear in Postgres 9.0

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

Attachments:

/rtmp/difftext/x-diffDownload+311-42