Working with the tools - or around/against the tools
Modestas Vainius
modestas at vainius.eu
Thu Jul 3 20:29:16 UTC 2008
Hi,
Thursday 03 July 2008, Ana Guerrero rašė:
> I do not care at all about using +++ Name or [ Name ] but when more than a
> person have worked in the package I like uploading it as a team upload as
> we have done until now. So not ok about changing that.
However, current practise is not consistent with regard to if there is only
one maintainer doing changes, team name & address may not be used at the
bottom. This practise should be avoided because:
1) Somebody is _always_ the first to make changes. So s(he) may put his/her
name in the maintainer space of the changelog entry (lets call such entry
entry).
2) Now the second maintainer committing changes has to:
a) add +++ Changes by line for the first maintainer, which effectively means
copy&pasting from the changelog maintainer field if 1st maitainer created a
personal entry. A bit time consuming.
b) add "+++ Changes for My name". Pretty easy.
c) replace current changelog maintainer with Debian QT/KDE Maintainers. I
usually end up copying and pasting from the previous non-personal entry (but I
sometimes need to search for the it due to existence of personal entries).
3) Third and subsequent maintainners has only to do 2b. So the 1st or the 2nd
maintainner gets the most additional work to do with the changelog.
4) If personal changelog entries are allowed, it effectively means that dch -m
will not work for creating proper new revision entry after personal changelog
entry. So the 1st maintainer has to do 2c in addition to 2b or create a new
personal entry _or_ leave all the burden to the 2nd maintainer.
Most of these tasks can be automated by dch if the standard layout is used.
However, dch behaviour depends on having the name of the real maintainer in
the changelog maintainer field to transform personal entry to the team entry.
Having all this said, I very dislike personal changelog entries because they
potentially leave more work for the 2nd maintainer (2a part). I never do them.
So if to change anything at all, in my opinion, only the following
alternatives are viable:
1) Do as dch supports now, i.e. do not use team in the changelog maintainer
field (Sune proposal).
2) Do not change anything until "team name in the changelog maintainer" is
implemented in dch (Ana's wish).
3) Disallow non-team name & address in the changelog mainainer field, hence
everybody adds their own "+++ Changes by name". I can write svn hook which
would enforce this rule. This will ensure that dch -m will always work
properly for creating new changelog entries.
--
Modestas Vainius <modestas at vainius.eu>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part.
Url : http://lists.alioth.debian.org/pipermail/pkg-kde-talk/attachments/20080703/912212ec/attachment.pgp
More information about the pkg-kde-talk
mailing list