From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Robert Weiner Newsgroups: gmane.emacs.devel Subject: Re: Is it time to drop ChangeLogs? Date: Wed, 13 Jul 2016 09:12:16 -0400 Message-ID: References: <56BE7E37.3090708@cs.ucla.edu> <4hd1rw1ubr.fsf@fencepost.gnu.org> <83vb50wxhv.fsf@gnu.org> <87y49vz4cg.fsf@acer.localhost.com> <87twg2g86g.fsf@lifelogs.com> <87twg05nqf.fsf@russet.org.uk> Reply-To: rswgnu@gmail.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1468416903 26776 80.91.229.3 (13 Jul 2016 13:35:03 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 13 Jul 2016 13:35:03 +0000 (UTC) Cc: emacs-devel To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jul 13 15:34:48 2016 Return-path: Envelope-to: ged-emacs-devel@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 1bNKJL-000088-1L for ged-emacs-devel@m.gmane.org; Wed, 13 Jul 2016 15:34:47 +0200 Original-Received: from localhost ([::1]:47537 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bNKJF-0008Rt-4f for ged-emacs-devel@m.gmane.org; Wed, 13 Jul 2016 09:34:41 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49469) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bNJy8-00084M-PM for emacs-devel@gnu.org; Wed, 13 Jul 2016 09:12:53 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bNJy5-0008Vj-AQ for emacs-devel@gnu.org; Wed, 13 Jul 2016 09:12:52 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:54022) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bNJy5-0008Va-6U for emacs-devel@gnu.org; Wed, 13 Jul 2016 09:12:49 -0400 Original-Received: from mail-oi0-f47.google.com ([209.85.218.47]:36108) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1bNJy2-0005Aw-Sx for emacs-devel@gnu.org; Wed, 13 Jul 2016 09:12:47 -0400 Original-Received: by mail-oi0-f47.google.com with SMTP id w18so69031342oiw.3 for ; Wed, 13 Jul 2016 06:12:46 -0700 (PDT) X-Gm-Message-State: ALyK8tKPMd4wj6mXq+kUQ0Cu6Z8Sb9dYjuMXDB7K20PNIN7sXHYUl3zIjOV/kDTvOlk1p7MIHGr0AOg4K9EJBw== X-Received: by 10.202.173.212 with SMTP id w203mr1349045oie.119.1468415566152; Wed, 13 Jul 2016 06:12:46 -0700 (PDT) Original-Received: by 10.202.199.143 with HTTP; Wed, 13 Jul 2016 06:12:16 -0700 (PDT) In-Reply-To: X-Gmail-Original-Message-ID: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:205620 Archived-At: On Wed, Jul 13, 2016 at 8:37 AM, Stefan Monnier wrote: > "git log" gives pretty much the same info as the ChangeLog. Hi Stefan: This seems very hard to believe, as a ChangeLog should include comments about the rationale for changes and should separate out each change. If I make 3 functional changes in one commit which I think would be common in many projects, each change across multiple files, the ChangeLog reflects 3 separate changes and can point out the files and identifiers involved in each change. How can an automated system do this (it would have to understand the semantics of the code)? Here is a short excerpt from Hyperbole's ChangeLog as an example. Can you show a git log example with similar functionality? * hypb.el (hypb:maximize-window-height): Added. hib-debbugs.el (debbugs-gnu-mode, smart-debbugs-gnu, debbugs-gnu-mode:help): Added to support the Smart Keys in Gnu Debbugs listing buffers. * hversion.el (id-info, id-info-item): Generalized and improved file handling. * hypb.el (hypb:format-quote): Added. hmouse-drv.el (hkey-debug): Called above function to protect existing % fields in ButLabel and Actions from affecting the message call. * DEMO (Hyperbole Menus): Updated with these new menu control features. hui-mouse.el (hkey-alist): Same changes for Smart Mouse Key as below in hui-mini.el. hui-mini.el (hui:menu-select): Changed to make a press of RET within a menu prefix (before a '>') return to the top-level menu and a press at the end of the menu, quit the menu. Bob