Date: Mon, 23 Jul 2001 16:50:18 -0700 (PDT) From: John Baldwin <jhb@FreeBSD.org> To: Greg Lehey <grog@FreeBSD.org> Cc: 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: <XFMail.010723165018.jhb@FreeBSD.org> In-Reply-To: <20010724090443.L55779@wantadilla.lemis.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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, >> >> <snip> >> >> 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 <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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?XFMail.010723165018.jhb>