Date: Thu, 30 Nov 2006 16:51:54 +0000 From: Florent Thoumie <flz@FreeBSD.org> To: Ruslan Ermilov <ru@freebsd.org> Cc: Greg 'groggy' Lehey <grog@freebsd.org>, cvs-src@freebsd.org, Gleb Smirnoff <glebius@freebsd.org>, src-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: Man pages .Dd Message-ID: <456F0C2A.80603@FreeBSD.org> In-Reply-To: <20061130131421.GA74988@rambler-co.ru> References: <200611292024.kATKOviH078532@repoman.freebsd.org> <20061129234157.GN42090@wantadilla.lemis.com> <20061130123712.GV32700@FreeBSD.org> <20061130131421.GA74988@rambler-co.ru>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] Ruslan Ermilov wrote: > On Thu, Nov 30, 2006 at 03:37:12PM +0300, Gleb Smirnoff wrote: >> On Thu, Nov 30, 2006 at 10:11:57AM +1030, Greg 'groggy' Lehey wrote: >> G> On Wednesday, 29 November 2006 at 20:24:57 +0000, Alfred Perlstein wrote: >> G> > alfred 2006-11-29 20:24:57 UTC >> G> > >> G> > FreeBSD src repository >> G> > >> G> > Modified files: >> G> > share/man/man9 uio.9 >> G> > Log: >> G> > Bump .Dd, (9 year jump!) >> G> > >> G> > Requested by: ru >> G> >> G> This happened to me too last week. I'm hazy about when, but my >> G> understanding has been that in the past .Dd *didn't* automatically get >> G> updated. When should it be, when shouldn't it be? If it should be >> G> automatic, we should write a macro which sets it from $FreeBSD$. >> >> No. Only text changes bump .Dd. Style, spelling, wording and markup >> do not. >> > Sometimes even editorial changes are so large that deserve a bump. > A common sense actually applies, but for content changes we usually > want to bump the date. The comment in the example manpages is > supposed to hint about this: > > .\" $FreeBSD: src/share/examples/mdoc/example.4,v 1.21.2.2 2006/06/05 19:31:57 brueffer Exp $ > .\" > .\" Note: The date here should be updated whenever a non-trivial > .\" change is made to the manual page. > .Dd April 1, 2006 > >> Also, when change is merged the .Dd is left from the original >> commit to HEAD, not the date of the MFC. >> > This is true (most of the time ;-). Is it true and right? Cause I'm always changing .Dd to the date of the MFC. -- Florent Thoumie flz@FreeBSD.org FreeBSD Committer [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (FreeBSD) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFFbwwqMxEkbVFH3PQRCj26AJ0Z9m4ZYmsrK+egfGBwr+f5j4lfFACaAw/L 7XXT0WYqh1yLX0DKwmUml5w= =O/sx -----END PGP SIGNATURE-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?456F0C2A.80603>