1DH_INSTALLCHANGELOGS(1) Debhelper DH_INSTALLCHANGELOGS(1)
2
3
4
6 dh_installchangelogs - install changelogs into package build
7 directories
8
10 dh_installchangelogs [debhelperĀ options] [-k] [-Xitem] [upstream]
11
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
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
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
76 debhelper(7)
77
78 This program is a part of debhelper.
79
81 Joey Hess <joeyh@debian.org>
82
83
84
8512.7.3 2020-01-28 DH_INSTALLCHANGELOGS(1)