From owner-freebsd-doc Wed Jul 11 0:22:34 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 A9CDC37B408; Wed, 11 Jul 2001 00:22:17 -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 f6B7MCT28317; Wed, 11 Jul 2001 10:22:12 +0300 (EEST) (envelope-from ru) Date: Wed, 11 Jul 2001 10:22:12 +0300 From: Ruslan Ermilov To: Greg Lehey Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org, doc@FreeBSD.org Subject: Re: 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: <20010711102212.B24098@sunbay.com> Mail-Followup-To: Greg Lehey , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org, doc@FreeBSD.org References: <200107101004.f6AA49e06877@freefall.freebsd.org> <20010711081534.C64441@wantadilla.lemis.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010711081534.C64441@wantadilla.lemis.com>; from grog@FreeBSD.org on Wed, Jul 11, 2001 at 08:15:34AM +0930 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 Wed, Jul 11, 2001 at 08:15:34AM +0930, Greg Lehey wrote: > On Tuesday, 10 July 2001 at 3:04:09 -0700, Ruslan Ermilov wrote: > > ru 2001/07/10 03:04:09 PDT > > > > Modified files: > > bin/cp cp.1 > > bin/df df.1 > > bin/domainname domainname.1 > > bin/hostname hostname.1 > > bin/ln ln.1 symlink.7 > > bin/pax pax.1 > > bin/ps ps.1 > > bin/pwd pwd.1 realpath.1 > > bin/rcp rcp.1 > > bin/sh sh.1 > > bin/sh/bltin echo.1 > > bin/sync sync.8 > > Log: > > mdoc(7) police: removed HISTORY info from the .Os call. > > Why? I find this information interesting. > Reason 1, from mdoc(7): : The first items in the template are the macros `.Dd', `.Os', and `.Dt'; : the document date, the operating system the man page or subject source is ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ : developed or modified for, and the man page title (in upper case) along ^^^^^^^^^^^^^^^^^^^^^^^^^ : with the section of the manual the page belongs in. These macros iden- : tify the page and are discussed below in TITLE MACROS. This means FreeBSD for us, i.e., what we currently get with empty or even omitted .Os call. Reason 2, from mdoc(7): : .Os [] [] : If the first parameter is empty, the default `FreeBSD 4.3' is : used. This means that when FreeBSD 4.4 will be released, all manpages will print FreeBSD 4.4 in the left bottom corner, automatically. Reason 3, traditional. Our neighbours, NetBSD and OpenBSD did this change a long time ago. Reason 4. This was asked for many times by various -doc guys, including Mike Pritchard and Sheldon Hearn , IIRC. Last time in the late of 2000, when I started to work on -mdocNG, which we currently use. 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