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

[Ben Finney]

Jari Aalto <jari.aalto at cante.net> writes:

>     $ bzr help checkout
>     usage: bzr checkout [BRANCH_LOCATION] [TO_LOCATION]

This tells you (syntactically) that BRANCH_LOCATION is optional,
i.e. can be omitted.

>     If BRANCH_LOCATION is omitted,

This tells you (descriptively) that BRANCH_LOCATION is optional,
i.e. can be omitted.

There's no inconsistency in what you presented that I can see.

-- 
 \          "Writing a book is like washing an elephant: there no good |
  `\        place to begin or end, and it's hard to keep track of what |
_o__)                           you've already covered."  -- Anonymous |
Ben Finney