Page MenuHomeLubuntu Development

Updated 1,352 Days AgoPublic

The file debian/changelog file documents in a short form all changes made to the package. This is not only useful for other developers, but also for normal users.


A normal changelog entry looks like:

super-package (0.13.0-0ubuntu5) eoan; urgency=medium

  [ Minnie Mouse ]
  * Add feature foo
  * Refactor of lib bar:
    - Use strategy pattern
      + Added simple strategy
      + Added normal strategy
      + Added heavy strategy
    - Better naming
  [ Mickey Mouse ]
  * Added unit tests

 -- tricky-mickey <>  Sun, 01 Apr 2019 11:17:17 +0200
  • Every line of the changelog entry should have a bullet point in front and in the order of *, -, +. If you need more levels, restart with the * bullet point.
  • Use two spaces to indent.
  • No trailing whitespaces.


To edit the changelog, you can use the tool debchange from the package devscripts.

dch -aAppend a new bullet point to the newest changelog entry
dch -iIncrement the version number: e.g 0.13.0-0ubuntu5 => 0.13.0-0ubuntu6
dch --distribution=eoanReplace UNRELEASED with the specified distribution
dch -r ""Update the changelog timestamp


Last Author
Last Edited
Sep 15 2019, 11:39 AM