Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 30 May 2002 08:12:02 +0100
From:      Nik Clayton <nik@freebsd.org>
To:        Tom Rhodes <trhodes@FreeBSD.org>
Cc:        Chris Pepper <pepper@reppep.com>, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org
Subject:   Re: (man page || manpage) => manual page
Message-ID:  <20020530081201.M64264@canyon.nothing-going-on.org>
In-Reply-To: <20020529183350.314b0f2a.trhodes@FreeBSD.org>; from trhodes@FreeBSD.org on Wed, May 29, 2002 at 06:33:50PM -0400
References:  <20020529214746.GA67346@hades.hell.gr> <p05111a1bb91affba8a28@[129.85.219.160]> <20020529183350.314b0f2a.trhodes@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help

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

On Wed, May 29, 2002 at 06:33:50PM -0400, Tom Rhodes wrote:
> Entities allow you to assign a name to some chunk of data, and
[...]
> file.

This bit's correct.

> Our man tags are custom to the FreeBSD project, taking the user/reader
> to our version of the specified manual page.  Many manual pages differ fr=
om
> operating system to operating system (for instance, drivers) and this
> lets us define a link to a man page search engine...
>=20
> This also differs in fact that, the man entity is not standard in
> html or DocBook for that matter (unless you define it), unlike the
> usual: &copy; &trade; that works in HTML and DocBook (others?)

This bit isn't.

The various entities that we use (&man., &a., &os., &rel., &gui., ...)
are purely to cut down the amount of typing the document author has to
do, and to try and ensure consistency between different documents.  It's
got nothing to do with any links that might be automatically generated
in the documentation.

N
--=20
FreeBSD: The Power to Serve      http://www.freebsd.org/               (__)
FreeBSD Documentation Project    http://www.freebsd.org/docproj/    \\\'',)
                                                                      \/  \=
 ^
   --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---         .\._/=
_)

--UUMz/kfoogzZ9WLZ
Content-Type: application/pgp-signature
Content-Disposition: inline

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

iD8DBQE89dDBk6gHZCw343URAlLLAJsG4cw5rz5wZrWrw2UN1IPLeJnrjACglpj0
GVN1odFtlkYjh+0G/R9p8Dw=
=qn3/
-----END PGP SIGNATURE-----

--UUMz/kfoogzZ9WLZ--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020530081201.M64264>