Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 25 Jul 2001 08:58:32 +0930
From:      Greg Lehey <grog@FreeBSD.org>
To:        Sheldon Hearn <sheldonh@starjuice.net>
Cc:        Ruslan Ermilov <ru@FreeBSD.ORG>, Mike Pritchard <mpp@mppsystems.com>, cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG, doc@FreeBSD.ORG
Subject:   Re: Which OS does a man page come from? (was: cvs commit: src/bin/cp cp.1 src/bin/df df.1 src/bin/domainname domainname.1 src/bin/hostname hostname.1 src/bin/ln ln.1 symlink.7 src/bin/pax pax.1 src/bin/ps ps.1 src/bin/pwd pwd.1 realpath.1 src/bin/rcp rcp.1 src/bin/sh sh.1 src/bin/sh/bltin echo.1 ...)
Message-ID:  <20010725085832.P75783@wantadilla.lemis.com>
In-Reply-To: <7435.995964522@axl.seasidesoftware.co.za>; from sheldonh@starjuice.net on Tue, Jul 24, 2001 at 10:48:42AM %2B0200
References:  <20010724090443.L55779@wantadilla.lemis.com> <7435.995964522@axl.seasidesoftware.co.za>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tuesday, 24 July 2001 at 10:48:42 +0200, Sheldon Hearn wrote:
>
>
> On Tue, 24 Jul 2001 09:04:43 +0930, Greg Lehey wrote:
>
>>> the .Os call is not (strictly speaking) required at all, so we may
>>> eventually remove it completely, yes.  I think I will do this after
>>> NetBSD and OpenBSD upgrade to -mdocNG.
>>
>> How would this handle non-native man pages?  I have a whole collection
>> of man pages for different operating systems on my system.
>
> I certainly didn't read this thread to mean that Ruslan's going to
> remove support for the Os macro.  I understood from this thread that
> Ruslan's going to remove the Os _call_ from the existing FreeBSD
> manuals.

Yes, that's what I understand too.  So if we format one of these man
pages under NetBSD, it will claim to be a NetBSD man page.  Does this
sound right to you?

> Sometimes, I get the impression you're just following FreeBSD mail
> so you can pick a fight. :-)

Then you're missing the point.  This is a serious issue.  If we're
documenting FreeBSD, we should say so, we shouldn't assume that the
man pages will only be viewed on (the same revision of) FreeBSD.

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?20010725085832.P75783>