NAME

       dh_installchangelogs - install changelogs into package build directories

SYNOPSIS

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

DESCRIPTION

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

       debian/changelog
       debian/NEWS
       debian/package.changelog
       debian/package.NEWS
           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

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

       --no-trim
           Install the full changelog, not its trimmed version that includes only recent entries.

       upstream
           Install this file as the upstream changelog.

SEE ALSO

       debhelper(7)

       This program is a part of debhelper.

AUTHOR

       Joey Hess <joeyh@debian.org>

13.14.1ubuntu5                                     2024-03-01                            DH_INSTALLCHANGELOGS(1)