From owner-cvs-all Mon Jul 23 16:50:32 2001 Delivered-To: cvs-all@freebsd.org Received: from meow.osd.bsdi.com (meow.osd.bsdi.com [204.216.28.88]) by hub.freebsd.org (Postfix) with ESMTP id C733A37B405; Mon, 23 Jul 2001 16:50:18 -0700 (PDT) (envelope-from jhb@FreeBSD.org) Received: from laptop.baldwin.cx (john@jhb-laptop.osd.bsdi.com [204.216.28.241]) by meow.osd.bsdi.com (8.11.4/8.11.2) with ESMTP id f6NNoAv06321; Mon, 23 Jul 2001 16:50:10 -0700 (PDT) (envelope-from jhb@FreeBSD.org) Message-ID: 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: <20010724090443.L55779@wantadilla.lemis.com> Date: Mon, 23 Jul 2001 16:50:18 -0700 (PDT) From: John Baldwin To: Greg Lehey 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 , Ruslan Ermilov 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 23-Jul-01 Greg Lehey wrote: > On Monday, 23 July 2001 at 12:21:24 +0300, Ruslan Ermilov wrote: >> On Sun, Jul 22, 2001 at 03:57:33AM -0500, Mike Pritchard wrote: >>> >>> I agreed to it, never requested it. At the time I suggested >>> that if all we are going to have is a plain ".Os" line in every man >>> page with no information, then we should just remove ".Os" totally, >>> since it it just taking up space and processing time. >> >> Historically, a missing .Os call would result in an empty bottom left >> corner. >> With -mdocNG, as of this delta, >> >> >> >> 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 don't > want the formatting software to claim that they relate to the system > on which they're formatted. It looks to me as if the .Os should > explicitly specify which operating system the man page belongs to. I agree. Especially for manpages that are very OS-specific, such as many kernel API manpages which document API's very specific to FreeBSD. If someone looks at that manpage on a Solaris box, it shouldn't be claiming that solaris implements sx locks for example. > Greg > -- > See complete headers for address and phone numbers -- John Baldwin -- 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