[bind10-dev] (re) NEWS vs. ChangeLog

[JINMEI Tatuya / 神明達哉]

At Mon, 28 Jan 2013 13:11:25 -0600 (CST),
"Jeremy C. Reed" <jreed at isc.org> wrote:

> The ticket and work for trac2660 are not for the initial problem.
> 
> The initial problem was that the existing changelog was inconsistent and 
> somewhat undefined. (For example, entries about DHCP "options" did not 
> mention "DCHP". Also some entries vaguely mention about API changes 
> while other entries specifically name the functions or classes that had 
> usage changes.)
> 
> That discussion brought up on the phone call that our normal usage of 
> ChangeLog is normally done using NEWS file (per common GNU or 
> autoconf/automake-based projects).  On the call, I also mentioned 
> briefly about X.org's way for doing the changelog.  So I made a ticket 
> for those two ideas.

Okay, then my next question is what's the purpose of the new form of
ChangeLog (which is, from a quick look at the branch, basically a copy
of "git log" output)?  Such raw data are generally quite unreadable,
less organized, full of unrelated noise, and therefore useless for
anybody:  For a developer-type of user, if that person is interested
in that level of information, it's quite likely he/she has a clone of
the repository and can retrieve that information by typing git log
(or, more likely, using a more sophisticated tool to browse the
history); for other ordinary users, it'd be just strange, large,
"encrypted" file.

So I simply don't see the point of including it in the tar ball in the
first place.

---
JINMEI, Tatuya