Skip site navigation (1)Skip section navigation (2)
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>
In-Reply-To: <XFMail.010725172637.jhb@FreeBSD.org>; from jhb@FreeBSD.org on Wed, Jul 25, 2001 at 05:26:37PM -0700
References:  <5612.996105803@axl.seasidesoftware.co.za> <XFMail.010725172637.jhb@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010805140616.F63519>