From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.bugs Subject: bug#19113: Generate a ChangeLog file from commit logs Date: Fri, 05 Dec 2014 03:07:07 -0500 Message-ID: <17zjb2h650.fsf@fencepost.gnu.org> References: <546D2E75.6090701@cs.ucla.edu> <837fyp7tvi.fsf@gnu.org> <546E2899.4050702@cs.ucla.edu> <54756754.5090103@cs.ucla.edu> <54762721.4060908@cs.ucla.edu> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1417766893 14854 80.91.229.3 (5 Dec 2014 08:08:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 5 Dec 2014 08:08:13 +0000 (UTC) Cc: 19113@debbugs.gnu.org To: Paul Eggert Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Dec 05 09:08:07 2014 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 1Xwnvr-0001xw-Dc for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Dec 2014 09:08:07 +0100 Original-Received: from localhost ([::1]:49200 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xwnvq-0001qW-VK for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Dec 2014 03:08:06 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56289) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xwnvn-0001qR-Ht for bug-gnu-emacs@gnu.org; Fri, 05 Dec 2014 03:08:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xwnvm-0006yi-Og for bug-gnu-emacs@gnu.org; Fri, 05 Dec 2014 03:08:03 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:57027) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xwnvm-0006yZ-Kz for bug-gnu-emacs@gnu.org; Fri, 05 Dec 2014 03:08:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Xwnvm-0001Vf-2m for bug-gnu-emacs@gnu.org; Fri, 05 Dec 2014 03:08:02 -0500 X-Loop: help-debbugs@gnu.org In-Reply-To: <546D2E75.6090701@cs.ucla.edu> Resent-From: Glenn Morris Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 05 Dec 2014 08:08:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19113 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 19113-submit@debbugs.gnu.org id=B19113.14177668325733 (code B ref 19113); Fri, 05 Dec 2014 08:08:01 +0000 Original-Received: (at 19113) by debbugs.gnu.org; 5 Dec 2014 08:07:12 +0000 Original-Received: from localhost ([127.0.0.1]:54240 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xwnuy-0001UP-9y for submit@debbugs.gnu.org; Fri, 05 Dec 2014 03:07:12 -0500 Original-Received: from fencepost.gnu.org ([208.118.235.10]:54402) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xwnuv-0001UE-0C for 19113@debbugs.gnu.org; Fri, 05 Dec 2014 03:07:09 -0500 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Xwnuu-0006AD-1k; Fri, 05 Dec 2014 03:07:08 -0500 X-Spook: Hamas 9/11 Ft. Knox hackers bluebird Mafia kilderkin X-Ran: OGDmQT}P{W]Td{=ZNc0~D"$Pr)>KH3UQnvg`JO3N(V6IJDI&,9r!ZjOrp}Me%w!fx!w*Q@ X-Hue: red X-Attribution: GM User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) 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:96881 Archived-At: I think this change will lower the quality of Emacs ChangeLogs, which are important forms of documentation; and frankly I don't even see that it will save much work. But I'm obviously in a minority, so don't let me stop you. I do have a list though; do whatever you like in response to it. 1) There are still things to deal with from the last big change, so I'd appreciate it if you not do this before January at the earliest. 2) Announce the change well in advance, and make it very clear what people need to do (ie, take much more care with their logs than before). Put a clear set of instructions in admin/notes. Eg how will I replace `C-x 4 a', `C-c C-a' now? (Frankly I expect to keep doing that, just not commit the ChangeLog, so as I said, I can't see that this will save any effort). I hope the answer isn't "install vc-dwim", since Emacs is supposed to contain all the necessary VC tools itself. 3) How will I mark a change so that it does not generate a ChangeLog? (Examples include: NEWS edits, comment fixes, fixing a paren typo in something I committed one second earlier.) Perhaps a "#" or somesuch in the first char of the log? How will I do this after committing if I forgot to so mark it at the time? 4) What if I commit something, realize it was wrong, and remove it right away? Normally I'd delete the ChangeLog entry too. 5) Will I be able to mark a portion of a log to be excluded from the generated ChangeLog? 6) How does the correction method work (I'm being lazy and not reading the patch). (Since notes are editable comments associated with commits, I like the idea of using notes to correct faulty logs.) Frankly, I expect there to be lots of mistakes, but whatever; I'm not going to bother to correct them anymore. 7) What dates will entries get? The commit date? This may not match the push date. What will happen with the dates of entries merged from other branches.