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: lib/ should have its own ChangeLog Date: Wed, 09 Feb 2011 23:36:53 -0800 Organization: UCLA Computer Science Department Message-ID: <4D539595.9080507@cs.ucla.edu> References: <2hmxm432zn.fsf@fencepost.gnu.org> <4D538491.5040402@cs.ucla.edu> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1297361440 22944 80.91.229.12 (10 Feb 2011 18:10:40 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 10 Feb 2011 18:10:40 +0000 (UTC) Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Feb 10 19:10:35 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 1PnayQ-0001Id-W3 for ged-emacs-devel@m.gmane.org; Thu, 10 Feb 2011 19:10:35 +0100 Original-Received: from localhost ([127.0.0.1]:47390 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PnayQ-00032Y-9l for ged-emacs-devel@m.gmane.org; Thu, 10 Feb 2011 13:10:34 -0500 Original-Received: from [140.186.70.92] (port=53862 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PnR5R-0004ZD-QD for emacs-devel@gnu.org; Thu, 10 Feb 2011 02:37:10 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PnR5M-0003lr-LZ for emacs-devel@gnu.org; Thu, 10 Feb 2011 02:37:05 -0500 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:56286) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PnR5J-0003lD-3l; Thu, 10 Feb 2011 02:37:01 -0500 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id 4FF2939E80F8; Wed, 9 Feb 2011 23:36:59 -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 cFUhShNyK+Xo; Wed, 9 Feb 2011 23:36:58 -0800 (PST) Original-Received: from [192.168.1.10] (pool-71-189-109-235.lsanca.fios.verizon.net [71.189.109.235]) by smtp.cs.ucla.edu (Postfix) with ESMTPSA id C0E6339E80DC; Wed, 9 Feb 2011 23:36:58 -0800 (PST) User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.2.13) Gecko/20101208 Thunderbird/3.1.7 In-Reply-To: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 131.179.128.62 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:135852 Archived-At: On 02/09/2011 11:04 PM, Eli Zaretskii wrote: > detailed > descriptions of the changeset are supposed to be part of the commit > log messages. ChangeLog entries can just state what was changed; This seems to imply that ChangeLog entries are short and commit logs are long. But in practice the reverse is common, with the detailed description is in the ChangeLog, and the commit log being a brief summary. I'm used to this tradition and don't see why it should (ahem) change. For example, for the most recent entry in lisp/ChangeLog the commit record is short: * allout.el: Synopsis: Change allout user configuration so auto-activation is controlled solely by customization `allout-auto-activation'. whereas the ChangeLog entry is long: 2011-02-10 Ken Manheimer * allout.el: Synopsis: Change allout user configuration so auto-activation is controlled solely by customization `allout-auto-activation'. (allout-auto-activation-helper) (allout-setup): New autoloads implement new custom set procedure for allout-auto-activation. Also, explicitly invoke (allout-setup) after allout-auto-activation is custom-defined, to effect the settings in emacs sessions besides the few where allout-auto-activation customization is donea. (allout-auto-activation): Use allout-auto-activation-helper to :set. Revise the docstring. (allout-init): Reduce functionality to just customizing allout-auto-activation, and mark obsolete. (allout-mode): Respect string values for allout-auto-activation. Run allout-after-copy-or-kill-hook without any args. (allout-mode) (allout-layout) (allout-default-layout) (outlineify-sticky): Adjust docstring for new scheme. (allout-after-copy-or-kill-hook): No arguments - hook implementers should concentrate on the kill ring.