bug-standards
[Top][All Lists]
Advanced

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

Re: Circumstances in which ChangeLog format is no longer useful


From: Joseph Myers
Subject: Re: Circumstances in which ChangeLog format is no longer useful
Date: Fri, 4 Aug 2017 21:13:56 +0000
User-agent: Alpine 2.20 (DEB 67 2015-01-07)

On Fri, 4 Aug 2017, Alfred M. Szmidt wrote:

> They cannot be generated by a computer.  Your remainder points do not
> address how ChangeLog entries are a bad thing, rather they show that

They are a bad thing because they force writing a description of a 
changeset at a per-file, per-named-entity level, whether or not a 
decomposition into those pieces is a good way to describe that particular 
changeset, and because they force writing such a description that 
concentrates on information that can readily be obtained by reading the 
associated patch, which is the exact opposite of what a good commit 
message should be concentrating on, namely information at the logical 
level about the change as a whole and the reasons for it, that complements 
the change itself, so helping the reader in understanding the patch in its 
proper context, rather than duplicating it.

-- 
Joseph S. Myers
address@hidden



reply via email to

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