From owner-cvs-all@FreeBSD.ORG Thu Nov 30 13:14:24 2006 Return-Path: X-Original-To: cvs-all@freebsd.org Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id EA23516A513; Thu, 30 Nov 2006 13:14:24 +0000 (UTC) (envelope-from ru@rambler-co.ru) Received: from relay0.rambler.ru (relay0.rambler.ru [81.19.66.187]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3A49B43CA5; Thu, 30 Nov 2006 13:14:13 +0000 (GMT) (envelope-from ru@rambler-co.ru) Received: from relay0.rambler.ru (localhost [127.0.0.1]) by relay0.rambler.ru (Postfix) with ESMTP id 7A261689C; Thu, 30 Nov 2006 16:14:20 +0300 (MSK) Received: from edoofus.park.rambler.ru (unknown [81.19.65.108]) by relay0.rambler.ru (Postfix) with ESMTP id 707BF6892; Thu, 30 Nov 2006 16:14:20 +0300 (MSK) Received: (from ru@localhost) by edoofus.park.rambler.ru (8.13.8/8.13.8) id kAUDELBt075143; Thu, 30 Nov 2006 16:14:21 +0300 (MSK) (envelope-from ru) Date: Thu, 30 Nov 2006 16:14:21 +0300 From: Ruslan Ermilov To: Gleb Smirnoff Message-ID: <20061130131421.GA74988@rambler-co.ru> References: <200611292024.kATKOviH078532@repoman.freebsd.org> <20061129234157.GN42090@wantadilla.lemis.com> <20061130123712.GV32700@FreeBSD.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="zYM0uCDKw75PZbzx" Content-Disposition: inline In-Reply-To: <20061130123712.GV32700@FreeBSD.org> User-Agent: Mutt/1.5.13 (2006-08-11) X-Virus-Scanned: No virus found Cc: Greg 'groggy' Lehey , cvs-src@freebsd.org, src-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: Man pages .Dd (was: cvs commit: src/share/man/man9 uio.9) X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Nov 2006 13:14:25 -0000 --zYM0uCDKw75PZbzx Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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 wro= te: > 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$. >=20 > No. Only text changes bump .Dd. Style, spelling, wording and markup > do not. >=20 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: =2E\" $FreeBSD: src/share/examples/mdoc/example.4,v 1.21.2.2 2006/06/05 19:= 31:57 brueffer Exp $ =2E\" =2E\" Note: The date here should be updated whenever a non-trivial =2E\" change is made to the manual page. =2EDd April 1, 2006 > Also, when change is merged the .Dd is left from the original > commit to HEAD, not the date of the MFC. >=20 This is true (most of the time ;-). Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --zYM0uCDKw75PZbzx Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (FreeBSD) iD8DBQFFbtktqRfpzJluFF4RArQ5AJ9QvLKguaZrqVdyi1ZBQn+5w7hcpACdH1c9 1qBJERu4YOuXHk8KvUx9HgQ= =z770 -----END PGP SIGNATURE----- --zYM0uCDKw75PZbzx--