From owner-cvs-doc@FreeBSD.ORG  Tue Dec 30 12:29:04 2003
Return-Path: <owner-cvs-doc@FreeBSD.ORG>
Delivered-To: cvs-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id D7A6916A4CE; Tue, 30 Dec 2003 12:29:04 -0800 (PST)
Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk
	[212.242.113.79])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id E12DA43D3F; Tue, 30 Dec 2003 12:29:00 -0800 (PST)
	(envelope-from simon@arthur.nitro.dk)
Received: by arthur.nitro.dk (Postfix, from userid 3000)
	id 07D4011858; Tue, 30 Dec 2003 21:28:58 +0100 (CET)
Date: Tue, 30 Dec 2003 21:28:58 +0100
From: "Simon L. Nielsen" <simon@FreeBSD.org>
To: Marc Fonvieille <blackend@FreeBSD.org>
Message-ID: <20031230202857.GA671@arthur.nitro.dk>
References: <200312301749.hBUHnJjx004040@repoman.freebsd.org>
	<20031230132034.36281ba6.trhodes@FreeBSD.org>
	<20031230193540.F90071@abigail.blackend.org>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="9jxsPFA5p3P2qPhR"
Content-Disposition: inline
In-Reply-To: <20031230193540.F90071@abigail.blackend.org>
User-Agent: Mutt/1.5.5.1i
cc: Tom Rhodes <trhodes@FreeBSD.org>
cc: doc-committers@FreeBSD.org
cc: cvs-doc@FreeBSD.org
Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/security
	chapter.sgml
X-BeenThere: cvs-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the doc and www trees <cvs-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-doc>,
	<mailto:cvs-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-doc>
List-Post: <mailto:cvs-doc@freebsd.org>
List-Help: <mailto:cvs-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-doc>,
	<mailto:cvs-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 30 Dec 2003 20:29:05 -0000


--9jxsPFA5p3P2qPhR
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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:
>=20
> "Use <option> to mark up a command's options."
>=20
> and the TDG tells us:
>=20
> "option identifies an optional argument to a software command."
>=20
> but I think our stylesheet renders option and literal in the same way.
>=20
> 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.

--=20
Simon L. Nielsen
FreeBSD Documentation Team

--9jxsPFA5p3P2qPhR
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.3 (FreeBSD)

iD8DBQE/8eAJh9pcDSc1mlERAsxHAJ9zIleBRZGFrC8MUn4zGf1lh5oa+gCfZRpf
n1vVx3ZJz2LpbmDS+4Vh/rc=
=msiD
-----END PGP SIGNATURE-----

--9jxsPFA5p3P2qPhR--