From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: ChangeLog? Date: Fri, 04 Mar 2005 18:46:09 -0500 Message-ID: References: <61k6osjqsz.fsf@fencepost.gnu.org> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1109981203 15269 80.91.229.2 (5 Mar 2005 00:06:43 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 5 Mar 2005 00:06:43 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 05 01:06:43 2005 Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1D7MoO-0001XE-3d for ged-emacs-devel@m.gmane.org; Sat, 05 Mar 2005 01:06:28 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1D7N7e-0004IW-6N for ged-emacs-devel@m.gmane.org; Fri, 04 Mar 2005 19:26:22 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1D7N15-0008C6-Vk for emacs-devel@gnu.org; Fri, 04 Mar 2005 19:19:36 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1D7N14-0008BS-OY for emacs-devel@gnu.org; Fri, 04 Mar 2005 19:19:35 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1D7N0f-0007MB-O9 for emacs-devel@gnu.org; Fri, 04 Mar 2005 19:19:09 -0500 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1D7MUm-0006iB-Jh for emacs-devel@gnu.org; Fri, 04 Mar 2005 18:46:12 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1D7MUj-0002Qo-Ev; Fri, 04 Mar 2005 18:46:09 -0500 Original-To: bob@rattlesnake.com In-reply-to: (bob@rattlesnake.com) 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 X-MailScanner-To: ged-emacs-devel@m.gmane.org Xref: main.gmane.org gmane.emacs.devel:34191 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:34191 In Emacs, the approach we use is that all changes are listed in ChangeLog. Which ChangeLog? In the ChangeLog in the directory where you made the change; or, if there is none in that directory, in its parent directory. (emacs)Types of Log File the Emacs manual says When you use version control, you can use just the per-file log if you wish, or you can use both kinds of logs. ... It is describing several approaches that projects can use. Emacs uses the approach to list each ontrivial change both in ChangeLog and in the file's own CVS log. Shall I change the documentation as I suggested to: Please do not change it, and please let's stop discussing this. I will make a small change there: A project maintained with version control can use just the per-file log, or it can use both kinds of logs. It can handle some files one way and some files the other way. Each project has its policy, which you should follow. When the policy is to use both, you typically want to write just one entry for each change, and put the entry into both logs. You can write the entry in @file{ChangeLog}, then copy it to the log buffer when you check in the change. Or you can write the entry in the log buffer while checking in the change, and later use the @kbd{C-x v a} command to copy it to @file{ChangeLog} (@pxref{Change Logs and VC}).