[gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Chris Gianelloni]

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

Most of the profiles under default-linux have a ChangeLog at the
architecture level.  If you make *any* changes to a profile, you should
be putting your changes in the ChangeLog.

For example, if you edit
profiles/default-linux/amd64/2006.1/no-multilib/package.mask, then you
need to add an entry at profiles/default-linux/amd64/ChangeLog.  You can
use echangelog, which works perfectly fine.  Being unable to easily
track changes in profiles makes Release Engineering (and arch teams)
cry, so please add a ChangeLog entry, or we'll sick Jeff and the goats
on you.

Thanks,

-- 
Chris Gianelloni
Release Engineering Strategic Lead
Alpha/AMD64/x86 Architecture Teams
Games Developer/Council Member/Foundation Trustee
Gentoo Foundation

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Robin H. Johnson]

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

On Mon, Jan 08, 2007 at 08:27:50AM -0500, Chris Gianelloni wrote:
> Most of the profiles under default-linux have a ChangeLog at the
> architecture level.  If you make *any* changes to a profile, you should
> be putting your changes in the ChangeLog.
Just wondering, any objections if we add ChangeLogs at the rest of the
levels in profiles? Would esp. be useful for some of the more global
changes.

-- 
Robin Hugh Johnson
Gentoo Linux Developer
E-Mail     : robbat2@gentoo.org
GnuPG FP   : 11AC BA4F 4778 E3F6 E4ED  F38E B27B 944E 3488 4E85

[-- Attachment #2: Type: application/pgp-signature, Size: 240 bytes --]

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Chris Gianelloni]

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

On Mon, 2007-01-08 at 12:20 -0800, Robin H. Johnson wrote:
> On Mon, Jan 08, 2007 at 08:27:50AM -0500, Chris Gianelloni wrote:
> > Most of the profiles under default-linux have a ChangeLog at the
> > architecture level.  If you make *any* changes to a profile, you should
> > be putting your changes in the ChangeLog.

> Just wondering, any objections if we add ChangeLogs at the rest of the
> levels in profiles? Would esp. be useful for some of the more global
> changes.

Not really.

Personally, I'd prefer there not be ChangeLogs any deeper on
default-linux than $arch, so adding one to, say, default-linux would be
good, adding one to default-linux/x86/2006.1 would be rather pointless.
I could definitely see the use of having one on base and default-linux,
for sure.  I'll leave it up to other projects (hardened/embedded/etc) if
they would want to follow suit, but it definitely makes Release
Engineering work much easier having it.

-- 
Chris Gianelloni
Release Engineering Strategic Lead
Alpha/AMD64/x86 Architecture Teams
Games Developer/Council Member/Foundation Trustee
Gentoo Foundation

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Chris Gianelloni]

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

On Mon, 2007-01-08 at 17:40 -0500, Chris Gianelloni wrote:
> On Mon, 2007-01-08 at 12:20 -0800, Robin H. Johnson wrote:
> > Just wondering, any objections if we add ChangeLogs at the rest of the
> > levels in profiles? Would esp. be useful for some of the more global
> > changes.
> 
> Not really.

This should have been read as "No objections here", if it wasn't clear
before.

-- 
Chris Gianelloni
Release Engineering Strategic Lead
Alpha/AMD64/x86 Architecture Teams
Games Developer/Council Member/Foundation Trustee
Gentoo Foundation

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Ned Ludd]

On Mon, 2007-01-08 at 17:40 -0500, Chris Gianelloni wrote:
> On Mon, 2007-01-08 at 12:20 -0800, Robin H. Johnson wrote:
> > On Mon, Jan 08, 2007 at 08:27:50AM -0500, Chris Gianelloni wrote:
> > > Most of the profiles under default-linux have a ChangeLog at the
> > > architecture level.  If you make *any* changes to a profile, you should
> > > be putting your changes in the ChangeLog.
> 
> > Just wondering, any objections if we add ChangeLogs at the rest of the
> > levels in profiles? Would esp. be useful for some of the more global
> > changes.
> 
> Not really.
> 
> Personally, I'd prefer there not be ChangeLogs any deeper on
> default-linux than $arch, so adding one to, say, default-linux would be
> good, adding one to default-linux/x86/2006.1 would be rather pointless.
> I could definitely see the use of having one on base and default-linux,
> for sure. 



>  I'll leave it up to other projects (hardened/embedded/etc) if
> they would want to follow suit, but it definitely makes Release
> Engineering work much easier having it.

No objections. TBH we don't really have to edit those profiles often. 
We/I try to keep them as static as possible. When they do change it's 
usually cuz somebody has some brilliant idea for some non linux which 
forces all other profiles to update to mask or unmask some use flag. 
We/I tend to request that they update it themselves.

But note taken. If I have to edit something I'll try to remember to 
add a ChangeLog entry.


-- 
Ned Ludd <solar@gentoo.org>
Gentoo Linux

-- 
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Diego 'Flameeyes' Pettenò]

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

On Tuesday 09 January 2007 00:43, Ned Ludd wrote:
> We/I try to keep them as static as possible. When they do change it's
> usually cuz somebody has some brilliant idea for some non linux which
> forces all other profiles to update to mask or unmask some use flag.
Actually lately I've just cleaned up after PHP :P

-- 
Diego "Flameeyes" Pettenò - http://farragut.flameeyes.is-a-geek.org/
Gentoo/Alt lead, Gentoo/FreeBSD, Video, Sound, ALSA, PAM, KDE, CJK, Ruby ...

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Robin H. Johnson]

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

On Mon, Jan 08, 2007 at 03:43:31PM -0800, Ned Ludd wrote:
> No objections. TBH we don't really have to edit those profiles often. 
> We/I try to keep them as static as possible. When they do change it's 
> usually cuz somebody has some brilliant idea for some non linux which 
> forces all other profiles to update to mask or unmask some use flag. 
> We/I tend to request that they update it themselves.
> 
> But note taken. If I have to edit something I'll try to remember to 
> add a ChangeLog entry.
I was referring to all of profiles/ in general.

It came to me because antarus was looking for vapier to see why
profiles/lang.desc existed.

I'm thinking that keeping track of the very top level stuff like
thirdpartymirrors, use{,.local}.desc, updates/, desc/ would benefit from
ChangeLogs, for people that have them from rsync, instead of CVS.

-- 
Robin Hugh Johnson
Gentoo Linux Developer
E-Mail     : robbat2@gentoo.org
GnuPG FP   : 11AC BA4F 4778 E3F6 E4ED  F38E B27B 944E 3488 4E85

[-- Attachment #2: Type: application/pgp-signature, Size: 240 bytes --]

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Luca Barbato]

Robin H. Johnson wrote:
> On Mon, Jan 08, 2007 at 08:27:50AM -0500, Chris Gianelloni wrote:
>> Most of the profiles under default-linux have a ChangeLog at the
>> architecture level.  If you make *any* changes to a profile, you should
>> be putting your changes in the ChangeLog.
> Just wondering, any objections if we add ChangeLogs at the rest of the
> levels in profiles? Would esp. be useful for some of the more global
> changes.
> 

Cough... Looks like one of the people at fault is me rationalizing kqemu 
usage... ^^

Could be possible autogenerate the changelog out of commitlog and/or 
have a precommit hook checking and warn if you don't change the correct 
changelog?

lu

-- 

Luca Barbato

Gentoo/linux Gentoo/PPC
http://dev.gentoo.org/~lu_zero

-- 
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Mike Doty]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Luca Barbato wrote:
> Robin H. Johnson wrote:
>> On Mon, Jan 08, 2007 at 08:27:50AM -0500, Chris Gianelloni wrote:
>>> Most of the profiles under default-linux have a ChangeLog at the
>>> architecture level.  If you make *any* changes to a profile, you should
>>> be putting your changes in the ChangeLog.
>> Just wondering, any objections if we add ChangeLogs at the rest of the
>> levels in profiles? Would esp. be useful for some of the more global
>> changes.
>>
> 
> Cough... Looks like one of the people at fault is me rationalizing kqemu
> usage... ^^
> 
> Could be possible autogenerate the changelog out of commitlog and/or
> have a precommit hook checking and warn if you don't change the correct
> changelog?
> 
> lu
> 
take it a step further, what about a repoman like tool to make sure one
doesn't bork all the profiles when changing something.

QA: this seems like your field, how about it?

- --
=======================================================
Mike Doty                      kingtaco -at- gentoo.org
Gentoo/AMD64 Strategic Lead
Gentoo Council
Gentoo Developer Relations
Gentoo Recruitment Lead
Gentoo Infrastructure
GPG: E1A5 1C9C 93FE F430 C1D6  F2AF 806B A2E4 19F4 AE05
=======================================================
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (GNU/Linux)

iQCVAwUBRaMiGoBrouQZ9K4FAQJ5BwQAyKg+Bsz6m8aBOK16iZS3EYaMgX3FjI3i
dR4TEXpqBGKIRxzLsEtOQ0iRVGf5aE8hjxTPY4eUzKdeSBFQEXYmW6p4NkP3zjhU
ZjUE8hJvxyDmGVRnd2HI+057Y7ho7okwsnymQDeqd/DtOhr3Yw2fc+nULn2iPZ9L
4FuXOEx6MOQ=
=cBa4
-----END PGP SIGNATURE-----
-- 
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] Gentle reminder about ChangeLog entries on profiles

[Chris Gianelloni]

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

On Mon, 2007-01-08 at 15:52 -0800, Robin H. Johnson wrote:
> I was referring to all of profiles/ in general.
> 
> It came to me because antarus was looking for vapier to see why
> profiles/lang.desc existed.
> 
> I'm thinking that keeping track of the very top level stuff like
> thirdpartymirrors, use{,.local}.desc, updates/, desc/ would benefit from
> ChangeLogs, for people that have them from rsync, instead of CVS.

Well, I've added a ChangeLog to profiles... If there's any objections
from anyone, they can feel free to remove it, or something.

-- 
Chris Gianelloni
Release Engineering Strategic Lead
Alpha/AMD64/x86 Architecture Teams
Games Developer/Council Member/Foundation Trustee
Gentoo Foundation

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]