Date: Wed, 11 Jul 2001 10:22:12 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Greg Lehey <grog@FreeBSD.org> 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> In-Reply-To: <20010711081534.C64441@wantadilla.lemis.com>; from grog@FreeBSD.org on Wed, Jul 11, 2001 at 08:15:34AM %2B0930 References: <200107101004.f6AA49e06877@freefall.freebsd.org> <20010711081534.C64441@wantadilla.lemis.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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 [<operating system>] [<release>]
: 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
<mpp@FreeBSD.org> and Sheldon Hearn <sheldonh@FreeBSD.org>, 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 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?20010711102212.B24098>