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: Thu, 16 Apr 2015 17:54:21 +0300 Message-ID: <552FCD1D.7020904@yandex.ru> References: <91a8ybmdkq.fsf@fencepost.gnu.org> <552DA224.6020801@yandex.ru> 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 1429196123 11635 80.91.229.3 (16 Apr 2015 14:55:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 16 Apr 2015 14:55:23 +0000 (UTC) Cc: 20328@debbugs.gnu.org To: Glenn Morris Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 16 16:55:14 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 1YilCD-0001Ac-QV for geb-bug-gnu-emacs@m.gmane.org; Thu, 16 Apr 2015 16:55:13 +0200 Original-Received: from localhost ([::1]:37218 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YilCC-0001MH-LK for geb-bug-gnu-emacs@m.gmane.org; Thu, 16 Apr 2015 10:55:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59535) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YilC8-0001Kf-Bw for bug-gnu-emacs@gnu.org; Thu, 16 Apr 2015 10:55:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YilC3-0002lC-9R for bug-gnu-emacs@gnu.org; Thu, 16 Apr 2015 10:55:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:40189) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YilC3-0002kx-5j for bug-gnu-emacs@gnu.org; Thu, 16 Apr 2015 10:55:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YilC2-0002x7-Gl for bug-gnu-emacs@gnu.org; Thu, 16 Apr 2015 10:55: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: Thu, 16 Apr 2015 14:55: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.142919607211300 (code B ref 20328); Thu, 16 Apr 2015 14:55:02 +0000 Original-Received: (at 20328) by debbugs.gnu.org; 16 Apr 2015 14:54:32 +0000 Original-Received: from localhost ([127.0.0.1]:58198 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YilBY-0002wB-5I for submit@debbugs.gnu.org; Thu, 16 Apr 2015 10:54:32 -0400 Original-Received: from mail-wi0-f179.google.com ([209.85.212.179]:33879) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YilBV-0002vu-TW for 20328@debbugs.gnu.org; Thu, 16 Apr 2015 10:54:30 -0400 Original-Received: by widjs5 with SMTP id js5so13584248wid.1 for <20328@debbugs.gnu.org>; Thu, 16 Apr 2015 07:54:24 -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:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=6X+7cNAClmB52aJXi9joSoTyxOH4wYMihLqtZkRPnWc=; b=vqu0MDFsKkN4fk7gfamr03XBEVIKllHI4XsDxVbzGMKycEclvveN2M+vQYLjHTZjpG rW8NFntX/KMjp7aTzn4p1TQSFs3OnpXtcr6TI9lBtqFr5AeD1yn2+t6IT8EylwmL5xO5 jzALnlzHDi5v+3ve0HYfslQdp9D4lsWbqoSKuboSd6dzpdMTIs2vq7RbzPzo33VlLUFD bsSq3cLEzNd6CO+YydZ4YDu7fDocEzDp72JCxSFFlTo0yLclK91ajTE1g7H219mDIixY 4ArGtywY/tk53Pg35hOTC9kvJLvAXLYd+rlmnsbBIkefxH7npElpWrV0WhpHUP6Hh4zl wBYg== X-Received: by 10.194.95.4 with SMTP id dg4mr59629266wjb.81.1429196064123; Thu, 16 Apr 2015 07:54:24 -0700 (PDT) Original-Received: from [192.168.1.2] ([82.102.93.54]) by mx.google.com with ESMTPSA id eu3sm10739996wjb.16.2015.04.16.07.54.23 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 16 Apr 2015 07:54:23 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:36.0) Gecko/20100101 Thunderbird/36.0 In-Reply-To: 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:101587 Archived-At: On 04/15/2015 07:52 PM, Glenn Morris wrote: > IMO the file should be rewritten to explain that commit logs are to be > written in the style of ChangeLogs. Updated, please take a look. >> 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. > > s/could/should. I'd prefer not to touch this part until the following is resolved. > I guess we are supposed to use those silly "action stamps", but > understandably no-one does. I'm sure people are going to keep using > hashes in commit logs, which will be meaningless in the generated C'log. Agreed: it's a nuisance. And since it relatively trivial to convert commit hashes to the action stamps or whatever when generating ChangeLogs, it makes sense to use hashes in the commit messages. Maybe prefixed with "git:", if someone is worried about ambiguity. > If they are in a commit all of their own, you can use the "; " prefix to > omit that entire commit log entry from the generated C'log. I think it's also improved now.