[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Is it time to drop ChangeLogs?

From: Robert Weiner
Subject: Re: Is it time to drop ChangeLogs?
Date: Wed, 13 Jul 2016 09:12:16 -0400

On Wed, Jul 13, 2016 at 8:37 AM, Stefan Monnier
<address@hidden> 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.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]