FAQ Search Today's Posts Mark Forums Read
» Video Reviews

» Linux Archive

Linux-archive is a website aiming to archive linux email lists and to make them easily accessible for linux users/developers.


» Sponsor

» Partners

» Sponsor

Go Back   Linux Archive > Gentoo > Gentoo Development

 
 
LinkBack Thread Tools
 
Old 04-30-2011, 08:46 AM
Petteri Räty
 
Default Devmanual text on ChangeLogs

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
 
Old 04-30-2011, 09:02 AM
Samuli Suominen
 
Default Devmanual text on ChangeLogs

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.
 
Old 04-30-2011, 09:07 AM
Ulrich Mueller
 
Default Devmanual text on ChangeLogs

>>>>> On Sat, 30 Apr 2011, Petteri Räty wrote:

> I propose a simple new text: "Every commit should have an entry in
> ChangeLog."

This would throw the baby out with the bath water.

I won't clutter ChangeLogs with useless entries for whitespace changes
or spelling fixes in comments, for example. They already account for a
considerable (too large?) percentage of the portage tree [1], and we
shouldn't blow them up further by adding useless information.

Ulrich

[1] http://blog.flameeyes.eu/2009/09/28/the-size-of-the-gentoo-tree
(this is from 2009, so probably it's even worse now)
 

Thread Tools




All times are GMT. The time now is 04:52 PM.

VBulletin, Copyright ©2000 - 2014, Jelsoft Enterprises Ltd.
Content Relevant URLs by vBSEO ©2007, Crawlability, Inc.
Copyright ©2007 - 2008, www.linux-archive.org