This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
cmdsynopsis + arg Vs command, option
- From: davidw at dedasys dot com (David N. Welton)
- To: docbook at lists dot oasis-open dot org
- Date: Sat, 03 Aug 2002 12:13:50 -0700
- Subject: DOCBOOK: cmdsynopsis + arg Vs command, option
- References: <877kjwvcxk.fsf@dedasys.com> <8765zg6mnm.fsf@nwalsh.com>
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/