From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#20328: outdated CONTRIBUTE info re ChangeLogs Date: Wed, 15 Apr 2015 02:26:28 +0300 Message-ID: <552DA224.6020801@yandex.ru> References: <91a8ybmdkq.fsf@fencepost.gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1429054046 29343 80.91.229.3 (14 Apr 2015 23:27:26 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 14 Apr 2015 23:27:26 +0000 (UTC) To: Glenn Morris , 20328@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Apr 15 01:27:11 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1YiAEY-0005Uo-H2 for geb-bug-gnu-emacs@m.gmane.org; Wed, 15 Apr 2015 01:27:10 +0200 Original-Received: from localhost ([::1]:58187 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YiAEX-0003nN-Oj for geb-bug-gnu-emacs@m.gmane.org; Tue, 14 Apr 2015 19:27:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38993) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YiAET-0003nD-UO for bug-gnu-emacs@gnu.org; Tue, 14 Apr 2015 19:27:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YiAEQ-0002bs-No for bug-gnu-emacs@gnu.org; Tue, 14 Apr 2015 19:27:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:38501) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YiAEQ-0002bj-Ke for bug-gnu-emacs@gnu.org; Tue, 14 Apr 2015 19:27:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YiAEQ-0000i0-4T for bug-gnu-emacs@gnu.org; Tue, 14 Apr 2015 19:27:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 14 Apr 2015 23:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20328 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 20328-submit@debbugs.gnu.org id=B20328.14290540032701 (code B ref 20328); Tue, 14 Apr 2015 23:27:02 +0000 Original-Received: (at 20328) by debbugs.gnu.org; 14 Apr 2015 23:26:43 +0000 Original-Received: from localhost ([127.0.0.1]:56510 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YiAE6-0000hU-Uz for submit@debbugs.gnu.org; Tue, 14 Apr 2015 19:26:43 -0400 Original-Received: from mail-wg0-f44.google.com ([74.125.82.44]:35160) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YiAE4-0000hG-9J for 20328@debbugs.gnu.org; Tue, 14 Apr 2015 19:26:40 -0400 Original-Received: by wgyo15 with SMTP id o15so28909014wgy.2 for <20328@debbugs.gnu.org>; Tue, 14 Apr 2015 16:26:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:message-id:date:from:user-agent:mime-version:to:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=fWh+YYULrlbOtBVOtEiBen9BJqSlkEQNbxgXI0cveT4=; b=DV2lug9Y87oau3v/TOZeQPtwwxSOyxroDLVpOTOK1+OH8hlHdQnI9qAHH36ZWSxBQj 4xEREBR1PTN1F6p6AYr6ZIsaOTgaYozu6OdT3ZQR5IdI0ZGBfnRBEIFX7jEhjKRrJkMo VtXTzEDVL3xTcFlrqBuINX57Ea8xKPxYnCEfq7O78WIBezqh0OHPcnDO0KNWTY6FHp2S PvVaWnh7V4x7s2CzrVIjcfgihK5xGrr6nEWukBXI45z92KRWaSEzfsrOX88W90rra6Xq PBkCMS0w2kUKYws4tWa/RurmWavo9l6nbndePblyi6lKIrglgs4iEU19q6fme7lsOwzr hz6g== X-Received: by 10.180.104.131 with SMTP id ge3mr22615021wib.12.1429053994425; Tue, 14 Apr 2015 16:26:34 -0700 (PDT) Original-Received: from [192.168.1.2] ([82.102.93.54]) by mx.google.com with ESMTPSA id it5sm19168297wid.3.2015.04.14.16.26.30 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 14 Apr 2015 16:26:33 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:36.0) Gecko/20100101 Thunderbird/36.0 In-Reply-To: <91a8ybmdkq.fsf@fencepost.gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:101540 Archived-At: On 04/14/2015 09:25 AM, Glenn Morris wrote: > CONTRIBUTE contains outdated information re ChangeLogs. > Someone should review it and update it. I don't know if they're all actually incorrect. Based on an non-obvious distinction - yes. Since a commit message contains a summary, maybe a few headers, and a ChangeLog entry, it's fair to describe what a "ChangeLog entry" should contain. > Random hits (almost every instance related to "ChangeLog" seems wrong to me): > > If committing changes written by someone else, make the ChangeLog > entry in their name, not yours. Right, there's no separate name line in the ChangeLog entries inside commit messages. Updated. > [...] > It is tempting to relax this rule for commit messages, since they > are somewhat transient. This one actually seemed outdated. Removed. > [...] > In ChangeLog entries, there is no standard or recommended way to > identify revisions. This still applies. Even though it could say "in commit messages", this also emphasized the fact that the same non-sandardized references will appear in the ChangeLog file. > [...] > There is no need to make separate ChangeLog entries for files such > as NEWS, MAINTAINERS... Still true, and I'm not sure how to rephrase this to refer to commit messages.