OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Subject: DOCBOOK: cmdsynopsis + arg Vs command, option

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

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


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?

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/

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Powered by eList eXpress LLC