Date: Tue, 7 Aug 2001 11:31:11 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Warner Losh <imp@harmony.village.org> Cc: Greg Lehey <grog@FreeBSD.org>, Sheldon Hearn <sheldonh@starjuice.net>, John Baldwin <jhb@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/bi Message-ID: <20010807113111.B45963@sunbay.com> In-Reply-To: <200108070811.f778Bt112605@harmony.village.org>; from imp@harmony.village.org on Tue, Aug 07, 2001 at 02:11:55AM -0600 References: <20010807170342.J1565@wantadilla.lemis.com> <20010807093340.J69153@wantadilla.lemis.com> <28423.997169381@axl.seasidesoftware.co.za> <20010807170342.J1565@wantadilla.lemis.com> <200108070811.f778Bt112605@harmony.village.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Aug 07, 2001 at 02:11:55AM -0600, Warner Losh wrote:
> In message <20010807170342.J1565@wantadilla.lemis.com> Greg Lehey writes:
> : On Tuesday, 7 August 2001 at 9:29:41 +0200, Sheldon Hearn wrote:
> : > On Tue, 07 Aug 2001 09:33:40 +0930, Greg Lehey wrote:
> : >
> : >> These are not unlikely scenarios. They're real life. As I said in an
> : >> earlier message, I do have man pages for multiple architectures on my
> : >> network. I'm sure I'm not alone. Your standpoint makes you look like
> : >> you can't understand that other people may want to do things you
> : >> don't.
> : >
> : > So, like... what's your solution, specifically?
> :
> : As I said: we add the .Os and .Dd when installing.
>
> How is that different than just copying the mandoc macros that were
> used to build the man pages from the {cd, network, wherever} you got
> the man page sources from?
>
> Adding the .Os and .Dd at install time seems ugly to me.
>
Exactly my thoughts. The problem is more that just a single .Os macro.
Please see the gnu/usr.bin/groff/tmac/mdoc.local file for the details of
FreeBSD mdoc(7) customization. This file supplements the stock mdoc(7)
package, and is *needed* when viewing a FreeBSD manpage. It defines:
1. Customized .Sh header names.
2. Modified and new .Lb library names.
3. Default operating system (.Os without arguments).
tmac/mdoc/koi8-r contains a more complicated example of what
could be customized.
See my other posting in this thread for more details and a
real example.
Cheers,
--
Ruslan Ermilov Oracle Developer/DBA,
ru@sunbay.com Sunbay Software AG,
ru@FreeBSD.org FreeBSD committer,
+380.652.512.251 Simferopol, Ukraine
http://www.FreeBSD.org The Power To Serve
http://www.oracle.com Enabling The Information Age
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010807113111.B45963>