bzr <cmd> help -- Synopsis syntax should follow de facto conventions

[John Arbash Meinel]

Daniel Silverstone wrote:

...

> In normal manpage parlance:
> 
> usage: bzr checkout [BRANCH_LOCATION [TO_LOCATION]]
> 
> D.
> 

Well, all of our optional parameters are this way. As in they are still
100% positional, and I don't know of any core commands that change
position meaning. (I believe at one time I wrote a plugin that did, but
I didn't really like it).

So we could rewrite the help generator to always use nested braces. I'm
not sure if that helps a lot, but we can discuss it a bit.

John
=:->

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 254 bytes
Desc: OpenPGP digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060921/7a6b7ebf/attachment.pgp