Re: FreeDiams

[Andreas Tille <andreas@fam-tille.de>]

On Tue, Oct 20, 2009 at 09:16:55PM +0200, Eric MAEKER wrote:
> I've released sources of FreeDiams v0.1.2 (which is mainly a debug  
> release).

I have seen you even released v0.1.4 - at least guessing from your
commit to the packaging SVN.  I would like to clarify something and I
hope you don't mind if I do this in public.  But there might be other
beginners and I would like to keep a record of this explanation.

As I realised you are using the file debian/changelog to describe what
you have changed in FreeDiams.  But this is not the intention of the
__debian__/changelog file.  This file just describes the changes in
the *Debian* *packaging*.  So if there is a new version of FreeDiams
the debian/changelog file would say something like this.

freediams (0.1.4-1) UNRELEASED; urgency=low
                ^^^
          mind this Debian version!!!

  * New upstream version
  * Additional Build-Depends ...
  * Bumped Standards-Version ...
  * Changes in debian/rules

 -- Eric Maeker <eric.maeker@free.fr>  Fri, 23 Oct 2009 00:00:00 +0200


What you wrote in this file rather belongs to a so called "upstream
changelog" file which if for instance called "ChangeLog" or
ChangeLog.txt or whatever.  Here you can document the changes inside
actual upstream (=FreeDiams) code.  If you are mixing this up people
which are not using Debian will probably miss your changelog and from
a packaging point of view it might confuse other packagers.

Feel free to ask here or in private if something remains unclear.

Kind regards

      Andreas.

-- 
http://fam-tille.de