X-Authentication-Warning: kendall.sfbr.org: jeffw set sender to jeffw AT darwin DOT sfbr DOT org using -f
Date: Thu, 6 Feb 2003 11:21:50 -0600
From: JT Williams <jeffw AT darwin DOT sfbr DOT org>
To: djgpp-workers AT delorie DOT com
Subject: Texinfo markup recommendations in KB/develop.txi
Message-ID: <20030206172150.GA25984@kendall.sfbr.org>
Mail-Followup-To: djgpp-workers AT delorie DOT com
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.4i
Reply-To: djgpp-workers AT delorie DOT com

I was looking through develop.txi in the KB for some guidance on the
markup for writing command syntax.  I'm still not sure about the markup
for grouped options and accumulating options (e.g., verbosity).

Something like this?

@command{foo} [@kbd{-?hV}]
@command{foo} [@kbd{-v}@dots{}] @kbd{-f} @var{input-file}


PS: This patch might be in order.

--- develop.old 2003-01-28 03:15:11.000000000 -0600
+++ develop.txi 2003-02-06 11:10:19.535463000 -0600
@@ -256,7 +256,7 @@
 @samp{@@option@{@}} mark-up.  @samp{@@option@{@}} is new in Texinfo 4.0.
 
 @item
-Names of programs should use @samp{@@code@{@}} (unless program's name
+Names of programs should use @samp{@@command@{@}} (unless program's name
 has become a proper name, like GCC or GDB).
 
 @item