DEBCHANGESection: User Commands (1)
Updated: Debian Utilities
Return to Main Contents
NAMEdebchange - Tool for maintenance of the debian/changelog file in a source package
SYNOPSISdebchange [options] [text ...]
dch [options] [text ...]
DESCRIPTIONdebchange or its alias dch will add a new comment line to the Debian changelog in the current source tree. This command must be run from withing that tree. If the text of the change is given on the commandline, debchange will run in batch mode and simply add the text, with line breaks as necessary, at the appropriate place in debian/changelog. If no text is specified then debchange will run the editor as determined by sensible-editor for you to edit the file. (The environment variables VISUAL and EDITOR are used in this order to determine which editor to use.) Editors which understand the +n option for starting the editing on a specified line will use this to move to the correct line of the file for editing. If the editor is quit without modifying the temporary file, debchange will exit without touching the existing changelog.
At most one of --append, --increment and --newversion may be specified as listed below. If no options are specified, dch will look for an appropriate dupload(1) or dput(1) log file in the parent directory to determine whether this version of the package has been uploaded successfully. It will behave as if --increment had been specified if a successful upload has been logged and as if --append had been specified otherwise. A warning will be issued if the log file is found but a successful upload is not recorded. This may be because the previous upload was performed with a version of dupload prior to 2.1 or because the upload failed.
If the directory name of the source tree has the form package-version, then debchange will also attempt to rename it if the (upstream) version number changes. This can be prevented by using the --preserve command line or configuration file option as described below.
OPTIONS--increment, -i Increment either the Debian release number or, if this is a native Debian package, the version number. This creates a new section at the beginning of the changelog with appropriate headers and footers. Also, if this is a new version of a native Debian package, the directory name is changed to reflect this.
SEE ALSOdebclean(1), dupload(1) dput(1) and debc(1).
AUTHORThe original author was Christoph Lameter <email@example.com>. Many substantial changes and improvements were made by Julian Gilbey <firstname.lastname@example.org>.
This document was created by man2html, using the manual pages.
Time: 20:28:09 GMT, October 24, 2021