dh_installchangelogs(1) — Linux manual page



NAME         top

       dh_installchangelogs - install changelogs into package build

SYNOPSIS         top

       dh_installchangelogs [debhelper options] [-k] [-Xitem]
       [--no-trim] [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

       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).  It will look for
       changelog, changes and history optionally with common extensions
       (such as .txt, .md and .rst).

       If a changelog file is specified and 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 parameter. When no plain text variant is
       specified, a short usr/share/doc/package/changelog is generated,
       pointing readers at the html changelog file.

       The debchange-style Debian changelogs are trimmed to include only
       entries more recent than the release date of oldstable.  No
       trimming will be performed if the --no-trim option is passed or
       if the DEB_BUILD_OPTIONS environment variable contains notrimdch.

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

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 the full changelog, not its trimmed version that
           includes only recent entries.

           Install this file as the upstream changelog.

SEE ALSO         top


       This program is a part of debhelper.

AUTHOR         top

       Joey Hess <joeyh@debian.org>

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 man-
       pages@man7.org] If you have a bug report for this manual page,
       send it to submit@bugs.debian.org.  This page was obtained from
       the project's upstream Git repository
       ⟨https://salsa.debian.org/debian/debhelper.git⟩ on 2024-06-14.
       (At that time, the date of the most recent commit that was found
       in the repository was 2024-06-09.)  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

13.15.3                        2024-06-07        DH_INSTALLCHANGELOGS(1)

Pages that refer to this page: debhelper(7)