Re: ChangeLog suggestion

Zack Brown (zbrown@tumblerings.org)
Sat, 26 Apr 2003 10:07:36 -0700


Hi Linus,

On Sat, Apr 26, 2003 at 09:34:25AM -0700, Linus Torvalds wrote:
>
> On Sat, 26 Apr 2003, John Bradford wrote:
> >
> > The changelogs are generated by BitKeeper - couldn't we simply include
> > a link that will let anybody[1] access the relevant changesets?
>
> Well, yes, the changelogs are generated by BitKeeper, but what gets fed
> into bitkeeper is controlled by some scripts I wrote, which are the ones
> that take the email and munge it into a readable format etc. So by the
> time the thing hits my BK repository, the email headers will all have been
> thrown away, except for "From: " and "Subject: ". So BK never sees the
> full email.
>
> (Even my scripts don't see the full email a large percentage of the time:
> I end up prettifying the emails for actual application by first removing
> things like "Hi Linus, please apply this" etc which are pointless in the
> changelog).

I think John's idea was that the email is not really important, as long as
the diffs themselves could be made available via URLs. That sounds good. I
only asked for the Message-ID because it didn't occur to me there might be
a straighter path to the diff.

I'm trying to deal with cases where the only changelog comment is
something like:

"kbuild: Hand merge link order change form driverfs update."

I know who did it. I know when it was accepted into the tree. I can spend
awhile grepping megabytes of lmkl archives (and come up empty, in this case),
but after that I have to give up. The patch is pretty much simply unavailable
at that point.

A URL to the diff itself would make it trivial to delve deeper into the
meaning behind changelog entries. Currently, investigating each entry just
takes way too much time, and often leads nowhere. If you can automate it
easily at your end, it would make a big difference to anyone studying
kernel development.

Be well,
Zack

>
> Linus
>

-- 
Zack Brown
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/