dh_installchangelogs (1)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man1/dh_installchangelogs.1".)

NAME

dh_installchangelogs - install changelogs into package build directories

SYNOPSIS

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

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.

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>