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, dh_installchangelogs may look for files with names that
       seem likely to be changelogs as described in the next paragraphs
       (assuming the package is using compatibility level 7 or above).

       In non-native packages, dh_installchangelogs will first look for
       changelog files installed by the upstream build system into
       usr/share/doc/package (of the package build directory) and rename the
       most likely candidate (if any) to usr/share/doc/package/changelog.
       Note that dh_installchangelogs does not look into any source
       directory (such as debian/tmp). Otherwise, dh_installchangelogs (at
       compatibility level 7 or any later) will look for changelog files in
       the source directory (e.g. the root or the docs subdirectory).

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

       If the specified 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.

           Note that directory name of the changelog is also part of the

           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 [unknown --
       if you know, please contact] 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-10-29.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2018-10-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

11.5                             2018-10-28          DH_INSTALLCHANGELOGS(1)