Our optional arguments are always required in order. It is probably standard practice to nest as mentioned. I'm concerned about entries which take lots of optional arguments, as it starts to get unclear at about 3:
bzr foo [ONE [TWO [THREE]]]
versus
bzr foo [ONE] [TWO] [THREE]
*however*, core probably doesn't have any commands that take more than 2 optional positional arguments, so we should be able to use standard notation.
Our optional arguments are always required in order. It is probably standard practice to nest as mentioned. I'm concerned about entries which take lots of optional arguments, as it starts to get unclear at about 3:
bzr foo [ONE [TWO [THREE]]]
versus
bzr foo [ONE] [TWO] [THREE]
*however*, core probably doesn't have any commands that take more than 2 optional positional arguments, so we should be able to use standard notation.