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] Script to generate ChangeLog-like output


On 19/12/2018 10:10, Siddhesh Poyarekar wrote:
> The script below is the result of these discussions.  This script
> takes two git revisions references as input and generates the git log
> between those revisions in a form that resembles a ChangeLog.  Its
> capabilities and limitations are listed in a comment in the script.
> On a high level it is capable of parsing C code and telling what
> changed at the top level, but not within constructs such as functions.

thanks, this looks useful.

> For input other than C, the script only identifies if a file has been
> added, removed, modified, permissions changed, etc. but cannot
> understand the change in content.  The design of the script however is
> pluggable, so it should be possible to develop additional parsers to
> process other types of files.

handling Versions file would be useful.
(and Makefile too, but that's harder)

> I have tested it with a number of commits in the glibc log and also
> fixed a couple of errors that were reported earlier.

other things i noticed:

if a commit has multiple authors currently that's only
tracked in the changelog, so there needs to be a way to
somehow specify multiple authors in git commits to
correctly generate the changelog.

if something is changed under an #if conditional, that
condition may be more than 80 chars, but currently the
script prints it on a single line.

if a function is renamed it says it's removed and a new
function is added with the new name.

it cannot tell if a file is rewritten from scratch and
then it may generate a large changelog instead of just
saying "Rewritten".

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