DOCBOOK: cmdsynopsis + arg Vs command, option

[davidw@dedasys.com (David N. Welton)]

I wanted to ask after something that's been bugging me for a while.

To wit, that in most places, one needs to use

<option><optional>foo<optional><option>

whereas in cmdsynopsis, one uses

<arg choice="opt">...</arg>

It would be nice to have one, consistent way of describing
options/arguments to a command, both inside and outside of
cmdsynopsis.  This has been confusing for some of the people I'm
working with on a documentation project.

Or am I just not understanding some aspect of the current design?

Thankyou,
-- 
David N. Welton
   Consulting: http://www.dedasys.com/
     Personal: http://www.dedasys.com/davidw/
Free Software: http://www.dedasys.com/freesoftware/
   Apache Tcl: http://tcl.apache.org/