.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "DH_INSTALLCHANGELOGS 1"
.TH DH_INSTALLCHANGELOGS 1 "2017-01-25" "10.2.5" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
dh_installchangelogs \- install changelogs into package build directories
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdh_installchangelogs\fR [\fIdebhelper options\fR] [\fB\-k\fR] [\fB\-X\fR\fIitem\fR] [\fIupstream\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdh_installchangelogs\fR is a debhelper program that is responsible for
installing changelogs into package build directories.
.PP
An upstream \fIchangelog\fR 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.)
.PP
If there is an upstream \fIchangelog\fR file, it will be installed as
\&\fIusr/share/doc/package/changelog\fR in the package build directory.
.PP
If the upstream changelog is an \fIhtml\fR file (determined by file
extension), it will be installed as \fIusr/share/doc/package/changelog.html\fR
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 \fIusr/share/doc/package/changelog\fR
is generated, pointing readers at the html changelog file.
.SH "FILES"
.IX Header "FILES"
.IP "\fIdebian/changelog\fR" 4
.IX Item "debian/changelog"
.PD 0
.IP "\fIdebian/NEWS\fR" 4
.IX Item "debian/NEWS"
.IP "debian/\fIpackage\fR.changelog" 4
.IX Item "debian/package.changelog"
.IP "debian/\fIpackage\fR.NEWS" 4
.IX Item "debian/package.NEWS"
.PD
Automatically installed into usr/share/doc/\fIpackage\fR/
in the package build directory.
.Sp
Use the package specific name if \fIpackage\fR needs a different
\&\fI\s-1NEWS\s0\fR or \fIchangelog\fR file.
.Sp
The \fIchangelog\fR file is installed with a name of changelog
for native packages, and \fIchangelog.Debian\fR for non-native packages.
The \fI\s-1NEWS\s0\fR file is always installed with a name of \fI\s-1NEWS\s0.Debian\fR.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-k\fR, \fB\-\-keep\fR" 4
.IX Item "-k, --keep"
Keep the original name of the upstream changelog. This will be accomplished
by installing the upstream changelog as \fIchangelog\fR, and making a symlink from
that to the original name of the \fIchangelog\fR file. This can be useful if the
upstream changelog has an unusual name, or if other documentation in the
package refers to the \fIchangelog\fR file.
.IP "\fB\-X\fR\fIitem\fR, \fB\-\-exclude=\fR\fIitem\fR" 4
.IX Item "-Xitem, --exclude=item"
Exclude upstream \fIchangelog\fR files that contain \fIitem\fR anywhere in their
filename from being installed.
.IP "\fIupstream\fR" 4
.IX Item "upstream"
Install this file as the upstream changelog.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIdebhelper\fR\|(7)
.PP
This program is a part of debhelper.
.SH "AUTHOR"
.IX Header "AUTHOR"
Joey Hess <joeyh@debian.org>