Bug#632620: relies on <package>/usr/share/doc

[Niels Thykier]

On 2011-07-04 08:59, Rene Engelhard wrote:
> Package: javahelper
> Version: 0.36.1
> Severity: serious
> iJustification: policy 12.3
> 
> Hi.
> 
> From https://buildd.debian.org/status/fetch.php?pkg=libreoffice&arch=armel&ver=1%3A3.3.3-4&stamp=1309760289:
> 
> [...]
> jh_depends -a -Xlibreoffice-gcj -Xure
> find: `/build/buildd-libreoffice_3.3.3-4-armel-Mz0jMT/libreoffice-3.3.3/debian/libreoffice-base-core/usr/share/doc': No such file or directory
> make: *** [debian/stampdir/binary-arch] Error 1
> dpkg-buildpackage: error: fakeroot debian/rules binary-arch gave error exit status 2
> 
> Why does javahelper look in /usr/share/doc/? And why does it fail
> if it doesn't exist because it's just not built? (see my other bug).
> 

Most likely, this is the part that tries to calculate dependencies on
javadocs.  Anyhow, fixing this assumption is a good idea. :)

> Policy 12.3 (http://www.debian.org/doc/debian-policy/ch-docs.html):
> 
> "12.3 Additional documentation
> 
> Any additional documentation that comes with the package may be installed at the discretion of the package maintainer. Plain text documentation should be installed in the directory /usr/share/doc/package, where package is the name of the package, and compressed with gzip -9 unless it is small.
> [...]
> Packages must not require the existence of any files in /usr/share/doc/ in order to function [105]. Any files that are referenced by programs but are also useful as stand alone documentation should be installed under /usr/share/package/ with symbolic links from /usr/share/doc/package. "
> [...]
> "
> 
> Regards,
> 
> Rene
> 
>  [...]