| 5 | You can manage this with the dch command, or with Emacs' `change-log-mode`. |
| 6 | |
| 7 | == dch == |
| 8 | |
| 9 | `dch` or `debchange` manages changelog files. Typical invocations: |
| 10 | - `dch --create`: Create a new changelog file for the initial release of a package |
| 11 | - `dch -i "Summary of a change you made here"`: Increment the version of the package, and add a new changelog entry. |
| 12 | - `dch -a "Summary of another change"`: Add a changelog entry to the current version of the package. |
| 13 | You can also omit the changelog entry on the command line, and dch will open an editor for you. |
| 14 | |
| 15 | == change-log-mode == |
| 16 | |
| 17 | When you edit a `debian/changelog` file in Emacs, emacs should automatically enter `change-log-mode`. Useful commands: |
| 18 | - C-c C-v to add a new version entry |
| 19 | - C-c C-a to add a change entry to the current version |
| 20 | - C-c C-f to finalize the entry |
| 21 | |
| 22 | == Debathena versioning == |
| 23 | |
| 24 | When changing the main package source (that is, changing the software installed by the package, not the packaging itself), bump the upstream version number (to 10.0.0 if it was not already that high) Otherwise, just bump the Debian version component (change 0debathena1 to 0debathena2, for instance). |
| 25 | |
| 26 | The `dadch` utility in the debathena locker makes these calculations for you and invokes `dch` with the correct arguments. When using Emacs, you edit the version number by hand. |