[RFC] Concise vs comprehensive help - do we need both?

Ben Finney bignose+hates-spam at benfinney.id.au
Sat Jan 31 08:04:51 GMT 2009


Ian Clatworthy <ian.clatworthy at internode.on.net> writes:

> I'd be just as happy not adding -? and making -h be concise help
> while "bzr help xxx" gave the full story. Would that be better?

I would expect ‘-h’ and ‘--help’ to be synonymous, and to default to
concise help.

Multi-page verbosity should not be something associated with a
commonly-used option like ‘--help’, but rather something that
indicates it's verbose, such as ‘--help --verbose’ or ‘--help --long’.

-- 
 \       “Truth is stranger than fiction, but it is because fiction is |
  `\     obliged to stick to possibilities, truth isn't.” —Mark Twain, |
_o__)                                          _Following the Equator_ |
Ben Finney




More information about the bazaar mailing list