[gentoo-dev] Old changelogs / eclass dir

[gentoo-dev] Old changelogs / eclass dir

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 717 bytes --]

Dear all, 

two small suggestions regarding ChangeLogs:

1) Why is there no ChangeLog in the eclass directory? 
In my personal opinion this is missing there, if only for historical reasons... Should we still start one?

2) I'd like to suggest that for changelogs that grow beyond a certain size (e.g. profiles/ChangeLog) 
the file is "rotated" similar to /var/log logfiles. I.e. the current file is renamed with a date extension and a 
new file is started. This has the benefit that the archived file is static and will never be retransmitted 
by rsync.

Opinions?

Cheers, Andreas

-- 
Andreas K. Huettel
Gentoo Linux developer - kde, sci, arm, tex
dilfridge@gentoo.org
http://www.akhuettel.de/

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

Re: [gentoo-dev] Old changelogs / eclass dir

[Kent Fredric]

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

On 27 October 2011 06:46, Andreas K. Huettel <dilfridge@gentoo.org> wrote:

>
> 2) I'd like to suggest that for changelogs that grow beyond a certain size
> (e.g. profiles/ChangeLog)
> the file is "rotated" similar to /var/log logfiles. I.e. the current file
> is renamed with a date extension and a
> new file is started. This has the benefit that the archived file is static
> and will never be retransmitted
> by rsync.
>

For rotation, an arbitrary line-length offset would not be advisable in my
opinion. It would need to split at a logical place like before a "release"
entry.

As for codifying this, applying software to automate splitting changelogs in
this manner could be initially challenging as I've seen a few Changelogs
with really inconsistent style at the bottom of them.

-- 
Kent

perl -e  "print substr( \"edrgmaM  SPA NOcomil.ic\\@tfrken\", \$_ * 3, 3 )
for ( 9,8,0,7,1,6,5,4,3,2 );"

http://kent-fredric.fox.geek.nz

[-- Attachment #2: Type: text/html, Size: 1336 bytes --]

Re: [gentoo-dev] Old changelogs / eclass dir

[Michał Górny]

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

On Thu, 27 Oct 2011 07:00:36 +1300
Kent Fredric <kentfredric@gmail.com> wrote:

> On 27 October 2011 06:46, Andreas K. Huettel <dilfridge@gentoo.org>
> wrote:
> 
> >
> > 2) I'd like to suggest that for changelogs that grow beyond a
> > certain size (e.g. profiles/ChangeLog)
> > the file is "rotated" similar to /var/log logfiles. I.e. the
> > current file is renamed with a date extension and a
> > new file is started. This has the benefit that the archived file is
> > static and will never be retransmitted
> > by rsync.
> >
> 
> For rotation, an arbitrary line-length offset would not be advisable
> in my opinion. It would need to split at a logical place like before
> a "release" entry.
> 
> As for codifying this, applying software to automate splitting
> changelogs in this manner could be initially challenging as I've seen
> a few Changelogs with really inconsistent style at the bottom of them.

How many really long changelogs do we have now? Maybe we should just
split them by hand.

-- 
Best regards,
Michał Górny

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 316 bytes --]

Re: [gentoo-dev] Old changelogs / eclass dir

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 3780 bytes --]

> > As for codifying this, applying software to automate splitting
> > changelogs in this manner could be initially challenging as I've seen
> > a few Changelogs with really inconsistent style at the bottom of them.
> 
> How many really long changelogs do we have now? Maybe we should just
> split them by hand.

Below is the list of changelogs with more than 50000 bytes. Let's just say, if we apply the rule for files bigger than 100k, we can easily do it by hand and will still see an improvement- also because the biggest files are updated most often (naturally).

Later, the new files will have a regular format and can be processed automatically anyway.

774821  profiles/ChangeLog
166798  sys-kernel/gentoo-sources/ChangeLog
145004  sys-devel/gcc/ChangeLog
141505  sys-libs/glibc/ChangeLog
141397  media-video/mplayer/ChangeLog
133790  kde-base/kdelibs/ChangeLog
133257  www-client/firefox/ChangeLog
131385  x11-base/xorg-server/ChangeLog
130355  x11-base/xorg-x11/ChangeLog
124531  www-client/opera/ChangeLog
123722  sys-fs/udev/ChangeLog
115914  www-servers/apache/ChangeLog
112672  dev-db/mysql/ChangeLog
110957  media-video/vlc/ChangeLog
107961  sys-apps/baselayout/ChangeLog
107492  sys-kernel/git-sources/ChangeLog
105182  sys-kernel/hardened-sources/ChangeLog
104646  www-client/chromium/ChangeLog
100383  sys-kernel/vanilla-sources/ChangeLog
98137   dev-lang/python/ChangeLog
89614   net-misc/asterisk/ChangeLog
87568   dev-lang/php/ChangeLog
83915   profiles/prefix/ChangeLog
82583   net-fs/samba/ChangeLog
82558   dev-vcs/git/ChangeLog
81787   x11-libs/gtk+/ChangeLog
81691   dev-vcs/subversion/ChangeLog
79141   mail-client/evolution/ChangeLog
78127   dev-lang/ruby/ChangeLog
77357   app-emulation/wine/ChangeLog
75159   media-libs/xine-lib/ChangeLog
72634   dev-lang/perl/ChangeLog
72187   x11-drivers/ati-drivers/ChangeLog
72158   sys-devel/binutils/ChangeLog
70403   media-sound/amarok/ChangeLog
70003   mail-mta/postfix/ChangeLog
69801   net-proxy/squid/ChangeLog
68654   media-video/ffmpeg/ChangeLog
68183   sys-kernel/mm-sources/ChangeLog
67484   net-misc/openssh/ChangeLog
66380   media-gfx/imagemagick/ChangeLog
66175   media-tv/mythtv/ChangeLog
66055   www-servers/tomcat/ChangeLog
66045   mail-client/thunderbird/ChangeLog
66003   net-nds/openldap/ChangeLog
65668   net-print/cups/ChangeLog
65665   app-portage/gentoolkit/ChangeLog
65102   dev-libs/glib/ChangeLog
65073   x11-drivers/nvidia-drivers/ChangeLog
63758   app-crypt/gnupg/ChangeLog
62406   app-editors/emacs/ChangeLog
61747   dev-db/phpmyadmin/ChangeLog
61413   net-libs/xulrunner/ChangeLog
61141   dev-libs/openssl/ChangeLog
60826   media-libs/mesa/ChangeLog
60410   net-dns/bind/ChangeLog
60261   app-editors/emacs-vcs/ChangeLog
60117   gnome-extra/evolution-data-server/ChangeLog
59996   sys-apps/portage/ChangeLog
59966   app-antivirus/clamav/ChangeLog
57709   gnome-base/gnome/ChangeLog
57130   gnome-base/nautilus/ChangeLog
56294   dev-java/sun-jdk/ChangeLog
56243   net-news/liferea/ChangeLog
55883   www-servers/lighttpd/ChangeLog
55540   sys-kernel/tuxonice-sources/ChangeLog
54764   sys-kernel/mips-sources/ChangeLog
54436   sys-kernel/linux-headers/ChangeLog
54167   x11-wm/fluxbox/ChangeLog
54141   dev-db/sqlite/ChangeLog
54109   sys-apps/util-linux/ChangeLog
53644   www-client/epiphany/ChangeLog
53641   media-sound/alsa-driver/ChangeLog
53194   gnome-base/gnome-control-center/ChangeLog
52699   app-editors/vim/ChangeLog
52676   x11-libs/qt/ChangeLog
51030   app-editors/vim-core/ChangeLog
50058   sys-libs/db/ChangeLog
50042   www-client/firefox-bin/ChangeLog



-- 
Andreas K. Huettel
Gentoo Linux developer - kde, sci, arm, tex
dilfridge@gentoo.org
http://www.akhuettel.de/

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

Re: [gentoo-dev] Old changelogs / eclass dir

[Pacho Ramos]

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

El mié, 26-10-2011 a las 19:46 +0200, Andreas K. Huettel escribió:
> Dear all, 
> 
> two small suggestions regarding ChangeLogs:
> 
> 1) Why is there no ChangeLog in the eclass directory? 
> In my personal opinion this is missing there, if only for historical reasons... Should we still start one?
> 
> 2) I'd like to suggest that for changelogs that grow beyond a certain size (e.g. profiles/ChangeLog) 
> the file is "rotated" similar to /var/log logfiles. I.e. the current file is renamed with a date extension and a 
> new file is started. This has the benefit that the archived file is static and will never be retransmitted 
> by rsync.
> 
> Opinions?
> 
> Cheers, Andreas
> 

I agree with both :)

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

Re: [gentoo-dev] Old changelogs / eclass dir

[Samuli Suominen]

On 10/26/2011 08:46 PM, Andreas K. Huettel wrote:
> Dear all, 
> 
> two small suggestions regarding ChangeLogs:
> 
> 1) Why is there no ChangeLog in the eclass directory? 
> In my personal opinion this is missing there, if only for historical reasons... Should we still start one?
> 
> 2) I'd like to suggest that for changelogs that grow beyond a certain size (e.g. profiles/ChangeLog) 
> the file is "rotated" similar to /var/log logfiles. I.e. the current file is renamed with a date extension and a 
> new file is started. This has the benefit that the archived file is static and will never be retransmitted 
> by rsync.
> 
> Opinions?
> 
> Cheers, Andreas
> 

I agree with both ideas.

</my 2 cent>

- Samuli

Re: [gentoo-dev] Old changelogs / eclass dir

[Ulrich Mueller]

>>>>> On Wed, 26 Oct 2011, Andreas K Huettel wrote:

> 1) Why is there no ChangeLog in the eclass directory? 
> In my personal opinion this is missing there, if only for historical
> reasons... Should we still start one?

It's never too late. Even echangelog works in the eclass directory,
once you generate an initial ChangeLog file there.

> 2) I'd like to suggest that for changelogs that grow beyond a
> certain size (e.g. profiles/ChangeLog) the file is "rotated" similar
> to /var/log logfiles. I.e. the current file is renamed with a date
> extension and a new file is started. This has the benefit that the
> archived file is static and will never be retransmitted by rsync.

I'd rather truncate the file and keep only the last one or two years
of history.

Also some subdirectories of profiles have their own ChangeLog, and
others don't. Looks pretty much random, e.g. why is there a ChangeLog
in profiles/default/bsd but not in profiles/default/linux? Probably
that's for historical reasons too, and we should rethink it.

Ulrich

[gentoo-dev] Re: Old changelogs / eclass dir

[Ryan Hill]

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

On Wed, 26 Oct 2011 19:46:30 +0200
"Andreas K. Huettel" <dilfridge@gentoo.org> wrote:

> Dear all, 
> 
> two small suggestions regarding ChangeLogs:
> 
> 1) Why is there no ChangeLog in the eclass directory? 
> In my personal opinion this is missing there, if only for historical reasons... Should we still start one?
>
> 2) I'd like to suggest that for changelogs that grow beyond a certain size (e.g. profiles/ChangeLog) 
> the file is "rotated" similar to /var/log logfiles. I.e. the current file is renamed with a date extension and a 
> new file is started. This has the benefit that the archived file is static and will never be retransmitted 
> by rsync.

I like both suggestions.  Maybe we could split by year?  That way the old
non-conforming entries would just go into the oldest log.  Delaying rotation
by one year (ie. the first entry in 2012 would cause entries in 2010 to be
split off) would prevent getting a bunch of empty changelogs Jan 1st.


-- 
fonts, gcc-porting,                  it makes no sense how it makes no sense
toolchain, wxwidgets                           but i'll take it free anytime
@ gentoo.org                EFFD 380E 047A 4B51 D2BD C64F 8AA8 8346 F9A4 0662

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-dev] Re: Old changelogs / eclass dir

[Markos Chandras]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

On 10/31/2011 05:45 AM, Ryan Hill wrote:
> On Wed, 26 Oct 2011 19:46:30 +0200 "Andreas K. Huettel"
> <dilfridge@gentoo.org> wrote:
> 
>> Dear all,
>> 
>> two small suggestions regarding ChangeLogs:
>> 
>> 1) Why is there no ChangeLog in the eclass directory? In my
>> personal opinion this is missing there, if only for historical
>> reasons... Should we still start one?
>> 
>> 2) I'd like to suggest that for changelogs that grow beyond a
>> certain size (e.g. profiles/ChangeLog) the file is "rotated"
>> similar to /var/log logfiles. I.e. the current file is renamed
>> with a date extension and a new file is started. This has the
>> benefit that the archived file is static and will never be
>> retransmitted by rsync.
> 
> I like both suggestions.  Maybe we could split by year?  That way
> the old non-conforming entries would just go into the oldest log.
> Delaying rotation by one year (ie. the first entry in 2012 would
> cause entries in 2010 to be split off) would prevent getting a
> bunch of empty changelogs Jan 1st.
> 
> 
There is always the problem with abandoned (but working) packages
which may have no commits in > 2 years. We'll end up with empty
ChangeLogs.

- -- 
Regards,
Markos Chandras / Gentoo Linux Developer / Key ID: B4AFF2C2
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.18 (GNU/Linux)

iQIcBAEBCgAGBQJOrl7LAAoJEPqDWhW0r/LCliUP/iv03V38dvdqTSYkW6gHMtkB
oK6OU5As6xK+qmaQmcUYFhPByX0Vgfnox1vOJGNiL1plbwBO9mB1gnjSgkvQsM0p
XI2WpuzaTy2Fl28BETabcXyj4iC9yOQeMLncV5Om7SDNIh2FnuG/72+uZEY+LBq9
U5sDUHKNWCGOJdlg/dl0uqjmxaChwVDGO0h0wuqFyuLtQ+wSYAmhnI8PUsNOhlPN
0GdUNFXCOHePURlofRyhY5eON9t++zG0ZWqLfK8oTuSF0LCaRjMGwpeWnFknp4VH
Gqo8uBWDTgoulYn/KawZ0EuJcysVgx2ghk98F+Gx59VUnHinBdrJaD2tZQE0yh4t
Y1yO6IjTjDqH1yXvcH0BlZYeDNTyHCG+JNse5DOPyvgRRdO6ixKFM6VSE1CQX6oK
ak61+Vps6V0Ir1FBEvu8hIOc9G96vAA9ikGDeZYzgeqwgjf+6M7Q3uUcZXw5Sr7Q
YPOmyb9s3DkYIAal0/E7JuaZqg4i/0C28B2CyOwB9kddh57jLVAHX6S8oN4V1US+
iy3+TCNdo64wVldDBlDAAbQ+KP5x9ubqd9NDGE/5uy26VWN+dBLiXQYc+fqVHhBx
LU5wdTiCQqzRAPhItmwg0Uti76m/kV6dt6ABUs0dWuuXvpyvxivmADiNX27mzavn
fXbN+AMYkIwi9LLLkpR4
=kEIA
-----END PGP SIGNATURE-----

Re: [gentoo-dev] Re: Old changelogs / eclass dir

[Nirbheek Chauhan]

On Mon, Oct 31, 2011 at 2:09 PM, Markos Chandras <hwoarang@gentoo.org> wrote:
> There is always the problem with abandoned (but working) packages
> which may have no commits in > 2 years. We'll end up with empty
> ChangeLogs.
>

This is a simple technical problem, the solution of which is to take
the "last 6 months" or "last one year" of activity, or the last 50
commits, whichever is more. Or something similar. It's not a
fundamental problem with the idea.

Note that this defence is not an endorsement of the idea itself.

-- 
~Nirbheek Chauhan

Gentoo GNOME+Mozilla Team

[gentoo-dev] Re: Old changelogs / eclass dir

[Ryan Hill]

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

On Mon, 31 Oct 2011 08:39:39 +0000
Markos Chandras <hwoarang@gentoo.org> wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA512
> 
> On 10/31/2011 05:45 AM, Ryan Hill wrote:
> > On Wed, 26 Oct 2011 19:46:30 +0200 "Andreas K. Huettel"
> > <dilfridge@gentoo.org> wrote:
> > 
> >> Dear all,
> >> 
> >> two small suggestions regarding ChangeLogs:
> >> 
> >> 1) Why is there no ChangeLog in the eclass directory? In my
> >> personal opinion this is missing there, if only for historical
> >> reasons... Should we still start one?
> >> 
> >> 2) I'd like to suggest that for changelogs that grow beyond a
> >> certain size (e.g. profiles/ChangeLog) the file is "rotated"
> >> similar to /var/log logfiles. I.e. the current file is renamed
> >> with a date extension and a new file is started. This has the
> >> benefit that the archived file is static and will never be
> >> retransmitted by rsync.
> > 
> > I like both suggestions.  Maybe we could split by year?  That way
> > the old non-conforming entries would just go into the oldest log.
> > Delaying rotation by one year (ie. the first entry in 2012 would
> > cause entries in 2010 to be split off) would prevent getting a
> > bunch of empty changelogs Jan 1st.
> > 
> > 
> There is always the problem with abandoned (but working) packages
> which may have no commits in > 2 years. We'll end up with empty
> ChangeLogs.

notifempty
minsize 5k


-- 
fonts, gcc-porting,                  it makes no sense how it makes no sense
toolchain, wxwidgets                           but i'll take it free anytime
@ gentoo.org                EFFD 380E 047A 4B51 D2BD C64F 8AA8 8346 F9A4 0662

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

[gentoo-dev] ChangeLog in eclass dir (was: Old changelogs / eclass dir)

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 475 bytes --]


Dear all, 

> 1) Why is there no ChangeLog in the eclass directory?
> In my personal opinion this is missing there, if only for historical
> reasons... Should we still start one?

as there was only positive feedback to this suggestion, I'll create a 
ChangeLog file in the eclass directory during the next days. (Last chance to 
protest!)

Cheers, 
Andreas

-- 

Andreas K. Huettel
Gentoo Linux developer 
dilfridge@gentoo.org
http://www.akhuettel.de/


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

[gentoo-dev] Re: ChangeLog in eclass dir (was: Old changelogs / eclass dir)

[Ryan Hill]

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

On Thu, 3 Nov 2011 01:11:46 +0100
"Andreas K. Huettel" <dilfridge@gentoo.org> wrote:

> 
> Dear all, 
> 
> > 1) Why is there no ChangeLog in the eclass directory?
> > In my personal opinion this is missing there, if only for historical
> > reasons... Should we still start one?
> 
> as there was only positive feedback to this suggestion, I'll create a 
> ChangeLog file in the eclass directory during the next days. (Last chance to 
> protest!)

First get echangelog to work in eclass/.


-- 
fonts, gcc-porting,                  it makes no sense how it makes no sense
toolchain, wxwidgets                           but i'll take it free anytime
@ gentoo.org                EFFD 380E 047A 4B51 D2BD C64F 8AA8 8346 F9A4 0662

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-dev] Re: ChangeLog in eclass dir (was: Old changelogs / eclass dir)

[Andreas K. Huettel]

On Donnerstag 03 November 2011 01:42:44 Ryan Hill wrote:
> On Thu, 3 Nov 2011 01:11:46 +0100
> 
> "Andreas K. Huettel" <dilfridge@gentoo.org> wrote:
> > Dear all,
> > 
> > > 1) Why is there no ChangeLog in the eclass directory?
> > > In my personal opinion this is missing there, if only for historical
> > > reasons... Should we still start one?
> > 
> > as there was only positive feedback to this suggestion, I'll create a
> > ChangeLog file in the eclass directory during the next days. (Last chance
> > to protest!)
> 
> First get echangelog to work in eclass/.

It works fine once there is a ChangeLog. (It refuses to create a new one 
outside ebuild dirs though...)

Proof:

# ChangeLog for eclass
# Copyright 1999-2011 Gentoo Foundation; Distributed under the GPL v2
# $Header: $

  03 Nov 2011; Andreas K. Huettel <dilfridge@gentoo.org> kde4-base.eclass:
  Added empty line




-- 

Andreas K. Huettel
Gentoo Linux developer 
dilfridge@gentoo.org
http://www.akhuettel.de/

[gentoo-dev] Re: ChangeLog in eclass dir (was: Old changelogs / eclass dir)

[Ryan Hill]

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

On Thu, 3 Nov 2011 01:41:29 +0100
"Andreas K. Huettel" <dilfridge@gentoo.org> wrote:

> On Donnerstag 03 November 2011 01:42:44 Ryan Hill wrote:
> > On Thu, 3 Nov 2011 01:11:46 +0100
> > 
> > "Andreas K. Huettel" <dilfridge@gentoo.org> wrote:
> > > as there was only positive feedback to this suggestion, I'll create a
> > > ChangeLog file in the eclass directory during the next days. (Last chance
> > > to protest!)
> > 
> > First get echangelog to work in eclass/.
> 
> It works fine once there is a ChangeLog. (It refuses to create a new one 
> outside ebuild dirs though...)
> 
> Proof:
> 
> # ChangeLog for eclass
> # Copyright 1999-2011 Gentoo Foundation; Distributed under the GPL v2
> # $Header: $
> 
>   03 Nov 2011; Andreas K. Huettel <dilfridge@gentoo.org> kde4-base.eclass:
>   Added empty line


Oooh.  Neato.


-- 
fonts, gcc-porting,                  it makes no sense how it makes no sense
toolchain, wxwidgets                           but i'll take it free anytime
@ gentoo.org                EFFD 380E 047A 4B51 D2BD C64F 8AA8 8346 F9A4 0662

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-dev] ChangeLog in eclass dir (was: Old changelogs / eclass dir)

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 665 bytes --]


> > 1) Why is there no ChangeLog in the eclass directory?
> > In my personal opinion this is missing there, if only for historical
> > reasons... Should we still start one?
> 
> as there was only positive feedback to this suggestion, I'll create a
> ChangeLog file in the eclass directory during the next days. (Last chance
> to protest!)

And done. :)

huettel@pinacolada ~/Gentoo/gentoo-x86/eclass $ cvs commit
/var/cvsroot/gentoo-x86/eclass/ChangeLog,v  <--  ChangeLog
initial revision: 1.1
huettel@pinacolada ~/Gentoo/gentoo-x86/eclass $ 


-- 

Andreas K. Huettel
Gentoo Linux developer 
dilfridge@gentoo.org
http://www.akhuettel.de/


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

Re: [gentoo-dev] ChangeLog in eclass dir (was: Old changelogs / eclass dir)

[Jeroen Roovers]

On Fri, 4 Nov 2011 00:25:32 +0100
"Andreas K. Huettel" <dilfridge@gentoo.org> wrote:

> 
> > > 1) Why is there no ChangeLog in the eclass directory?
> > > In my personal opinion this is missing there, if only for
> > > historical reasons... Should we still start one?
> > 
> > as there was only positive feedback to this suggestion, I'll create
> > a ChangeLog file in the eclass directory during the next days.
> > (Last chance to protest!)
> 
> And done. :)

Great. Now do we enforce writing ChangeLog entries like we do
everywhere else? Can we then get repoman to also do commits in
non-ebuild directories (i.e. ignore a missing $CAT and missing *.ebuild?


     jer

Re: [gentoo-dev] ChangeLog in eclass dir

[Zac Medico]

On 11/15/2011 11:15 AM, Jeroen Roovers wrote:
> On Fri, 4 Nov 2011 00:25:32 +0100
> "Andreas K. Huettel" <dilfridge@gentoo.org> wrote:
> 
>>
>>>> 1) Why is there no ChangeLog in the eclass directory?
>>>> In my personal opinion this is missing there, if only for
>>>> historical reasons... Should we still start one?
>>>
>>> as there was only positive feedback to this suggestion, I'll create
>>> a ChangeLog file in the eclass directory during the next days.
>>> (Last chance to protest!)
>>
>> And done. :)
> 
> Great. Now do we enforce writing ChangeLog entries like we do
> everywhere else? Can we then get repoman to also do commits in
> non-ebuild directories (i.e. ignore a missing $CAT and missing *.ebuild?

Sure, I've filed a bug:

  https://bugs.gentoo.org/show_bug.cgi?id=390651

-- 
Thanks,
Zac

[gentoo-dev] Rotating oversized ChangeLog files (was: Old changelogs / eclass dir)

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 2343 bytes --]

Dear all,

> 2) I'd like to suggest that for changelogs that grow beyond a certain size
> (e.g. profiles/ChangeLog) the file is "rotated" similar to /var/log
> logfiles. I.e. the current file is renamed with a date extension and a new
> file is started. This has the benefit that the archived file is static and
> will never be retransmitted by rsync.

to prevent that this becomes a victim of general ChangeLog bikeshedding (we 
must rotate at a logical point, how could it be automatized even if it is 
relevant for only a few files, then how do we prevent epmty files...) I 
suggest the following procedure:

In a week's time I personally, manually, will "rotate" all ChangeLog files 
larger than 100k in the tree, by splitting them at 31/12/2010-1/1/2011.
The old entries file will in each case be named ChangeLog-2010 in the same 
directory. (PMS: "A package directory may contain other files or directories, 
whose purpose is not covered by this specification.")

The "old entries" file ChangeLog-2010 will be identical to the current 
ChangeLog file except for skipping at the start all entries added later than 
31/12/2010.
The new ChangeLog file will be identical to the current ChangeLog file except 
for being truncated at 1/1/2011.

I currently count 19 relevant files. If we keep the 100k limit and rotate 
yearly, this will be doable by hand in the foreseeable future and any attempt 
at automating is a complete waste of time.

Opinions, flames, ...?

Cheers, 
Andreas

PS.
774821  profiles/ChangeLog
166798  sys-kernel/gentoo-sources/ChangeLog
145004  sys-devel/gcc/ChangeLog
141505  sys-libs/glibc/ChangeLog
141397  media-video/mplayer/ChangeLog
133790  kde-base/kdelibs/ChangeLog
133257  www-client/firefox/ChangeLog
131385  x11-base/xorg-server/ChangeLog
130355  x11-base/xorg-x11/ChangeLog
124531  www-client/opera/ChangeLog
123722  sys-fs/udev/ChangeLog
115914  www-servers/apache/ChangeLog
112672  dev-db/mysql/ChangeLog
110957  media-video/vlc/ChangeLog
107961  sys-apps/baselayout/ChangeLog
107492  sys-kernel/git-sources/ChangeLog
105182  sys-kernel/hardened-sources/ChangeLog
104646  www-client/chromium/ChangeLog
100383  sys-kernel/vanilla-sources/ChangeLog

-- 

Andreas K. Huettel
Gentoo Linux developer 
dilfridge@gentoo.org
http://www.akhuettel.de/


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

Re: [gentoo-dev] Rotating oversized ChangeLog files

[Mike Gilbert]

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

On 11/02/2011 08:33 PM, Andreas K. Huettel wrote:
> I currently count 19 relevant files. If we keep the 100k limit and rotate 
> yearly, this will be doable by hand in the foreseeable future and any attempt 
> at automating is a complete waste of time.
> 
> Opinions, flames, ...?
> 

Just an observation: I think www-client/chromium has the fastest growing
ebuild changelog at 50-60k per year. That's a lot of version bumps!


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 230 bytes --]

Re: [gentoo-dev] Rotating oversized ChangeLog files (was: Old changelogs / eclass dir)

[Michał Górny]

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

On Thu, 3 Nov 2011 01:33:38 +0100
"Andreas K. Huettel" <dilfridge@gentoo.org> wrote:

> Dear all,
> 
> > 2) I'd like to suggest that for changelogs that grow beyond a
> > certain size (e.g. profiles/ChangeLog) the file is "rotated"
> > similar to /var/log logfiles. I.e. the current file is renamed with
> > a date extension and a new file is started. This has the benefit
> > that the archived file is static and will never be retransmitted by
> > rsync.
> 
> to prevent that this becomes a victim of general ChangeLog
> bikeshedding (we must rotate at a logical point, how could it be
> automatized even if it is relevant for only a few files, then how do
> we prevent epmty files...) I suggest the following procedure:
> 
> In a week's time I personally, manually, will "rotate" all ChangeLog
> files larger than 100k in the tree, by splitting them at
> 31/12/2010-1/1/2011. The old entries file will in each case be named
> ChangeLog-2010 in the same directory. (PMS: "A package directory may
> contain other files or directories, whose purpose is not covered by
> this specification.")

Maybe we should keep old changelogs in a separate directory to decrease
ebuilddir pollution?

> The new ChangeLog file will be identical to the current ChangeLog
> file except for being truncated at 1/1/2011.

Maybe it'd be a good idea to add some kind of footer saying 'for
further entries, please inquiry ChangeLog-2010 file'.

-- 
Best regards,
Michał Górny

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 316 bytes --]

Re: [gentoo-dev] Rotating oversized ChangeLog files (was: Old changelogs / eclass dir)

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 590 bytes --]

On Donnerstag 03 November 2011 09:09:19 Michał Górny wrote:
> 
> Maybe we should keep old changelogs in a separate directory to decrease
> ebuilddir pollution?

Not sure about that.

> 
> > The new ChangeLog file will be identical to the current ChangeLog
> > file except for being truncated at 1/1/2011.
> 
> Maybe it'd be a good idea to add some kind of footer saying 'for
> further entries, please inquiry ChangeLog-2010 file'.

Yes, makes sense and is easily done.

-- 

Andreas K. Huettel
Gentoo Linux developer 
dilfridge@gentoo.org
http://www.akhuettel.de/


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

Re: [gentoo-dev] Rotating oversized ChangeLog files (was: Old changelogs / eclass dir)

[James Broadhead]

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

On Nov 3, 2011 10:25 a.m., "Andreas K. Huettel" <dilfridge@gentoo.org>
wrote:
>
> On Donnerstag 03 November 2011 09:09:19 Michał Górny wrote:
> >
> > Maybe we should keep old changelogs in a separate directory to decrease
> > ebuilddir pollution?
>
> Not sure about that.

Thank you for this infusion of practicality.

How about in ${FILESDIR} ?

[-- Attachment #2: Type: text/html, Size: 505 bytes --]

Re: [gentoo-dev] Rotating oversized ChangeLog files

[Ulrich Mueller]

>>>>> On Thu, 3 Nov 2011, Andreas K Huettel wrote:

> The "old entries" file ChangeLog-2010 will be identical to the
> current ChangeLog file except for skipping at the start all entries
> added later than 31/12/2010.

Just to make sure that I understand it: Does this imply that the old
entries file will have a proper header?

> 774821  profiles/ChangeLog

Maybe you could split this one on a yearly basis, to keep the chunks
close to 100 kB?

Ulrich

Re: [gentoo-dev] Rotating oversized ChangeLog files

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 753 bytes --]

On Donnerstag 03 November 2011 09:24:07 Ulrich Mueller wrote:
> >>>>> On Thu, 3 Nov 2011, Andreas K Huettel wrote:
> > The "old entries" file ChangeLog-2010 will be identical to the
> > current ChangeLog file except for skipping at the start all entries
> > added later than 31/12/2010.
> 
> Just to make sure that I understand it: Does this imply that the old
> entries file will have a proper header?

Yes.

> > 774821  profiles/ChangeLog
> 
> Maybe you could split this one on a yearly basis, to keep the chunks
> close to 100 kB?

Makes sense, yes. (With the earliest splitting when the file exceeds 100k for 
the first time.)

-- 

Andreas K. Huettel
Gentoo Linux developer 
dilfridge@gentoo.org
http://www.akhuettel.de/


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

Re: [gentoo-dev] Rotating oversized ChangeLog files

[Michael Haubenwallner]

On 11/03/2011 01:33 AM, Andreas K. Huettel wrote:
> In a week's time I personally, manually, will "rotate" all ChangeLog files 
> larger than 100k in the tree, by splitting them at 31/12/2010-1/1/2011.

> Opinions, flames, ...?

<opinion>

Again for 'emerge --changelog':

As we do have the "$delay before breaking old" period, usually with $delay="1 year":
Should we also apply this $delay to the output of above command?

If yes, what I can think of ATM is:
* Do that first splitting in January 2012 (in less than 2 months).
* Have PM search in the old ChangeLogs if necessary.

The latter would also allow for completely emptying current ChangeLog each January
by moving that to ChangeLog-$lastyear.

</opinion>

/haubi/

Re: [gentoo-dev] Rotating oversized ChangeLog files

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 1022 bytes --]

On Donnerstag 03 November 2011 10:16:53 Michael Haubenwallner wrote:
>
> Again for 'emerge --changelog':
> 
> As we do have the "$delay before breaking old" period, usually with
> $delay="1 year": Should we also apply this $delay to the output of above
> command?
> 
> If yes, what I can think of ATM is:
> * Do that first splitting in January 2012 (in less than 2 months).
> * Have PM search in the old ChangeLogs if necessary.
> 
> The latter would also allow for completely emptying current ChangeLog each
> January by moving that to ChangeLog-$lastyear.
> 

Makes all perfect sense... however I suggest to agree on a general scheme and 
go ahead manually first if implementation and/or discussion of its details or 
planned features is lingering...

As opposed to EAPI features, this here is one of the cases where "availability 
of an implementation" means "I'm here and can do it quickly".

-- 

Andreas K. Huettel
Gentoo Linux developer 
dilfridge@gentoo.org
http://www.akhuettel.de/


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

Re: [gentoo-dev] Rotating oversized ChangeLog files

[Ulrich Mueller]

>>>>> On Thu, 3 Nov 2011, Andreas K Huettel wrote:

> On Donnerstag 03 November 2011 10:16:53 Michael Haubenwallner wrote:

>> As we do have the "$delay before breaking old" period, usually with
>> $delay="1 year": Should we also apply this $delay to the output of
>> above command?

> Makes all perfect sense... however I suggest to agree on a general
> scheme and go ahead manually first if implementation and/or
> discussion of its details or planned features is lingering...

How about this:
- Possible split points are only at the end of years.
- Start at the end of the file and go backwards.
- Split it whenever the piece after the split point is larger than $size.
- Stop if the next split point is less than $delay ago.

Reasonable values are 50 or 100 KiB for $size and 1 year for $delay,
IMHO.

ulrich

Re: [gentoo-dev] Rotating oversized ChangeLog files

[Andreas K. Huettel]

[-- Attachment #1: Type: Text/Plain, Size: 1142 bytes --]

On Donnerstag 03 November 2011 11:59:55 Ulrich Mueller wrote:
> >>>>> On Thu, 3 Nov 2011, Andreas K Huettel wrote:
> > On Donnerstag 03 November 2011 10:16:53 Michael Haubenwallner wrote:
> >> As we do have the "$delay before breaking old" period, usually with
> >> $delay="1 year": Should we also apply this $delay to the output of
> >> above command?
> > 
> > Makes all perfect sense... however I suggest to agree on a general
> > scheme and go ahead manually first if implementation and/or
> > discussion of its details or planned features is lingering...
> 
> How about this:
> - Possible split points are only at the end of years.
> - Start at the end of the file and go backwards.
> - Split it whenever the piece after the split point is larger than $size.
> - Stop if the next split point is less than $delay ago.
> 
> Reasonable values are 50 or 100 KiB for $size and 1 year for $delay,
> IMHO.

Sounds good. So, we have a spec... and the portage team has two months to get 
it into "emerge --changelog". :)

-- 

Andreas K. Huettel
Gentoo Linux developer 
dilfridge@gentoo.org
http://www.akhuettel.de/


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

Re: [gentoo-dev] Rotating oversized ChangeLog files

[Andreas K. Huettel]

> 
> Sounds good. So, we have a spec... and the portage team has two months to
> get it into "emerge --changelog". :)
>

For whoever is interested, I've just filed a portage feature request in bug 
389611.

https://bugs.gentoo.org/show_bug.cgi?id=389611
Please support "rotated ChangeLog files" in "emerge --changelog"

-- 
Andreas K. Huettel (dilfridge)
Gentoo Linux developer
kde, sci, arm, tex