On Wed, 2004-10-27 at 08:29, James K. Lowden wrote:
> On Tue, 26 Oct 2004 01:12:22 -0400, "Brian A. Seklecki"
> <lavalamp@spiritual-machines.org> wrote:
> > Yet another draft copy:

[..snip..]

> 3. As a general comment, I wish the commands, filenames, and environment
> variables were consistently tagged such that they were typographically
> distinct in a typical HTML browser.  For example, "ntpdate" and
> "mksunbootcd" sometimes appear as ordinary text, and other times as
> filenames ("<tt class="filename">mksunbootcd</tt>").  Similarly, in this
> bit:
> 
> 	${TOOLDIR} should be evaluated to the value of the "-T" flag to build.sh,
> and ${ARCH} should be evaluated to the output of when passed the "-m"
> flag.
> 
> The options "-T" and  "-m" shouldn't appear in quotes, but rather should
> be visually distinct by virtue of being tagged as command line options. 
> (And they should be called "options", not "flags", no?  After all, it's
> getopt(1), not getflg(1).)  ;-)
> 
>         ${TOOLDIR} should be evaluated to the value of the "-T" flag to build.sh,
> and ${ARCH} should be evaluated to the output of when passed the "-m"
> flag.
> 
> The options "-T" and  "-m" shouldn't appear in quotes, but rather should
> be visually distinct by virtue of being tagged as command line options. 
> (And they should be called "options", not "flags", no?  After all, it's
> getopt(1), not getflg(1).)  ;-)


James:

	There are mechanisms already in Docbook for this.  Unfortunately, I'm
less inclined to strictly abide by them as our XSL/CSS stylesheet
(NetBSD.css) doesn't apply unique formatting attributes to each element.

Per my original message on the subject last month:

http://mail-index.netbsd.org/netbsd-docs/2004/09/27/0002.html

Let's review what we have:

<filename>
<varname> 
<application>
<emphasis>
<quote>
<envar>
<acronym>
<userinput><command> (only apply to <screen> and <programlisting>)

...and now I see that :

<arg>
<option>
...exist.  I will make changes, even if they don't directly apply
formatting changes to the output HTML document.

~lava