Re: -V, --version -- deprecated? - Mailing list pgsql-hackers

From Peter Eisentraut
Subject Re: -V, --version -- deprecated?
Date
Msg-id 200411241129.47009.peter_e@gmx.net
Whole thread Raw
In response to -V, --version -- deprecated?  (Neil Conway <neilc@samurai.com>)
Responses Re: -V, --version -- deprecated?
List pgsql-hackers
Neil Conway wrote:
> The "--help" output for most of the binaries we install does not
> include the "-V" option (just its alias, --version). Is this
> intentional?
>
> (Note that we still document this option in the reference pages for
> some commands, and initdb's help output does include "-V".)

--help and --version are the standard options that are supported 
everywhere.  In the era before we had long options everywhere, we 
implemented -V as an alternative in some programs, in particular those 
in and around initdb, because of the version cross-checking it does 
using those options.

At one point, long options where broken on some BSD versions.  I don't 
know what became of that, but if we don't have new information it might 
be safest to leave things where they are.

Hence, the -V option is not the preferred public interface, so it's not 
prominently documented, which may or may not be reasonable in minds 
other than my own.

> Speaking of command-line options, "--version" and "--help" aren't
> documented in a lot of command reference pages. Is there a good
> reason why?

I am not aware of one.

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/


pgsql-hackers by date:

Previous
From: Neil Conway
Date:
Subject: Re: patch: plpgsql - access records with rec.(expr)
Next
From: Joachim Wieland
Date:
Subject: Re: patch: plpgsql - access records with rec.(expr)