From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.emacs.devel Subject: Re: Please don't use revision numbers on commit messages (and elsewhere). Date: Fri, 01 Apr 2011 01:16:09 +0200 Message-ID: <87sju2hoee.fsf@ambire.localdomain> References: <877hbfvwyo.fsf@wanadoo.es> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1301613405 3152 80.91.229.12 (31 Mar 2011 23:16:45 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 31 Mar 2011 23:16:45 +0000 (UTC) Cc: emacs-devel@gnu.org To: =?utf-8?Q?=C3=93scar?= Fuentes Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Apr 01 01:16:40 2011 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Q5R6V-0006q7-Eq for ged-emacs-devel@m.gmane.org; Fri, 01 Apr 2011 01:16:39 +0200 Original-Received: from localhost ([127.0.0.1]:39757 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q5R6U-00047t-TZ for ged-emacs-devel@m.gmane.org; Thu, 31 Mar 2011 19:16:38 -0400 Original-Received: from [140.186.70.92] (port=40179 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q5R6P-00047V-Tv for emacs-devel@gnu.org; Thu, 31 Mar 2011 19:16:34 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q5R6O-0001ua-LM for emacs-devel@gnu.org; Thu, 31 Mar 2011 19:16:33 -0400 Original-Received: from smtp204.alice.it ([82.57.200.100]:41919) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q5R6O-0001uG-8c for emacs-devel@gnu.org; Thu, 31 Mar 2011 19:16:32 -0400 Original-Received: from ambire.localdomain (95.236.25.133) by smtp204.alice.it (8.5.124.08) id 4D7E0F64018750DB; Fri, 1 Apr 2011 01:16:28 +0200 Original-Received: from ttn by ambire.localdomain with local (Exim 4.69) (envelope-from ) id 1Q5R62-0002g0-1x; Fri, 01 Apr 2011 01:16:10 +0200 In-Reply-To: <877hbfvwyo.fsf@wanadoo.es> (=?utf-8?Q?=22=C3=93scar?= Fuentes"'s message of "Thu, 31 Mar 2011 22:47:27 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 82.57.200.100 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:137959 Archived-At: () =C3=93scar Fuentes () Thu, 31 Mar 2011 22:47:27 +0200 please use the revision id, which is unique for every commit. I think it would both more vcs-agnostic and programmer-friendly to use a date and commit title (presuming the commit has one). For example: 2011-03-31 Thien-Thi Nguyen =20=20 [lib] Fix bug: Reorder #include "libserveez/foo.h" in libserveez.h. =20=20 Regression (due to omission) introduced 2011-03-04, "Mark #include "libservez/foo.h" as internal". Lesson: Take care when discarding dependency (ordering) info! =20=20 * libserveez.h: Move =E2=80=98pipe-socket=E2=80=99 and =E2=80=98portcfg= =E2=80=99 before =E2=80=98cfg=E2=80=99. =20=20 Here, the date is 2011-03-04, and the title is "Mark ... internal". These two pieces of info are usually sufficient to uniquely identify a particular change, and a nice side benefit is that the window of the bug is apparently computable (in this example almost four weeks -- eep!). More mumblings on ChangeLog format at: http://git.savannah.gnu.org/cgit/serveez.git/tree/HACKING?h=3Dnext#n228