r36970 - /packages/rheolef/trunk/debian/changelog

[Manuel Prinz]

Hi Pierre!

Am Freitag, den 29.10.2010, 09:40 +0000 schrieb
saramito-guest at users.alioth.debian.org:
> Author: saramito-guest
> Date: Fri Oct 29 09:40:27 2010
> New Revision: 36970
> […]
>  rheolef (5.90-1) unstable; urgency=low
>  
>    [Pierre Saramito]
> -  * Fix bug: was in conflict with /usr/bin/proj from the proj package
> +  * Four bug fixes: 
> +       from http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=rheolef
> +       1) source code does not compile on non-x86 architectures
> +       #588960 : FTBFS [!x86]: unrecognized command line option "-mieee-fp"
> +       #593695 : src:rheolef: librheolef-dev depends on unavailable rheolef-runtime
> +       2) conflict with /usr/bin/proj from the proj package
> +       #592192 : rheolef-runtime: ..tries to overwrite '/usr/bin/proj' in package proj-bin 4.7.0-1
> +       #593189 : rheolef-runtime_5.89: ..tries to overwrite '/usr/bin/proj' in package proj-bin 4.7.0-1

This entry needs some rework, IMHO. It is not very clear what changed
between this version and the one before. Of course, you should mention
all bugs that got fixed. But you should group them into logical changes.
Also, providing a link to the BTS is not necessary. (Most people know
it, and the bugs numbers can be looked up by invoking "bts show [num]".)
Bug descriptions are not always optimal, so copying them verbosely in
the changelog is usually not recommended.

Here's my proposal on how the changelog entry might look like:

[Pierre Saramito]
* Resolved conflict with /usr/bin/proj from the proj package.
  Closes: #592192, #593189.
* Fixed build failures on non-x86 arches. Closes: #588960, #593695.

(It is my understanding that rheole-runtime did not build on non-x86
because -mieee-fp is missing on those arches. If the last two bugs are
different issues, you should split them into two entries.)

Also try to break lines at 80 chars, so that the changelog entries can
be easily displayed on a terminal.

Thanks for your work on rheoloe!

Best regards,
Manuel