Bug#794539: llvm-3.7-doc and clang-3.7-doc: error when trying to install together

[Ralf Treinen]

Package: clang-3.7-doc,llvm-3.7-doc
Version: clang-3.7-doc'1:3.7~svn239806-1 at all, clang-3.7-doc'1:3.7~svn230892-1 at all, clang-3.7-doc/1:3.7~+rc2-1
Version: llvm-3.7-doc'1:3.7~svn239806-1 at all, llvm-3.7-doc'1:3.7~svn230892-1 at all, llvm-3.7-doc/1:3.7~+rc2-1
Severity: serious
User: treinen at debian.org
Usertags: edos-file-overwrite

Date: 2015-08-04
Architecture: amd64
Distribution: sid

Hi,

automatic installation tests of packages that share a file and at the
same time do not conflict by their package dependency relationships has
detected the following problem:


Selecting previously unselected package clang-3.7-doc.
(Reading database ... 10901 files and directories currently installed.)
Preparing to unpack .../clang-3.7-doc_1%3a3.7~+rc2-1_all.deb ...
Unpacking clang-3.7-doc (1:3.7~+rc2-1) ...
Selecting previously unselected package libjs-jquery.
Preparing to unpack .../libjs-jquery_1.7.2+dfsg-3.2_all.deb ...
Unpacking libjs-jquery (1.7.2+dfsg-3.2) ...
Selecting previously unselected package libjs-underscore.
Preparing to unpack .../libjs-underscore_1.7.0~dfsg-1_all.deb ...
Unpacking libjs-underscore (1.7.0~dfsg-1) ...
Selecting previously unselected package llvm-3.7-doc.
Preparing to unpack .../llvm-3.7-doc_1%3a3.7~+rc2-1_all.deb ...
Unpacking llvm-3.7-doc (1:3.7~+rc2-1) ...
dpkg: error processing archive /var/cache/apt/archives/llvm-3.7-doc_1%3a3.7~+rc2-1_all.deb (--unpack):
 trying to overwrite '/usr/lib/llvm-3.7/docs/llvm/html/Dummy.html', which is also in package clang-3.7-doc 1:3.7~+rc2-1
dpkg-deb: error: subprocess paste was killed by signal (Broken pipe)
Errors were encountered while processing:
 /var/cache/apt/archives/llvm-3.7-doc_1%3a3.7~+rc2-1_all.deb
E: Sub-process /usr/bin/dpkg returned an error code (1)


This is a serious bug as it makes installation fail, and violates
sections 7.6.1 and 10.1 of the policy. An optimal solution would
consist in only one of the packages installing that file, and renaming
or removing the file in the other package. Depending on the
circumstances you might also consider Replace relations or file
diversions. If the conflicting situation cannot be resolved then, as a
last resort, the two packages have to declare a mutual
Conflict. Please take into account that Replaces, Conflicts and
diversions should only be used when packages provide different
implementations for the same functionality.

Here is a list of files that are known to be shared by both packages
(according to the Contents file for sid/amd64, which may be
slightly out of sync):

  /usr/lib/llvm-3.7/docs/llvm/html/Dummy.html
  /usr/lib/llvm-3.7/docs/llvm/html/LibASTMatchersReference.html

This bug has been filed against both packages. If you, the maintainers of
the two packages in question, have agreed on which of the packages will
resolve the problem please reassign the bug to that package. You may then
also register in the BTS that the other package is affected by the bug.

-Ralf.

PS: for more information about the detection of file overwrite errors
of this kind see http://qa.debian.org/dose/file-overwrites.html.