From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: Commit netiquette. Date: Fri, 19 Feb 2010 09:22:29 +0900 Message-ID: <87mxz613cq.fsf@uwakimon.sk.tsukuba.ac.jp> References: <87eikjzaug.fsf@telefonica.net> <87pr42y2le.fsf@telefonica.net> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1266538211 5027 80.91.229.12 (19 Feb 2010 00:10:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 19 Feb 2010 00:10:11 +0000 (UTC) Cc: emacs-devel@gnu.org To: =?iso-8859-1?Q?=D3scar?= Fuentes Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Feb 19 01:10:09 2010 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 1NiGRc-0000Ci-Ha for ged-emacs-devel@m.gmane.org; Fri, 19 Feb 2010 01:10:08 +0100 Original-Received: from localhost ([127.0.0.1]:37039 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NiGRc-0000MY-0w for ged-emacs-devel@m.gmane.org; Thu, 18 Feb 2010 19:10:08 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NiGRW-0000MR-Kq for emacs-devel@gnu.org; Thu, 18 Feb 2010 19:10:02 -0500 Original-Received: from [140.186.70.92] (port=33044 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NiGRR-0000Ku-T1 for emacs-devel@gnu.org; Thu, 18 Feb 2010 19:10:02 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1NiGRN-0002f6-3I for emacs-devel@gnu.org; Thu, 18 Feb 2010 19:09:57 -0500 Original-Received: from mtps01.sk.tsukuba.ac.jp ([130.158.97.223]:32991) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1NiGRM-0002ez-O9 for emacs-devel@gnu.org; Thu, 18 Feb 2010 19:09:53 -0500 Original-Received: from uwakimon.sk.tsukuba.ac.jp (uwakimon.sk.tsukuba.ac.jp [130.158.99.156]) by mtps01.sk.tsukuba.ac.jp (Postfix) with ESMTP id D7D511535AC; Fri, 19 Feb 2010 09:09:50 +0900 (JST) Original-Received: by uwakimon.sk.tsukuba.ac.jp (Postfix, from userid 1000) id 54969127640; Fri, 19 Feb 2010 09:22:29 +0900 (JST) In-Reply-To: <87pr42y2le.fsf@telefonica.net> X-Mailer: VM 8.0.12-devo-585 under 21.5 (beta29) "garbanzo" a03421eb562b XEmacs Lucid (x86_64-unknown-linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) 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:121202 Archived-At: =D3scar Fuentes writes: > On this respect I find changelog entries as a lame way of documenting > changes. Some senior developers are used to this method, and they are already familiar with the code base. It works well enough, regardless of your opinion. The real issues you should be pointing to are (1) accurate commit log messages are an excellent way to learn about the code base, so the Emacs infrastructure (edit-log, vc) should try to ensure that commit logs are as detailed as ChangeLog entries, and (2) ChangeLogs are a minor but very persistent annoyance (especially to people doing integrative work, like the maintainers) because they *very* frequently require special handling, such as merge conflict resolution. (1) should be easy enough to achieve, but (2) will require balancing the interests of those used to ChangeLogs with their deficiencies.