Bug#656311: maven-debian-helper: debian.maven.plugin.SysInstallDocMojo installs code jar instead of javadoc

[Dennis van Dok (Software Engineer)]

Package: maven-debian-helper
Version: 1.4.4
Severity: normal


When using the maven cdbs class, a jar file that presumably should contain all
the generated javadoc is installed under /usr/share/maven-repo/. However, this
jar file actually contains all the class files and is basically the same as the
main jar file for the package.

The -javadoc.jar is created as part of the normal build, but the install step
copies the wrong source. The code that is responsible for this copy action is
called SysInstallDocMojo.

I found many *-java-doc packages that suffer from having the wrong jar file. It
can be observed e.g. as follows:

wget http://ftp.us.debian.org/debian/pool/main/libx/libxml-security-java/libxml-security-java-doc_1.4.5-1_all.deb
dpkg-deb --extract /private/home/dennis/Downloads/libxml-security-java-doc_1.4.5-1_all.deb binary-libxml-security-java-doc-root
jar tf binary-libxml-security-java-doc-root/usr/share/maven-repo/org/apache/santuario/xmlsec/1.4.5/xmlsec-1.4.5-javadoc.jar 

I'm running Ubuntu oneiric, so the versions I have are somewhat behind, but I
did check the latest version of maven-debian-helper in sid and found the issue
persists there.

-- System Information:
Debian Release: wheezy/sid
  APT prefers oneiric-updates
  APT policy: (500, 'oneiric-updates'), (500, 'oneiric-security'), (500, 'oneiric-proposed'), (500, 'oneiric')
Architecture: amd64 (x86_64)

Kernel: Linux 3.0.0-15-generic (SMP w/2 CPU cores)
Locale: LANG=nl_NL.UTF-8, LC_CTYPE=nl_NL.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages maven-debian-helper depends on:
ii  default-jdk              1:1.6-42ubuntu2 Standard Java or Java compatible D
ii  libmaven-clean-plugin-ja 2.3-3           Maven clean plugin
ii  libmaven-compiler-plugin 2.0.2-4         Maven compiler plugin
ii  libmaven-jar-plugin-java 2.2-4           Maven Jar plugin
ii  libmaven-resources-plugi 2.3-5           Maven resources plugin
ii  libmaven-site-plugin-jav 2.1-1           Maven Site Plugin for generating a
ii  libplexus-velocity-java  1.1.7-3         Plexus component interface to velo
ii  libsurefire-java         2.4.3-4         Surefire test framework for Java
ii  maven-repo-helper        1.5.2           Helper tools for including Maven m
ii  maven2                   2.2.1-7build1   Java software project management a
ii  velocity                 1.6.2-4         Java-based template engine for web

maven-debian-helper recommends no packages.

Versions of packages maven-debian-helper suggests:
ii  apt-file             2.5.0ubuntu1        search for files within Debian pac
ii  devscripts           2.11.1ubuntu3       scripts to make the life of a Debi
ii  libmaven-javadoc-plu 2.6.1-1             Maven Javadoc Plugin
ii  subversion           1.6.12dfsg-4ubuntu5 Advanced version control system

-- no debconf information