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>
next in thread | previous in thread | raw e-mail | index | archive | help
This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig072EEB43F4123DF64EE2E9AD Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable 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>=20 >> 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: >=20 > .\" $FreeBSD: src/share/examples/mdoc/example.4,v 1.21.2.2 2006/06/05 1= 9: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 >=20 >> 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. --=20 Florent Thoumie flz@FreeBSD.org FreeBSD Committer --------------enig072EEB43F4123DF64EE2E9AD Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----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----- --------------enig072EEB43F4123DF64EE2E9AD--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?456F0C2A.80603>