dh_installchangelogs - install changelogs into package build directories


dh_installchangelogs [debhelper options] [-k] [upstream]


dh_installchangelogs is a debhelper program that is responsible for installing changelogs into package build directories.

dh_installchangelogs determines if the package is a debian native package, and if so, it installs debian/changelog into usr/share/doc/package/changelog in the package build directory. Otherwise, it installs debian/changelog into usr/share/doc/package/changelog.Debian in the package build directory. (If files named debian/package.changelog exist, they will be used in preference to debian/changelog.)

Parallelling the debian changelog handling, this program also takes care of NEWS.Debian files. If there is a debian/NEWS file, it is installed as usr/share/doc/package/NEWS.Debian. debian/package.NEWS files can also be used.

An upstream changelog file may be specified as an option. If none is specified, a few common filenames are tried. (In compatibility level 7 and above.)

If there is an upstream changelog file, it will be be installed as usr/share/doc/package/changelog in the package build directory. If the changelog is a html file (determined by file extension), it will be installed as usr/share/doc/package/changelog.html instead, and will be converted to plain text with html2text to generate usr/share/doc/package/changelog.


-k, --keep
Keep the original name of the upstream changelog. This will be accomplished by installing the upstream changelog as "changelog", and making a symlink from that to the original name of the changelog file. This can be useful if the upstream changelog has an unusual name, or if other documentation in the package refers to the changelog file.
Install this file as the upstream changelog.



This program is a part of debhelper.


Joey Hess <>