1dpkg-mergechangelogs(1) dpkg suite dpkg-mergechangelogs(1)
2
6 dpkg-mergechangelogs - 3-way merge of debian/changelog files
7
9 dpkg-mergechangelogs [option...] old new-a new-b [out]
10
12 This program will use the 3 provided versions of the Debian changelog
13 to generate a merged changelog file. The resulting changelog is stored
14 in the file out or output to the standard output if that parameter is
15 not given.
16 Each entry is identified by its version number and they are assumed to
18 be not conflicting, they are simply merged in the right order (by
19 decreasing version number). When --merge-prereleases is used, the part
20 of the version number after the last tilde is dropped so that
21 1.0-1~exp1 and 1.0-1~exp5 are considered to be the same entry. When the
22 same version is available in both new-a and new-b, a standard line-
23 based 3-way merge is attempted (provided that the module
24 Algorithm::Merge is available — it's part of the package libalgorithm-
25 merge-perl — otherwise you get a global conflict on the content of the
26 entry).
27
29 -m, --merge-prereleases
30 Drop the part after the last tilde in the version number when doing
31 version comparison to identify if two entries are supposed to be
32 the same or not.
33 This is useful when you keep using the same changelog entry but you
35 increase its version number regularly. For instance, you might have
36 2.3-1~exp1, 2.3-1~exp2, ... until the official release 2.3-1 and
37 they are all the same changelog entry that has evolved over time.
38 --help
40 Show the usage message and exit.
41 --version
43 Show the version and exit.
44
46 DPKG_COLORS
47 Sets the color mode (since dpkg 1.18.5). The currently accepted
48 values are: auto (default), always and never.
49 DPKG_NLS
51 If set, it will be used to decide whether to activate Native
52 Language Support, also known as internationalization (or i18n)
53 support (since dpkg 1.19.0). The accepted values are: 0 and 1
54 (default).
55
57 Anything that is not parsed by Dpkg::Changelog is lost during the
58 merge. This might include stuff like comments which were not supposed
59 to be there, etc.
60
62 If you want to use this program to merge Debian changelog files in a
63 git repository, you have first to register a new merge driver in
64 .git/config or ~/.gitconfig:
65 [merge "dpkg-mergechangelogs"]
67 name = debian/changelog merge driver
68 driver = dpkg-mergechangelogs -m %O %A %B %A
69 Then you have to setup the merge attribute for the debian/changelog
71 file either in .gitattributes in the repository itself, or in
72 .git/info/attributes:
73 debian/changelog merge=dpkg-mergechangelogs
751.20.9 2021-04-13 dpkg-mergechangelogs(1)