From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Karl Fogel Newsgroups: gmane.emacs.devel Subject: Re: ChangeLog policy for same-day changes to a file? Date: Wed, 02 Jan 2008 01:39:59 -0800 Message-ID: <87bq84r2fk.fsf@red-bean.com> References: <87hchwr4d4.fsf@red-bean.com> <87wsqsu2o9.fsf@catnip.gol.com> Reply-To: Karl Fogel NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1199259601 18317 80.91.229.12 (2 Jan 2008 07:40:01 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 2 Jan 2008 07:40:01 +0000 (UTC) Cc: emacs-devel@gnu.org To: Miles Bader Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jan 02 08:40:21 2008 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.50) id 1J9yD4-0006Ho-GV for ged-emacs-devel@m.gmane.org; Wed, 02 Jan 2008 08:40:18 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J9yCi-0004DT-9s for ged-emacs-devel@m.gmane.org; Wed, 02 Jan 2008 02:39:56 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1J9yCd-0004D5-CD for emacs-devel@gnu.org; Wed, 02 Jan 2008 02:39:51 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1J9yCb-0004Ch-TH for emacs-devel@gnu.org; Wed, 02 Jan 2008 02:39:51 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J9yCb-0004Ce-Od for emacs-devel@gnu.org; Wed, 02 Jan 2008 02:39:49 -0500 Original-Received: from sanpietro.red-bean.com ([66.146.193.61]) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1J9yCW-0006uh-R4; Wed, 02 Jan 2008 02:39:45 -0500 Original-Received: from localhost ([127.0.0.1]:42346) by sanpietro.red-bean.com with esmtp (Exim 4.68) (envelope-from ) id 1J9yCV-0007Pi-RC; Wed, 02 Jan 2008 01:39:43 -0600 In-Reply-To: <87wsqsu2o9.fsf@catnip.gol.com> (Miles Bader's message of "Wed\, 02 Jan 2008 16\:06\:30 +0900") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1.50 (gnu/linux) X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 3) 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:85861 Archived-At: Miles Bader writes: > Karl Fogel writes: >> Obviously, they represent separate CVS commits to doc-view.el, but on >> the same day, so Tassilo put them into the same ChangeLog entry. The >> result is counterintuitive, but I'm not sure what else he should do. >> Create a separate ChangeLog entry with the same date? Do we have a >> policy for how to handle this? > > Does it matter? Either seems clear enough, for a human reader, at > least. It's just confusing because there is an implicit one-to-one mapping between ChangeLog top-level entries and CVS commits. While I can discard this assumption if advised to, I'm pretty sure it's one many developers would share, especially those unfamiliar with Emacs's unusual ChangeLog policy (i.e., virtually every incoming developer). When I read Tassilo's entry, I hit that first mention of doc-view.el and assumed I'd seen everything Tassilo did to that file on that day. That caused me to spend a bit of time being confused, because I knew there should be more. Eventually I saw what I was looking for, later in the entry. Personally, I'm going to make a separate top-level entry in ChangeLog for each commit of mine. I don't know whether I'll bother to defactor Tassilo's entry, though ("mattress in the road" problem and all that). -Karl