public inbox for gentoo-dev@lists.gentoo.org
 help / color / mirror / Atom feed
Search results ordered by [date|relevance]  view[summary|nested|Atom feed]
thread overview below | download: 
* Re: [gentoo-dev] Devmanual text on ChangeLogs
  @ 2011-04-30 13:42 99%   ` Markos Chandras
  0 siblings, 0 replies; 1+ results
From: Markos Chandras @ 2011-04-30 13:42 UTC (permalink / raw
  To: gentoo-dev

[-- Attachment #1: Type: text/plain, Size: 1262 bytes --]

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.

Regards,
-- 
Markos Chandras / Gentoo Linux Developer / Key ID: B4AFF2C2

[-- 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 99%   ` Markos Chandras

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox