NAME         top

       dh_installchangelogs - install changelogs into package build

SYNOPSIS         top

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

DESCRIPTION         top

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

       An upstream changelog file may be specified as an option. If none is
       specified, it looks for files with names that seem likely to be
       changelogs.  (In compatibility level 7 and above.)

       If there is an upstream changelog file, it will be installed as
       usr/share/doc/package/changelog in the package build directory.

       If the upstream changelog is an html file (determined by file
       extension), it will be installed as
       usr/share/doc/package/changelog.html instead. If the html changelog
       is converted to plain text, that variant can be specified as a second
       upstream changelog file. When no plain text variant is specified, a
       short usr/share/doc/package/changelog is generated, pointing readers
       at the html changelog file.

FILES         top

           Automatically installed into usr/share/doc/package/ in the
           package build directory.

           Use the package specific name if package needs a different NEWS
           or changelog file.

           The changelog file is installed with a name of changelog for
           native packages, and changelog.Debian for non-native packages.
           The NEWS file is always installed with a name of NEWS.Debian.

OPTIONS         top

       -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.

       -Xitem, --exclude=item
           Exclude upstream changelog files that contain item anywhere in
           their filename from being installed.

           Install this file as the upstream changelog.

SEE ALSO         top


       This program is a part of debhelper.

AUTHOR         top

       Joey Hess <>

COLOPHON         top

       This page is part of the debhelper (helper programs for debian/rules)
       project.  Information about the project can be found at 
       ⟨⟩.  If you
       have a bug report for this manual page, send it to  This page was obtained from the project's
       upstream Git repository
       ⟨⟩ on
       2018-04-30.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-01-28.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

10.10.9                          2017-11-23          DH_INSTALLCHANGELOGS(1)