On Sat, Apr 30, 2011 at 02:42:08PM +0100, Markos Chandras wrote: > On Sat, Apr 30, 2011 at 12:02:35PM +0300, Samuli Suominen wrote: > > On 04/30/2011 11:46 AM, 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. > > > > > > Regards, > > > Petteri > > > > > > > "Every new file, and modification to existing file should have an entry > > in ChangeLog." to skip the proper ChangeLog-less removals. > > > I am actually with Samuli on this. Unless there is a particular reason > for removing a package, I don't see any point of documenting this change anywhere. > What difference would it make to you if you see an entry " -foo-1.0 > old". It makes absolutely no sense. There are times when you need to know where a version went. That alone is enough to warrant updating the ChangeLog. Having to check a second place through a slow interface sucks :) -- Alex Alexander | wired + Gentoo Linux Developer ++ www.linuxized.com