[Pkg-xfce-devel] README: Proposal for unreleased packages/changelog entries

Simon Huggins huggie at earth.li
Tue Dec 20 17:41:45 UTC 2005

On Tue, Dec 20, 2005 at 02:44:31PM +0200, Jani Monoses wrote:
> > >  On top of this I'd like to propose that whereever possible we use a
> > >  common format for changes which are made by more than one person.
> > >
> > >  I personally like:
> > >
> > >   * (Simon Huggins)
> > >     * blah1
> > >     * blah2
> > >   * (Yves-Alexis Perez)
> > >     * blah3
> > >     * blah4
> > >  etc.
> > I *strongly* agree here, the method based only on initals was less
> > clear IMHO.
> On the topic of more people contributing to a changelog: ideally it
> would be easier if once a person changed something and added a
> changelog in svn it was followed by uploading to the archive. Hence
> changes by one person only per debian revision.

Beurk.  This isn't always a good idea but I agree that we do want
uploads for new upstream revisions and that the goodies do want general
cleanup uploads.

> This may not be practical because of the time a package needs to be
> tested before being considered ready for upload, but we should still
> strive for upload 'early and often' IMHO, for avoiding bottlenecks and
> the introduction of unrelated changes in a revision which
> theoretically make bug hunting harder.

I find this argument specious - it's all in SVN so if we want to we can
work out exactly what caused the introduction of a bug.

> In the cases when an upload is not made in time and another commiter
> has changes to the package I think the layout of the changelog would
> be better if it was a stricter format, so instead of what is above we
> had:
>  *blah1 (Simon Huggins)
>  *blah2 (Emanuele Rocca)
>  ...
>  *blahn (Simon Huggins)
> so they are added chronologically (as the changelogs themselves) not
> per author.

I really don't like this.  I much prefer the two original formats I 

Also having the changes in chronological order doesn't really buy you
anything.  Our users only see things after uploads.

> this would make automatic handling a lot easier (I am now sedding
> across the files, and adding Bump Version to 3.6.2 (Jani Monoses) to
> 23 files  would be way easier if the format wasn't hierarchical and
> the corresponding header didn't have to be looked up.

Automatic handling isn't a big issue.  Sure you've had to change 23
changelogs and it's a bit of a pain but someone has to then upload 23
packages and inspect and check them all which is more pain :)

I think taking the time to respect the formats I provided is worth it
though if enough people prefer this one then I'm prepared to back down.

> Also grepping for changes by a person would be a lot more
> straightforward.

How often do you do that then? :p

> please consider this format before starting to update existing
> changelogs en-masse

I'm just not convinced yet.


oOoOo  "Come on people, we've got to turn this place around. Hang  oOoOo
 oOoOo    out the lights, string up the banners, castrate the     oOoOo
  oOoOo                   cows!" - Mayor, SP.                    oOoOo

More information about the Pkg-xfce-devel mailing list