Re: [gentoo-dev] Devmanual text on ChangeLogs

[Fabian Groffen]

On 30-04-2011 11:46:37 +0300, Petteri Räty wrote:
> http://devmanual.gentoo.org/ebuild-writing/misc-files/changelog/index.html
>
> There doesn't seem to be a common opinion on what the policy for
> ChangeLog entries is. See:
>
> http://archives.gentoo.org/gentoo-dev/msg_f829da2375f1ceab766a800913cc4998.xml
>
> I propose a simple new text: "Every commit should have an entry in
> ChangeLog." If we eventually autogenerate them from git logs this would
> happen any way (unless some kind of filtering system is in the middle)
> so we could already start now. I think it's better to have more than
> less information available to users.

Because everytime we need something more sophisticated people come up
with the holy git grail, here is the script to generate a
echangelog-style ChangeLog from CVS, right here, right now.

It's a naive implementation, but the output shows the differences
between the committed log, and what would be generated from CVS.  (The
usernames could be looked up easily, but I was too lazy to do that.)
People can use this to judge if "autogeneration from VCS" is a good
thing or not.

My conclusion is that you probably want to maintain the ChangeLog
manually.

I also attached a sample of the script output for net-p2p/transmission
for convenience.


-- 
Fabian Groffen
Gentoo on a different level