cvs commit: doc/en_US.ISO8859-1/books/handbook/security chapter.sgml

[Simon L. Nielsen]

On 2003.12.30 19:35:40 +0100, Marc Fonvieille wrote:

> I see your point.  Most of time I use literal tags but according to the
> FDP:
> 
> "Use <option> to mark up a command's options."
> 
> and the TDG tells us:
> 
> "option identifies an optional argument to a software command."
> 
> but I think our stylesheet renders option and literal in the same way.
> 
> I'd use literal when I don't find a specific tag.

I also understand <literal> as a kind of fall-back if there isn't a more
specific tag, so I think <option> should be used when it's there (and
the FDP even recomends it).  The same way that one could mark-up a
filename in <literal> tags if there was no <filename> tag.

With regards to flags tag, I rememeber seeing some other tag that could
also be used for command line arguments, but I can't remember what one
it was right now.

-- 
Simon L. Nielsen
FreeBSD Documentation Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-doc/attachments/20031230/17a8838a/attachment.bin