From owner-cvs-all  Wed Jul 25 17:27: 3 2001
Delivered-To: cvs-all@freebsd.org
Received: from mail5.speakeasy.net (mail5.speakeasy.net [216.254.0.205])
	by hub.freebsd.org (Postfix) with SMTP id 40F7B37B405
	for <cvs-all@FreeBSD.ORG>; Wed, 25 Jul 2001 17:26:53 -0700 (PDT)
	(envelope-from jhb@FreeBSD.org)
Received: (qmail 80582 invoked from network); 26 Jul 2001 00:26:52 -0000
Received: from unknown (HELO laptop.baldwin.cx) ([64.81.54.73]) (envelope-sender <jhb@FreeBSD.org>)
          by mail5.speakeasy.net (qmail-ldap-1.03) with SMTP
          for <sheldonh@starjuice.net>; 26 Jul 2001 00:26:52 -0000
Message-ID: <XFMail.010725172637.jhb@FreeBSD.org>
X-Mailer: XFMail 1.4.0 on FreeBSD
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <5612.996105803@axl.seasidesoftware.co.za>
Date: Wed, 25 Jul 2001 17:26:37 -0700 (PDT)
From: John Baldwin <jhb@FreeBSD.org>
To: Sheldon Hearn <sheldonh@starjuice.net>
Subject: Re: Which OS does a man page come from? (was: cvs commit: src/bi
Cc: doc@FreeBSD.ORG, cvs-all@FreeBSD.ORG, cvs-committers@FreeBSD.ORG,
	Mike Pritchard <mpp@mppsystems.com>, Ruslan Ermilov <ru@FreeBSD.ORG>,
	Greg Lehey <grog@FreeBSD.org>
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 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 if you use ranges:

.Os FreeBSD 5.0+
.Os FreeBSD 2.2-3.x

etc.  You only set the version when you first add a new API or whatever (using
+) and update it when you deprecate teh API or driver or whatever.
However, this does have a large initial overhead in the form of one massive
tree sweep.  I would like for just the name to be present, however.

> Ciao,
> Sheldon.

-- 

John Baldwin <jhb@FreeBSD.org> -- http://www.FreeBSD.org/~jhb/
PGP Key: http://www.baldwin.cx/~john/pgpkey.asc
"Power Users Use the Power to Serve!"  -  http://www.FreeBSD.org/

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