From owner-cvs-all Tue Jul 24 16:28:47 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 9CC2037B407; Tue, 24 Jul 2001 16:28:34 -0700 (PDT) (envelope-from grog@lemis.com) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id B51446ACC1; Wed, 25 Jul 2001 08:58:32 +0930 (CST) Date: Wed, 25 Jul 2001 08:58:32 +0930 From: Greg Lehey To: Sheldon Hearn Cc: Ruslan Ermilov , Mike Pritchard , 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> References: <20010724090443.L55779@wantadilla.lemis.com> <7435.995964522@axl.seasidesoftware.co.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <7435.995964522@axl.seasidesoftware.co.za>; from sheldonh@starjuice.net on Tue, Jul 24, 2001 at 10:48:42AM +0200 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: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG 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