Re: [gentoo-dev] Devmanual text on ChangeLogs

[Alex Alexander]

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