From owner-freebsd-doc Fri Oct 18 14:17:25 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 BDCD037B401 for ; Fri, 18 Oct 2002 14:17:24 -0700 (PDT) Received: from nic.upatras.gr (nic.upatras.gr [150.140.129.30]) by mx1.FreeBSD.org (Postfix) with SMTP id BF2D443EB7 for ; Fri, 18 Oct 2002 14:17:22 -0700 (PDT) (envelope-from keramida@freebsd.org) Received: (qmail 23560 invoked from network); 18 Oct 2002 21:10:18 -0000 Received: from upnet-dialinpool-104.upnet.gr (HELO hades.hell.gr) (150.140.128.150) by nic.upatras.gr with SMTP; 18 Oct 2002 21:10:18 -0000 Received: from hades.hell.gr (hades [127.0.0.1]) by hades.hell.gr (8.12.6/8.12.6) with ESMTP id g9ILHQru003199; Sat, 19 Oct 2002 00:17:26 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by hades.hell.gr (8.12.6/8.12.6/Submit) id g9ILHQJt003198; Sat, 19 Oct 2002 00:17:26 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Sat, 19 Oct 2002 00:17:26 +0300 From: Giorgos Keramidas To: Marc Fonvieille Cc: freebsd-doc@freebsd.org Subject: Re: HEADS UP: Use of -CURRENT manual pages in our docs Message-ID: <20021018211726.GA2822@hades.hell.gr> References: <20021018212220.B50649@abigail.blackend.org> <20021018194751.GG16196@hades.hell.gr> <20021018223014.E50649@abigail.blackend.org> <20021018224804.F50649@abigail.blackend.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20021018224804.F50649@abigail.blackend.org> 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 On 2002-10-18 22:48, Marc Fonvieille wrote: > On Fri, Oct 18, 2002 at 10:47:51PM +0300, Giorgos Keramidas wrote: > > So what happens when today's current becomes tomorrow's stable? > > I hope we won't have to rename all the &man.current.foo.X; entities to > > &man.stable.foo.X; :-( > > However, indeed, we should avoid &man.current etc. for base system > manpages. Tell me what you think about it, since it's easy to fix > man-refs in that way... That's what I originally meant. We shouldn't overuse &man.current.*; entities. I'm ok with that, if it's also added explicitly as a comment to the file. Something similar to the following should be more than enough: Whenever the need arises for a manpage reference that is only meaningful for FreeBSD-current, the convention is to add an entity to this file of the form &man.current.foo.1;. After a while, when all required parts have been MFCed, you are expected to change the documents to use &man.foo.1; and update this file removing &man.current.foo.1;. I would even go as far as making the &man.current.*; entities a separate file, at this point. But this is your call, and still just an opinion. Giorgos. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message