1DH_INSTALLCHANGELOGS(1)            Debhelper           DH_INSTALLCHANGELOGS(1)
2
3
4

NAME

6       dh_installchangelogs - install changelogs into package build
7       directories
8

SYNOPSIS

10       dh_installchangelogs [debhelper options] [-k] [-Xitem] [upstream]
11

DESCRIPTION

13       dh_installchangelogs is a debhelper program that is responsible for
14       installing changelogs into package build directories.
15
16       An upstream changelog file may be specified as an option. If none is
17       specified, dh_installchangelogs may look for files with names that seem
18       likely to be changelogs as described in the next paragraphs (assuming
19       the package is using compatibility level 7 or above).
20
21       In non-native packages, dh_installchangelogs will first look for
22       changelog files installed by the upstream build system into
23       usr/share/doc/package (of the package build directory) and rename the
24       most likely candidate (if any) to usr/share/doc/package/changelog.
25       Note that dh_installchangelogs does not look into any source directory
26       (such as debian/tmp). Otherwise, dh_installchangelogs (at compatibility
27       level 7 or any later) will look for changelog files in the source
28       directory (e.g. the root or the docs subdirectory).
29
30       If there is an upstream changelog file, it will be installed as
31       usr/share/doc/package/changelog in the package build directory.
32
33       If the specified upstream changelog is an html file (determined by file
34       extension), it will be installed as
35       usr/share/doc/package/changelog.html instead. If the html changelog is
36       converted to plain text, that variant can be specified as a second
37       upstream changelog file. When no plain text variant is specified, a
38       short usr/share/doc/package/changelog is generated, pointing readers at
39       the html changelog file.
40

FILES

42       debian/changelog
43       debian/NEWS
44       debian/package.changelog
45       debian/package.NEWS
46           Automatically installed into usr/share/doc/package/ in the package
47           build directory.
48
49           Use the package specific name if package needs a different NEWS or
50           changelog file.
51
52           The changelog file is installed with a name of changelog for native
53           packages, and changelog.Debian for non-native packages.  The NEWS
54           file is always installed with a name of NEWS.Debian.
55

OPTIONS

57       -k, --keep
58           Keep the original name of the upstream changelog. This will be
59           accomplished by installing the upstream changelog as changelog, and
60           making a symlink from that to the original name of the changelog
61           file. This can be useful if the upstream changelog has an unusual
62           name, or if other documentation in the package refers to the
63           changelog file.
64
65       -Xitem, --exclude=item
66           Exclude upstream changelog files that contain item anywhere in
67           their filename from being installed.
68
69           Note that directory name of the changelog is also part of the
70           match.
71
72       upstream
73           Install this file as the upstream changelog.
74

SEE ALSO

76       debhelper(7)
77
78       This program is a part of debhelper.
79

AUTHOR

81       Joey Hess <joeyh@debian.org>
82
83
84
8512.7.3                            2020-07-27           DH_INSTALLCHANGELOGS(1)
Impressum