Re: [jamboost] --help-options / --help-usage

From: Andrey Melnikov (melnikov_at_[hidden])
Date: 2005-07-06 11:03:56

Vladimir Prus wrote:
> On Wednesday 06 July 2005 18:39, Rene Rivera wrote:
> 
>>Important Options:
>>
>>* --clean; Remove the named targets
>>* -a; Rebuild everything
>>* -n; Don't execute the command, only print them
>>* -d+2; Show all executed commands
>>* -q; Stop at first error

For me your variant looks like I should use both -n -d+2 to get more 
verbosity. I mean that I understood like with -n without -d+2 some 
commands will be won't be displayed.

I'd like to have -d0 command there too, as it suppresses those cryptic

...found 20 targets...
...updating 5 targets...

messages which nobody can use in his/her daily work.

>>
> Will it hurt much if we retain just the first 
> sentence?
> 
> 
>>* --help; This help message.
>>* --help-project; Information on building for this project.
>>* --help-command; Command line syntax and available options.
>>* --help-doc; How to control the output of this help text.
>>* --help-internal; Boost.Build implementation details.
> 
> 
> Ok, this looks fine.

Do we really need these "*" and ";" ? In all programs I've seen it would 
be just

--help This help message.
--help-project Information on building for this project.
--help-command Command line syntax and available options.
--help-doc How to control the output of this help text.
--help-internal Boost.Build implementation details.

Also despite "--help This help message." line is widely used, it doesn't 
serve any purpose and can be removed. It's just like distributing 
drivers for a CDROM drive on CDs :)

Andrey

Andrey