man-pages/man1/dh_installchangelogs.1.html
2021-03-31 01:06:50 +01:00

149 lines
3.7 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of DH_INSTALLCHANGELOGS</TITLE>
</HEAD><BODY>
<H1>DH_INSTALLCHANGELOGS</H1>
Section: Debhelper (1)<BR>Updated: 2020-03-27<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
dh_installchangelogs - install changelogs into package build directories
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>dh_installchangelogs</B> [<I>debhelper options</I>] [<B>-k</B>] [<B>-X</B><I>item</I>] [<I>upstream</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>dh_installchangelogs</B> is a debhelper program that is responsible for
installing changelogs into package build directories.
<P>
An upstream <I>changelog</I> file may be specified as an option.
<P>
If there is an upstream <I>changelog</I> file, it will be installed as
<I>usr/share/doc/package/changelog</I> in the package build directory.
<P>
If the specified upstream changelog is an <I>html</I> file (determined by file
extension), it will be installed as <I>usr/share/doc/package/changelog.html</I>
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 <I>usr/share/doc/package/changelog</I>
is generated, pointing readers at the html changelog file.
<A NAME="lbAE">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="1"><I>debian/changelog</I><DD>
<DT id="2"><I>debian/NEWS</I><DD>
<DT id="3">debian/<I>package</I>.changelog<DD>
<DT id="4">debian/<I>package</I>.NEWS<DD>
Automatically installed into usr/share/doc/<I>package</I>/
in the package build directory.
<P>
Use the package specific name if <I>package</I> needs a different
<I></I><FONT SIZE="-1"><I>NEWS</I></FONT><I></I> or <I>changelog</I> file.
<P>
The <I>changelog</I> file is installed with a name of changelog
for native packages, and <I>changelog.Debian</I> for non-native packages.
The <I></I><FONT SIZE="-1"><I>NEWS</I></FONT><I></I> file is always installed with a name of <I></I><FONT SIZE="-1"><I>NEWS</I></FONT><I>.Debian</I>.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="5"><B>-k</B>, <B>--keep</B><DD>
Keep the original name of the upstream changelog. This will be accomplished
by installing the upstream changelog as <I>changelog</I>, and making a symlink from
that to the original name of the <I>changelog</I> file. This can be useful if the
upstream changelog has an unusual name, or if other documentation in the
package refers to the <I>changelog</I> file.
<DT id="6"><B>-X</B><I>item</I>, <B>--exclude=</B><I>item</I><DD>
Exclude upstream <I>changelog</I> files that contain <I>item</I> anywhere in their
filename from being installed.
<P>
Note that directory name of the changelog is also part of the match.
<DT id="7"><I>upstream</I><DD>
Install this file as the upstream changelog.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
<P>
This program is a part of debhelper.
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
Joey Hess &lt;<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="8"><A HREF="#lbAB">NAME</A><DD>
<DT id="9"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="10"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="11"><A HREF="#lbAE">FILES</A><DD>
<DT id="12"><A HREF="#lbAF">OPTIONS</A><DD>
<DT id="13"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="14"><A HREF="#lbAH">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:10 GMT, March 31, 2021
</BODY>
</HTML>