dpkg-mergechangelogs(1)                     dpkg suite                    dpkg-mergechangelogs(1)

NAME
       dpkg-mergechangelogs - 3-way merge of debian/changelog files

SYNOPSIS
       dpkg-mergechangelogs [option...] old new-a new-b [out]

DESCRIPTION
       This program will use the 3 provided versions of the Debian changelog to generate a merged
       changelog file. The resulting changelog is stored  in  the  file  out  or  output  to  the
       standard output if that parameter is not given.

       Each entry is identified by its version number and they are assumed to be not conflicting,
       they  are  simply  merged  in  the  right  order  (by  decreasing  version  number).  When
       --merge-prereleases  is  used,  the  part  of  the  version number after the last tilde is
       dropped so that 1.0-1~exp1 and 1.0-1~exp5 are considered to be the same  entry.  When  the
       same  version  is  available in both new-a and new-b, a standard line-based 3-way merge is
       attempted (provided that the module Algorithm::Merge is  available  —  it's  part  of  the
       package  libalgorithm-merge-perl  —  otherwise you get a global conflict on the content of
       the entry).

OPTIONS
       -m, --merge-prereleases
              Drop the part after the last  tilde  in  the  version  number  when  doing  version
              comparison to identify if two entries are supposed to be the same or not.

              This  is  useful  when you keep using the same changelog entry but you increase its
              version number regularly. For instance, you might have 2.3-1~exp1, 2.3-1~exp2,  ...
              until the official release 2.3-1 and they are all the same changelog entry that has
              evolved over time.

       --help Show the usage message and exit.

       --version
              Show the version and exit.

ENVIRONMENT
       DPKG_COLORS
              Sets the color mode (since dpkg 1.18.5).  The currently accepted values  are:  auto
              (default), always and never.

       DPKG_NLS
              If set, it will be used to decide whether to activate Native Language Support, also
              known as internationalization (or i18n) support (since dpkg 1.19.0).  The  accepted
              values are: 0 and 1 (default).

LIMITATIONS
       Anything  that  is  not  parsed  by  Dpkg::Changelog is lost during the merge.  This might
       include stuff like comments which were not supposed to be there, etc.

INTEGRATION WITH GIT
       If you want to use this program to merge Debian changelog files in a git  repository,  you
       have first to register a new merge driver in .git/config or ~/.gitconfig:

        [merge "dpkg-mergechangelogs"]
            name = debian/changelog merge driver
            driver = dpkg-mergechangelogs -m %O %A %B %A

       Then  you  have  to  setup  the  merge  attribute  for the debian/changelog file either in
       .gitattributes in the repository itself, or in .git/info/attributes:

        debian/changelog merge=dpkg-mergechangelogs

1.19.7                                      2019-06-03                    dpkg-mergechangelogs(1)

Usage: dpkg-mergechangelogs [<option>...] <old> <new-a> <new-b> [<out>]

Options:
  -m, --merge-prereleases  merge pre-releases together, ignores everything
                           after the last '~' in the version.
  -?, --help               show this help message.
      --version            show the version.
botond@asztali:~/Dokumentumok/manpages$ man dpkg-mergechangelogs > dpkg-mergechangelogs.man
botond@asztali:~/Dokumentumok/manpages$ dpkg-mergechangelogs --version
Debian dpkg-mergechangelogs version 1.19.7.

This is free software; see the GNU General Public License version 2 or
later for copying conditions. There is NO warranty.