From owner-freebsd-doc Tue Aug 27 10:51: 5 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F313437B400; Tue, 27 Aug 2002 10:51:01 -0700 (PDT) Received: from crf-consulting.co.uk (pc-80-194-99-103-hy.blueyonder.co.uk [80.194.99.103]) by mx1.FreeBSD.org (Postfix) with ESMTP id E567143E42; Tue, 27 Aug 2002 10:51:00 -0700 (PDT) (envelope-from nik@crf-consulting.co.uk) Received: from clan.crf-consulting.co.uk (clan.nothing-going-on.org [192.168.1.20]) by crf-consulting.co.uk (8.12.3/8.12.3) with ESMTP id g7RHp0Tk074420; Tue, 27 Aug 2002 18:51:00 +0100 (BST) (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) by clan.crf-consulting.co.uk (8.12.3/8.12.3) with ESMTP id g7RHoxhB069064; Tue, 27 Aug 2002 18:50:59 +0100 (BST) (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost) by clan.nothing-going-on.org (8.12.3/8.12.3/Submit) id g7RHox8t069063; Tue, 27 Aug 2002 18:50:59 +0100 (BST) Date: Tue, 27 Aug 2002 18:50:59 +0100 From: Nik Clayton To: Marc Fonvieille Cc: freebsd-doc@FreeBSD.org Subject: Re: [HEAD UP] Support for manpath in the links to manual pages Message-ID: <20020827175059.GB66096@clan.nothing-going-on.org> References: <20020827164338.B39381@abigail.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="1UWUbFP1cBYEclgG" Content-Disposition: inline In-Reply-To: <20020827164338.B39381@abigail.blackend.org> User-Agent: Mutt/1.4i 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 --1UWUbFP1cBYEclgG Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Aug 27, 2002 at 04:43:38PM +0200, Marc Fonvieille wrote: >=20 > >=20 > in man-refs.ent for a FreeBSD ports manual page. > I will change soon man-refs.ent to point on the correct manual pages. > Note that in the docs the entities remain similar to &man.xdm.1; I'm not sure they should. Apart from anything else, we'll probably get to a situation at some point where we have a binary in FreeBSD, and a binary that's installed from the ports tree that has the same name. Or binaries from different BSD's that we want to be able to distinguish between. [ Also, we might want to refer to different versions of the same FreeBSD man page -- for example, fsck(8) for 4.x vs fsck(8) for 5.x. . . . ] Without giving it a huge amount of thought, I suspect that something like &man.xfree86.xdm.1; &man.netbsd.ls.1; is going to make more sense in the long run. We might want to include version numbers in that as well. The entity might then expand to something like xdm 1 (XFree86) so that the generated HTML is going to look something like xdm(1) (XFree86) to make it clear to the reader that this is not in the base system. 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 --- .\._/= _) --1UWUbFP1cBYEclgG Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAj1rvAIACgkQk6gHZCw343UqYwCeI5kduovHf/qF+P8RbfV7tOVh iIcAniATR5gG02+sY6trV29cp479ELiz =Dq5B -----END PGP SIGNATURE----- --1UWUbFP1cBYEclgG-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message