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

[Jani Monoses]

>
> >  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.
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.

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.

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.

Also grepping for changes by a person would be a lot more straightforward.
The legibility of it will still be very good even if it wasn't _that_ pretty
And if legibility was affected it would mean they are way too many changes
and it's time for an upload ;)

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

thank you
Jani
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.alioth.debian.org/pipermail/pkg-xfce-devel/attachments/20051220/09fbaa54/attachment.html