From owner-cvs-all  Sat Aug  4 21:36:35 2001
Delivered-To: cvs-all@freebsd.org
Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80])
	by hub.freebsd.org (Postfix) with ESMTP
	id A130A37B403; Sat,  4 Aug 2001 21:36:24 -0700 (PDT)
	(envelope-from grog@lemis.com)
Received: by wantadilla.lemis.com (Postfix, from userid 1004)
	id E7D556AD02; Sun,  5 Aug 2001 14:06:16 +0930 (CST)
Date: Sun, 5 Aug 2001 14:06:16 +0930
From: Greg Lehey <grog@FreeBSD.org>
To: John Baldwin <jhb@FreeBSD.org>
Cc: Sheldon Hearn <sheldonh@starjuice.net>, doc@FreeBSD.ORG,
	cvs-all@FreeBSD.ORG, cvs-committers@FreeBSD.ORG,
	Mike Pritchard <mpp@mppsystems.com>, Ruslan Ermilov <ru@FreeBSD.ORG>
Subject: Re: Which OS does a man page come from? (was: cvs commit: src/bi
Message-ID: <20010805140616.F63519@wantadilla.lemis.com>
References: <5612.996105803@axl.seasidesoftware.co.za> <XFMail.010725172637.jhb@FreeBSD.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <XFMail.010725172637.jhb@FreeBSD.org>; from jhb@FreeBSD.org on Wed, Jul 25, 2001 at 05:26:37PM -0700
Organization: The FreeBSD Project
Phone: +61-8-8388-8286
Fax: +61-8-8388-8725
Mobile: +61-418-838-708
WWW-Home-Page: http://www.FreeBSD.org/
X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF  13 24 52 F8 6D A4 95 EF
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk
List-ID: <cvs-all.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20cvs-all>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20cvs-all>
X-Loop: FreeBSD.ORG

On Wednesday, 25 July 2001 at 17:26:37 -0700, John Baldwin wrote:
>
> On 26-Jul-01 Sheldon Hearn wrote:
>>
>>
>> On Thu, 26 Jul 2001 09:23:29 +0930, Greg Lehey wrote:
>>
>>>> Name, no.  Version, yes.
>>>
>>> And it would be?
>>
>> Sorry, I thought that was obvious.
>>
>> Providing operating system version as an argument to .Os means a full
>> commit-sweep of the manual page domain for every release.  No way.

Not that way.

> Not if you use ranges:
>
> .Os FreeBSD 5.0+
> .Os FreeBSD 2.2-3.x
>
> etc. 

That requires you to guess.  When you install the man pages, they
can't know in which release they stop being valid.

It's really pretty simple, though: set the version number in the
install process.  In that case, we really could leave out the .Os
macro in the repo, and just insert in when installing.  The same
should go for the .Dd macro, which I really think should indicate the
last time the man page was modified.

Greg
--
See complete headers for address and phone numbers

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