Man pages .Dd

[Greg 'groggy' Lehey]

On Sunday,  3 December 2006 at 23:15:25 -0700, M. Warner Losh wrote:
> In message: <20061204002231.GB36269 at wantadilla.lemis.com>
>             "Greg 'groggy' Lehey" <grog at FreeBSD.org> writes:
>> On Friday,  1 December 2006 at 14:09:25 +0100, Sascha Wildner wrote:
>>> M. Warner Losh wrote:
>>>> content changes, but not typos or formatting, is when it should be
>>>> bumpped.  Also on MFC, the date used is the one in -current, not the
>>>> date that you MFC.  This makes it hard to automate.
>>>
>>> Where exactly is the benefit in bumping/having dates on manpages at all?
>>>
>>> I mean, does anyone actually notice that the date changed (by
>>> remembering the date of the previous version) and think, "oh great,
>>> there's been a content change, let's check that out"?
>>
>> Good point.  Clearly it's worthwhile knowing what version of the man
>> page you have, if only to know whether it's up to date.  But the
>> $FreeBSD$ tag would give more information there.
>
> <mode=bde>
> $FreeBSD$ or $Date$ would pessimize the display of the date by
> uglifying the presentation to the user.
> </mode>

Only if you were to display it in its entirety.  Macros exist to
convert them into correct dates.

Greg
--
See complete headers for address and phone numbers.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-src/attachments/20061204/7b747e25/attachment.pgp