Changes between Version 1 and Version 2 of Changelog


Ignore:
Timestamp:
10/17/12 17:05:54 (12 years ago)
Author:
jdreed
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Changelog

    v1 v2  
    1 To prepare a change to a regular package (a source tree containing a 
    2 debian/ subdir), make the edits in a checkout and record a changelog 
    3 entry.  You can either edit debian/changelog using emacs changelog 
    4 mode (C-c C-v to add a new version entry, C-c C-a to add a change 
    5 entry, C-c C-f to finalize the entry) or you can run "dadch" from 
    6 the debathena locker / SVN scripts directory. 
     1 = Changelog = 
    72 
    8 When creating a new version entry, bump the upstream version number 
    9 (to 10.0.0 if it was not already that high) if you are changing the 
    10 main package source.  Otherwise, just bump the Debian version 
    11 component (change 0debathena1 to 0debathena2, for instance). 
     3The `debian/changelog` file contains entries for each version of the package, along with who made the changes, and what those changes are. 
    124 
     5You 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. 
     13You can also omit the changelog entry on the command line, and dch will open an editor for you. 
     14 
     15 == change-log-mode == 
     16 
     17When 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 
     24When 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 
     26The `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.