"bzr help checkout" should make dependence of TO_LOCATION on BRANCH_LOCATION more explicit

[Wouter van Heyst]

"Usage: bzr checkout [BRANCH_LOCATION] [TO_LOCATION]"

suggests one might be able to supply TO_LOCATION without BRANCH_LOCATION (if bzr could detect which one you meant without relying on position).
In the help description first the omittance of BRANCH_LOCATION is explained, but could be read as providing a checkout of . in TO_LOCATION.

The code is clear:

   if branch_location is None:
      branch_lcation = osutils.getcwd()
      to_location = branch_location

Partly it might be good to tweak the description a bit, but better than my attempt:

  If BRANCH_LOCATION is omitted, checkout will reconstruct the working tree for the branch found in '.', TO_LOCATION will thus be ignored.

But I guess what I'm really after is:

   Usage: bzr checkout [BRANCH_LOCATION [TO_LOCATION]]

But I don't see how to do that with the current command help machinery.

My apologies for the rambly 2-in-1 bugreport.