From owner-freebsd-doc Fri Oct 18 13: 4:29 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 36CEE37B401; Fri, 18 Oct 2002 13:04:27 -0700 (PDT) Received: from sccrmhc02.attbi.com (sccrmhc02.attbi.com [204.127.202.62]) by mx1.FreeBSD.org (Postfix) with ESMTP id 506EA43E88; Fri, 18 Oct 2002 13:04:26 -0700 (PDT) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org ([12.233.149.189]) by sccrmhc02.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20021018200425.MLQI26432.sccrmhc02.attbi.com@bmah.dyndns.org>; Fri, 18 Oct 2002 20:04:25 +0000 Received: from intruder.bmah.org (localhost [IPv6:::1]) by bmah.dyndns.org (8.12.6/8.12.6) with ESMTP id g9IK4Pva076733; Fri, 18 Oct 2002 13:04:25 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.6/8.12.6/Submit) id g9IK4PDE076732; Fri, 18 Oct 2002 13:04:25 -0700 (PDT) Message-Id: <200210182004.g9IK4PDE076732@intruder.bmah.org> X-Mailer: exmh version 2.5 07/13/2001 with nmh-1.0.4 To: Marc Fonvieille Cc: freebsd-doc@FreeBSD.ORG Subject: Re: HEADS UP: Use of -CURRENT manual pages in our docs In-Reply-To: <20021018212220.B50649@abigail.blackend.org> References: <20021018212220.B50649@abigail.blackend.org> Comments: In-reply-to Marc Fonvieille message dated "Fri, 18 Oct 2002 21:22:21 +0200." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.ORG X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_-2084157920P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Fri, 18 Oct 2002 13:04:25 -0700 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 --==_Exmh_-2084157920P Content-Type: text/plain; charset=us-ascii If memory serves me right, Marc Fonvieille wrote: > It is now possible to make the difference between -STABLE and > -CURRENT manual pages. > > We need this for devfs, device.hints etc. manual pages in our Handbook. > Manual pages entities for -CURRENT should have the form: > > &man.current.foo.1; > > Have a look to man-refs.ent and devfs(5) entity for more details. > > An "old" man.devfs.5 entity is kept to allow the build of localized > docs till their upgrade. Translation teams should upgrade their > freebsd.dsl file and then basics and boot chapters. > > Note, this does not concern release notes but only documentation. For the curious, the reason this doesn't (or shouldn't) affect RELNOTESng is that src/release/doc uses its own stylesheet that explicitly sets what manpage set to use for hyperlink cross-references. This lets the release documentation use a set of manpages appropriate to each release. The doc/ tree uses whatever default is defined by man.cgi. Waitasec. You're not going to *get rid* of the &man.devfs.5; entity are you? Remember that -STABLE isn't always going to be 4-STABLE. When 5-STABLE happens, it's going to be pretty weird to force authors to use &man.current.devfs.5;. Bruce. --==_Exmh_-2084157920P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) Comment: Exmh version 2.5+ 20020506 iD8DBQE9sGlI2MoxcVugUsMRAqh8AKCs5hquthYLd0GX09SluHSmS4NjbACdHK6e mLjm9MbdzRNM5kvOnOm+bgA= =5fxG -----END PGP SIGNATURE----- --==_Exmh_-2084157920P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message