From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: Generating the ChangeLog files from the commit messages Date: Tue, 18 Nov 2014 09:56:03 -0800 Organization: UCLA Computer Science Department Message-ID: <546B8833.60505@cs.ucla.edu> References: <21606.10799.112099.788101@a1i15.kph.uni-mainz.de> <1753218.Ot8JCqssfN@descartes> <546AABCF.8030705@cs.ucla.edu> <9xioico2nm.fsf@fencepost.gnu.org> <83k32s9zm5.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------050705040307080106060009" X-Trace: ger.gmane.org 1416333415 25323 80.91.229.3 (18 Nov 2014 17:56:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 18 Nov 2014 17:56:55 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii , Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Nov 18 18:56:50 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Xqn1E-00055o-69 for ged-emacs-devel@m.gmane.org; Tue, 18 Nov 2014 18:56:48 +0100 Original-Received: from localhost ([::1]:54575 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xqn1D-0001kJ-OW for ged-emacs-devel@m.gmane.org; Tue, 18 Nov 2014 12:56:47 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44116) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xqn0n-0001dg-RZ for emacs-devel@gnu.org; Tue, 18 Nov 2014 12:56:26 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xqn0j-0001YF-1l for emacs-devel@gnu.org; Tue, 18 Nov 2014 12:56:21 -0500 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:43961) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xqn0e-0001Wf-5p; Tue, 18 Nov 2014 12:56:12 -0500 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id 3069AA6008B; Tue, 18 Nov 2014 09:56:11 -0800 (PST) X-Virus-Scanned: amavisd-new at smtp.cs.ucla.edu Original-Received: from smtp.cs.ucla.edu ([127.0.0.1]) by localhost (smtp.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id EEI3Ivbucsyy; Tue, 18 Nov 2014 09:56:07 -0800 (PST) Original-Received: from penguin.cs.ucla.edu (Penguin.CS.UCLA.EDU [131.179.64.200]) by smtp.cs.ucla.edu (Postfix) with ESMTPSA id 27F9EA60024; Tue, 18 Nov 2014 09:56:07 -0800 (PST) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.2.0 In-Reply-To: <83k32s9zm5.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 131.179.128.62 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:177612 Archived-At: This is a multi-part message in MIME format. --------------050705040307080106060009 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit On 11/18/2014 09:40 AM, Eli Zaretskii wrote: > I've seen a couple of projects > where the quality of log messages is very low That can be a problem, but it's the same as the problem where the quality of ChangeLog files is very low. The two problems are solvable in the same way, namely by asking developers to write good commit log messages / ChangeLog entries, just as Stefan asked Lars to do a few minutes ago You can judge the results by looking at the coreutils ChangeLog file (the first few entries are attached). This was automatically generated from coreutils' commit log.These ChangeLog entries are just as high-quality as Emacs's, though admittedly coreutils is a smaller project and is easier to shepherd. Glenn's objection (1) was not enough support in Emacs. This depends on the workflow one uses. I use vc-dwim and it works well for me. Others may prefer to do other things, and this may require some Elisp hacking to work to their satisfaction, but it shouldn't be a big problem. Glenn's objection (2) was that he sometimes wants more details in the commit log than in the ChangeLog. He's right, this is a downside, but my own feeling is that it's a minor one. We shouldn't be spending so much time on ChangeLog files that we worry about this sort of thing. Just write a decent entry and move on. --------------050705040307080106060009 Content-Type: text/plain; charset=UTF-8; name="ChangeLog" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="ChangeLog" MjAxNC0wNy0xOCAgUMOhZHJhaWcgQnJhZHkgIDxQQGRyYWlnQnJhZHkuY29tPgoKCXZlcnNp b24gOC4yMwoJKiBORVdTOiBSZWNvcmQgcmVsZWFzZSBkYXRlLgoKCWJ1aWxkOiBwb3J0IG5l dyBib290c3RyYXAgc2NyaXB0IHRvIFBPU0lYIHNoZWxscwoJKiBidWlsZC1hdXgvZ2VuLXNp bmdsZS1iaW5hcnkuc2g6IEF2b2lkIGJhc2ggb25seSBjb25zdHJ1Y3RzLgoJUmVwb3J0ZWQg YnkgQXNzYWYgR29yZG9uCgoJdGVzdHM6IGZpeCBmYWxzZSBmYWlsdXJlIHdpdGggc3BhY2Vz IGluIHRoZSB0ZXN0IGRpcmVjdG9yeQoJKiB0ZXN0cy9taXNjL2Vudi5zaDogU2tpcCBpZiB3 ZSBjYW4ndCBleGVjdXRlIHRoZSBnZW5lcmF0ZWQgc2hlYmFuZywKCXdoaWNoIHdvdWxkIGJl IHRoZSBjYXNlIGlmIHRoZXJlIGFyZSBzcGFjZXMgaW4gdGhlIGRpcmVjdG9yeSBoaWVyYXJj aHkuCglUaGlzIGlzIHRyaWdnZXJlZCBieSBgbWFrZSBkaXN0Y2hlY2tgCgoyMDE0LTA3LTE4 ICBQw6FkcmFpZyBCcmFkeSAgPFBAZHJhaWdCcmFkeS5jb20+CgoJYnVpbGQ6IGRvbid0IGRp c3RyaWJ1dGUgZ2VuZXJhdGVkIGNvcmV1dGlscy5oCglUaGlzIGlzc3VlIHdhcyBpZGVudGlm aWVkIGJ5IHRoZSBtYW5pZmVzdCBjb21wYXJpc29ucwoJZG9uZSBieSBgbWFrZSBkaXN0Y2hl Y2tgCgoJKiBzcmMvbG9jYWwubWsgKG5vaW5zdF9IRUFERVJTKTogUmVtb3ZlIGNvcmV1dGls cy5oIGZyb20gdGhpcyBhbHdheXMKCWRpc3RyaWJ1dGVkIGxpc3QuCgkobm9kaXN0X3NyY19j b3JldXRpbHNfU09VUkNFUyk6IEFkZCBjb3JldXRpbHMuaCBhcyBpdHMgY29udGVudHMKCWFy ZSBkZXRlcm1pbmVkIGF0IGNvbmZpZ3VyZSB0aW1lLCBzbyBwb2ludGxlc3MgdG8gZGlzdHJp YnV0ZS4KCShzcmNfY29yZXV0aWxzX1NPVVJDRVMpOiBEZWZpbmUgZXhwbGljaXRseSBzbyB0 aGF0IHRoZSBjb3JyZXNwb25kaW5nCglub2Rpc3RfIHZhcmlhYmxlIGlzIGhvbm9yZWQuCgko RElTVENMRUFORklMRVMpOiBBZGQgY29yZXV0aWxzLmggdG8gdGhpcyByYXRoZXIgdGhhbiBD TEVBTkZJTEVTLAoJYXMgaXRzIGNvbnRlbnRzIGFyZSBkZXRlcm1pbmVkIGF0IGNvbmZpZ3Vy ZSB0aW1lLgoKMjAxNC0wNy0xOCAgUMOhZHJhaWcgQnJhZHkgIDxQQGRyYWlnQnJhZHkuY29t PgoKCXRlc3RzOiBmaXggZmFsc2UgZmFpbHVyZSBpbiBjcCAtLXByZXNlcnZlPWNvbnRleHQg dGVzdAoJV2l0aCBsaWJzZWxpbnV4LTIuMi4xLTYuZmMyMC54ODZfNjQsIGtlcm5lbC0zLjEy LjYtMzAwLmZjMjAueDg2XzY0CglgY3AgLS1wcmVzZXJ2ZT1jb250ZXh0IHNyYyBkc3RgIHdh cyBzZWVuIHRvIHN1Y2NlZWQgd2hlbiBzcmMgYW5kCglkc3Qgd2hlcmUgb24gdGhlIHNhbWUg Zml4ZWQgY29udGV4dCBmaWxlIHN5c3RlbSwgYXMgbHNldGZpbGVjb24oKQoJcmV0dXJuZWQg c3VjY2VzcyBpbiB0aGlzIGNhc2Ugd2hlbiB0aGUgY29udGV4dCB3YXNuJ3QgYmVpbmcgY2hh bmdlZC4KCgkqIHRlc3RzL2NwL2NwLWEtc2VsaW51eC5zaDogQ29weSBmcm9tIGEgZGlmZmVy ZW50IGZpbGUgc3lzdGVtIHRvCgltb3N0IGxpa2VseSBoYXZlIGEgZGlmZmVyZW50IGNvbnRl eHQgdGhhdCB3aWxsIHRlc3QgY29udGV4dAoJc2V0dGluZyBsb2dpYyBjb3JyZWN0bHkuCgoy MDE0LTA3LTE4ICBQw6FkcmFpZyBCcmFkeSAgPFBAZHJhaWdCcmFkeS5jb20+CgoJbWFpbnQ6 IGF2b2lkIGEgc3ludGF4LWNoZWNrIHdhcm5pbmcgaW4gcHJldmlvdXMgY29tbWl0CgkqIGNm Zy5tazogQXZvaWQgd2FybmluZyBmb3IgQEFNREVQX1RSVUVAIHVzYWdlIGluIG1hbi9sb2Nh bC5tawoKMjAxNC0wNy0xNyAgUGF1bCBFZ2dlcnQgIDxlZ2dlcnRAY3MudWNsYS5lZHU+CgoJ YnVpbGQ6IHBvcnQgdG8gbm9uLUdOVSBtYWtlCglUaGlzIGZpeGVzIGEgcHJvYmxlbSB3aXRo IG5hdGl2ZSBTb2xhcmlzICdtYWtlJywgd2hpY2ggZG9lcyBub3QKCWdyb2sgJy1pbmNsdWRl JyBsaW5lcyAoYSBHTlUgZXh0ZW5zaW9uIHRvIFBPU0lYICdtYWtlJykuCgkqIGNvbmZpZ3Vy ZS5hYyAobWFuL2R5bmFtaWMtZGVwcy5tayk6IENyZWF0ZSBpdCwgd2l0aCBhbiBvbGQKCXRp bWUgc3RhbXAsIGlmIGRvaW5nIGR5bmFtaWMgZGVwZW5kZW5jeSB0cmFja2luZy4KCSogbWFu L2xvY2FsLm1rIChESVNUQ0xFQU5GSUxFUyk6IFB1dCBtYW4vZHluYW1pYy1kZXBzLm1rIGhl cmUsCglyYXRoZXIgdGhhbiBpbiBDTEVBTkZJTEVTLgoJKG1hbi9keW5hbWljLWRlcHMubWsp OiBEb24ndCBjcmVhdGUgaXQgcmVhZC1vbmx5LCBzbyB0aGF0IHdlCgljYW4gZWFzaWx5IHRv dWNoIGl0IGxhdGVyLgoJSW5jbHVkZSBpdCB3aXRoICdAQU1ERVBfVFJVRUBAYW1fX2luY2x1 ZGVAJywgbm90IHdpdGggJy1pbmNsdWRlJywKCWFzICctaW5jbHVkZScgZG9lcyBub3Qgd29y ayB3aXRoIG5hdGl2ZSBTb2xhcmlzICdtYWtlJy4KCjIwMTQtMDctMTYgIEFzc2FmIEdvcmRv biAgPGFzc2FmZ29yZG9uQGdtYWlsLmNvbT4KCgludW1mbXQ6IGZpeCBpc2JsYW5rKCkgdXNh Z2UgZm9yIHNvbWUgdW5pYnl0ZSBsb2NhbGVzCgkqIHNyYy9udW1mbXQuYyAoc2ltcGxlX3N0 cnRvZF9pbnQpOiBSZXBsYWNlIGlzZGlnaXQoKSB3aXRoIGNfaXNkaWdpdCgpCgl0byBhdm9p ZCBsb2NhbGUgY29uY2VybnMgYW5kIC1XY2hhci1zdWJzY3JpcHRzIHdhcm5pbmdzIG9uIGN5 Z3dpbi4KCVJlbW92ZSB0aGUgbm93IHJlZHVuZGFudCBsb2NhbGUgZ3VhcmQuCgkoc2ltcGxl X3N0cnRvZF9odW1hbik6IENhc3QgY2hhcmFjdGVycyB0byB1bnNpZ25lZCBzbyB0aGF0IHRo ZSBwcm9tb3RlZAoJaW50IHZhbHVlIHBhc3NlZCB0byBpc2JsYW5rKCkgaXMgcG9zaXRpdmUs IGFsbG93aW5nIGl0IHRvIHdvcmsgY29ycmVjdGx5Cglmb3IgYWxsIGNoYXJhY3RlcnMgaW4g dW5pYnl0ZSBsb2NhbGVzLiAgUHJldmlvdXNseSBjaGFyYWN0ZXIgMHhBMCwKCWkuZS4gbm9u LWJyZWFraW5nIHNwYWNlLCB3b3VsZCBiZSBtaXNjbGFzc2lmaWVkIGZvciBleGFtcGxlLgoJ KHByb2Nlc3Nfc3VmZml4ZWRfbnVtYmVyKTogTGlrZXdpc2UuCgkoc2tpcF9maWVsZHMpOiBM aWtld2lzZS4KCUJvdGggaXNzdWVzIHdlcmUgdHJpZ2dlcmVkIGJ5IHRoZSAtV2NoYXItc3Vi c2NyaXB0cyB3YXJuaW5nIG9uIEdDQyA0LjguMwoJb24gY3lnd2luLCBkdWUgdG8gdGhlIGlz KigpIGltcGxlbWVudGF0aW9ucyB1c2VkIHRoZXJlLCBidXQgdGhlIGlzc3VlCglpcyBwcmVz ZW50IG9uIGFsbCBwbGF0Zm9ybXMgZGVmYXVsdGluZyB0byBzaWduZWQgY2hhcnMuCgkqIE5F V1M6IE1lbnRpb24gdGhlIGJ1ZyBmaXguCgoJUmVwb3J0ZWQgYnkgRXJpYyBCbGFrZQoKMjAx NC0wNy0xNCAgUMOhZHJhaWcgQnJhZHkgIDxQQGRyYWlnQnJhZHkuY29tPgoKCXRlc3RzOiBm aXggcG9ydGFiaWxpdGl5IGlzc3VlIGluIG5ldyBvZC1lbmRpYW4gdGVzdAoJKiB0ZXN0cy9t aXNjL29kLWVuZGlhbi5zaDogJ1xuJyBpcyBub3QgZ2VuZXJhbGx5IHN1cHBvcnRlZAoJaW4g dGhlIHJlcGxhY2VtZW50LCBzbyB1c2UgdGhlIG1vcmUgcG9ydGFibGUgIlxcJE5MIi4KCgl0 ZXN0czogZml4IHBvcnRhYmlsaXR5IGlzc3VlIGluIG5ldyBkZC9hc2NpaSB0ZXN0CgkqIHRl c3RzL2RkL2FzY2lpLnNoOiBRdW90ZSBzbyB0aGF0ICdcXCcgaXMgcGFzc2VkCgl0byBwcmlu dGYgcmF0aGVyIHRoYW4gYSBzaW5nbGUgJ1wnLCBhcyB0aGF0J3Mgbm90IHBvcnRhYmxlLgoJ YmFzaCwgZGFzaCwgenNoIGFuZCBleHRlcm5hbCBzb2xhcmlzIHByaW50ZiB3ZXJlIHNlZW4g dG8gc3VwcG9ydAoJICBwcmludGYgJ1wlMDNvJyAxIDIKCXdoaWxlIGtzaCwgZnJlZWJzaCBz aGVsbCBhbmQgZXh0ZXJuYWwgR05VIHByaW50ZiBuZWVkIHRoZSBtb3JlIHBvcnRhYmxlCgkg IHByaW50ZiAnXFwlMDNvJyAxIDIKCU5vdGUgd2UgZG9uJ3QgdXNlIGVudiBoZXJlIHRvIGNh bGwgdGhlIGNvcmV1dGlscyBwcmludGYgaW1wbGVtZW50YXRpb24sCglhcyB0aGVyZSBhcmUg bWFueSBwcmludGYgY2FsbHMsIHNvIHJlbHlpbmcgb24gcG9ydGFibGUgc2hlbGwKCWltcGxl bWVudGF0aW9ucyB3aWxsIGJlIGZhc3Rlci4KCgl0ZXN0czogYXZvaWQgaGFuZyB3aGVuIGZp bGVzIGNyZWF0ZWQgd2l0aCB3cm9uZyBwZXJtaXNzaW9ucwoJKiB0ZXN0cy9zcGxpdC9iLWNo dW5rLnNoOiBOZXZlciBzaG93IHRoZSBybSBwcm9tcHQgd2hpY2ggd291bGQKCWhhbmcgdGhl IHRlc3Qgc3VpdGUuICBUaGlzIHdhcyBzZWVuIHdoZW4gc3BsaXQgZXJyb25lb3VzbHkKCWNy ZWF0ZWQgZmlsZXMgd2l0aCBubyBwZXJzbWlzc2lvbnMsIHdoaWNoIHdhcyB0cmlnZ2VyZWQg YnkKCXRoaXMgY29tcGlsZXIgYnVnIGluIGNsYW5nIDMuNDoKCWh0dHA6Ly9sbHZtLm9yZy9i dWdzL3Nob3dfYnVnLmNnaT9pZD0xODM0NgoKCW1haW50OiBhdm9pZCBjbGFuZyAtV2ludC10 by1wb2ludGVyLWNhc3Qgd2FybmluZwoJKiBzcmMvY2hyb290LmM6IEV4cGxpY2l0bHkgY2Fz dCBpbnQgdG8gcG9pbnRlciB0eXBlLgo= --------------050705040307080106060009--