From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: lib/ should have its own ChangeLog Date: Thu, 10 Feb 2011 13:09:15 -0500 Message-ID: References: <2hmxm432zn.fsf@fencepost.gnu.org> <4D538491.5040402@cs.ucla.edu> <4D539595.9080507@cs.ucla.edu> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1297361378 22596 80.91.229.12 (10 Feb 2011 18:09:38 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 10 Feb 2011 18:09:38 +0000 (UTC) Cc: Eli Zaretskii , emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Feb 10 19:09:34 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 1PnaxM-0000Is-La for ged-emacs-devel@m.gmane.org; Thu, 10 Feb 2011 19:09:28 +0100 Original-Received: from localhost ([127.0.0.1]:51981 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PnaxM-00024Y-16 for ged-emacs-devel@m.gmane.org; Thu, 10 Feb 2011 13:09:28 -0500 Original-Received: from [140.186.70.92] (port=55768 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PnaxC-00021j-W8 for emacs-devel@gnu.org; Thu, 10 Feb 2011 13:09:19 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PnaxC-0005uJ-1D for emacs-devel@gnu.org; Thu, 10 Feb 2011 13:09:18 -0500 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.183]:41930 helo=ironport2-out.pppoe.ca) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PnaxA-0005tW-IX; Thu, 10 Feb 2011 13:09:16 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AvsEAJ24U01FxIyy/2dsb2JhbAClanS6S4VcBIUBjzODOA X-IronPort-AV: E=Sophos;i="4.60,451,1291611600"; d="scan'208";a="91222985" Original-Received: from 69-196-140-178.dsl.teksavvy.com (HELO ceviche.home) ([69.196.140.178]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 10 Feb 2011 13:09:15 -0500 Original-Received: by ceviche.home (Postfix, from userid 20848) id 60930660C9; Thu, 10 Feb 2011 13:09:15 -0500 (EST) In-Reply-To: <4D539595.9080507@cs.ucla.edu> (Paul Eggert's message of "Wed, 09 Feb 2011 23:36:53 -0800") 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: 206.248.154.183 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:135851 Archived-At: >> 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. Actually, the ChangeLog should contain the exact same text as the commit message, so we can eventually auto-generate the ChangeLog(s). Stefan