cvs commit: doc/en_US.ISO8859-1/books/handbook/security
chapter.sgml
Marc Fonvieille
blackend at FreeBSD.org
Tue Dec 30 10:35:44 PST 2003
On Tue, Dec 30, 2003 at 01:20:34PM -0500, Tom Rhodes wrote:
> >
> > - Use of &prompt.user; for %
> > - Add a whitespace between prompt and command for consistency (this
> > change could be done in a separate commit, but there the whitespace
> > can be seen as content)
> > - Use option tags for command line options instead of literal ones.
>
> Using option tags? I've been using literal for awhile since another
> committer told me that they always use literal over option for
> flags. Which one is preferred?
>
> FWIW, I think it was bmah who said that to me during my working
> of the cron(8) section, but please don't quote me on that. :)
>
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.
Marc
More information about the cvs-doc
mailing list