1 |
On 30-04-2011 11:46:37 +0300, Petteri Räty wrote: |
2 |
> http://devmanual.gentoo.org/ebuild-writing/misc-files/changelog/index.html |
3 |
> |
4 |
> There doesn't seem to be a common opinion on what the policy for |
5 |
> ChangeLog entries is. See: |
6 |
> |
7 |
> http://archives.gentoo.org/gentoo-dev/msg_f829da2375f1ceab766a800913cc4998.xml |
8 |
> |
9 |
> I propose a simple new text: "Every commit should have an entry in |
10 |
> ChangeLog." If we eventually autogenerate them from git logs this would |
11 |
> happen any way (unless some kind of filtering system is in the middle) |
12 |
> so we could already start now. I think it's better to have more than |
13 |
> less information available to users. |
14 |
|
15 |
Because everytime we need something more sophisticated people come up |
16 |
with the holy git grail, here is the script to generate a |
17 |
echangelog-style ChangeLog from CVS, right here, right now. |
18 |
|
19 |
It's a naive implementation, but the output shows the differences |
20 |
between the committed log, and what would be generated from CVS. (The |
21 |
usernames could be looked up easily, but I was too lazy to do that.) |
22 |
People can use this to judge if "autogeneration from VCS" is a good |
23 |
thing or not. |
24 |
|
25 |
My conclusion is that you probably want to maintain the ChangeLog |
26 |
manually. |
27 |
|
28 |
I also attached a sample of the script output for net-p2p/transmission |
29 |
for convenience. |
30 |
|
31 |
|
32 |
-- |
33 |
Fabian Groffen |
34 |
Gentoo on a different level |