* Re: [gentoo-dev] Devmanual text on ChangeLogs
@ 2011-04-30 18:16 99% ` Alex Alexander
0 siblings, 0 replies; 1+ results
From: Alex Alexander @ 2011-04-30 18:16 UTC (permalink / raw
To: gentoo-dev
[-- Attachment #1: Type: text/plain, Size: 1569 bytes --]
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
[-- Attachment #2: Type: application/pgp-signature, Size: 836 bytes --]
^ permalink raw reply [relevance 99%]
Results 1-1 of 1 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2011-04-30 8:46 [gentoo-dev] Devmanual text on ChangeLogs Petteri Räty
2011-04-30 9:02 ` Samuli Suominen
2011-04-30 13:42 ` Markos Chandras
2011-04-30 18:16 99% ` Alex Alexander
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox