Debian Changelogs - was: Re: Bug#756582: new syntax error when invoking "udevadm test" breaks installing/ upgrading
> This is caused by this, change between the afforementioned versions,
> which is also not mentioned in the package's changelog:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Exactly! I cannot stress this further enough, please always document
_every_ change you make to the packaging in the debian/changelog. This
is exactly the reason it is intended for.
When you create a new package revision, make a debdiff against the
current version in unstable and compare your changes. Include
every change you made in the debian/ directory in the changelog entry
for the new package revision.
This way, everyone looking at the new package revision has an instant
overview what was changed and bugs like these are easier to find and
to fix.
The easiest way to get comprehensive and pretty changelog entries is
to use git-buildpackage for keeping your package in a revision control
system and use "git-dch --auto" to generate the changelog entry for
the new version. Of course, this assumes you are writing sensible and
useful git commit messages :).
Cheers,
Adrian
--
.''`. John Paul Adrian Glaubitz
: :' : Debian Developer - glaubitz@debian.org
`. `' Freie Universitaet Berlin - glaubitz@physik.fu-berlin.de
`- GPG: 62FF 8A75 84E0 2956 9546 0006 7426 3B37 F5B5 F913
Reply to: