From owner-freebsd-doc Tue Aug 7 1:56:54 2001 Delivered-To: freebsd-doc@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id BE74337B401; Tue, 7 Aug 2001 01:56:32 -0700 (PDT) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.2/8.11.2) id f778VB252962; Tue, 7 Aug 2001 11:31:11 +0300 (EEST) (envelope-from ru) Date: Tue, 7 Aug 2001 11:31:11 +0300 From: Ruslan Ermilov To: Warner Losh Cc: Greg Lehey , Sheldon Hearn , John Baldwin , 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/bi Message-ID: <20010807113111.B45963@sunbay.com> Mail-Followup-To: Warner Losh , Greg Lehey , Sheldon Hearn , John Baldwin , Mike Pritchard , cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG, doc@FreeBSD.ORG 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> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <200108070811.f778Bt112605@harmony.village.org>; from imp@harmony.village.org on Tue, Aug 07, 2001 at 02:11:55AM -0600 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org 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