From owner-freebsd-doc Thu May 30 11:12:57 2002 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id 0868A37B409; Thu, 30 May 2002 11:12:52 -0700 (PDT) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id g4U7C2i22936; Thu, 30 May 2002 08:12:02 +0100 (BST) (envelope-from nik) Date: Thu, 30 May 2002 08:12:02 +0100 From: Nik Clayton To: Tom Rhodes Cc: Chris Pepper , keramida@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: (man page || manpage) => manual page Message-ID: <20020530081201.M64264@canyon.nothing-going-on.org> References: <20020529214746.GA67346@hades.hell.gr> <20020529183350.314b0f2a.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="UUMz/kfoogzZ9WLZ" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20020529183350.314b0f2a.trhodes@FreeBSD.org>; from trhodes@FreeBSD.org on Wed, May 29, 2002 at 06:33:50PM -0400 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --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: © ™ 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