This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH 1/1 V2] manual/time.texi: correct the zoneinfo path


On Fri, 13 Feb 2015, Carlos O'Donell wrote:

> I will instead take this time to look over again how to do ChangeLog
> auto-generation from commit meta-data, to solve this problem more easily.

I advise looking at the gnulib gitlog-to-changelog script for that 
purpose.  Things to consider include the handling of commits with multiple 
authors for the ChangeLog entry, handling post-commit corrections 
(including to authors and dates), choice of date for the generated 
ChangeLog entries (commit date is probably better than author date, people 
rebasing sometimes end up pushing changes where the author date is months 
ago), handling the separate ChangeLogs still used for libidn and 
localedata, and distinguishing the long description of the rationale for a 
change (which should be included in the commit message, not just the 
summary line and ChangeLog entry) from the description of what changed 
that goes in the ChangeLog entry.

I'm not sure how much of that gitlog-to-changelog handles, but it seems a 
reasonable starting point.  And we could always consider such things as 
stopping using the remaining subdirectory ChangeLogs, or putting the full 
rationale in the generated ChangeLog rather than just the description of 
what changed, if desired.

(I suppose "make dist" could no longer use git archive unless the release 
process involves committing the generated ChangeLog before tagging / 
branching / releasing.)

-- 
Joseph S. Myers
joseph@codesourcery.com


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]