[pkg-GD-devel] Bug#708111: libgd2-xpm-dev, libgd2-noxpm-dev: copyright file missing after upgrade (policy 12.5)

[Andreas Beckmann]

Package: libgd2-xpm-dev,libgd2-noxpm-dev
Version: 2.1.0~alpha~8+ecc535-2
Severity: serious
User: debian-qa at lists.debian.org
Usertags: piuparts

Hi,

a test with piuparts revealed that your package misses the copyright
file after an upgrade, which is a violation of Policy 12.5:
http://www.debian.org/doc/debian-policy/ch-docs.html#s-copyrightfile

After the upgrade /usr/share/doc/$PACKAGE/ is just an empty directory.

This was observed on the following upgrade paths:

  sid -> experimental

>From the attached log (scroll to the bottom...):

  MISSING COPYRIGHT FILE: /usr/share/doc/libgd2-noxpm-dev/copyright
  # ls -lad /usr/share/doc/libgd2-noxpm-dev
  drwxr-xr-x 2 root root 40 May 11 21:30 /usr/share/doc/libgd2-noxpm-dev
  # ls -la /usr/share/doc/libgd2-noxpm-dev/
  total 0
  drwxr-xr-x   2 root root   40 May 11 21:30 .
  drwxr-xr-x 133 root root 2760 May 11 21:30 ..


Additional info may be available here:
http://wiki.debian.org/MissingCopyrightFile

Note that dpkg intentionally does not replace directories with symlinks
and vice versa, you need the maintainer scripts to do this.
See in particular the end of point 4 in
http://www.debian.org/doc/debian-policy/ch-maintainerscripts.html#s-unpackphase

For switching from a directory to a symlink the *postinst* script
should do something like this:

        DOCDIR=/usr/share/doc/@@PACKAGE@@
        DOCLINK=@@OTHERPACKAGE@@

        if [ -d $DOCDIR ] && [ ! -L $DOCDIR ]; then
                rmdir $DOCDIR
                ln -s $DOCLINK $DOCDIR
        fi

For switching from a symlink to a directory, the *preinst* script
should do something like this:

        DOCDIR=/usr/share/doc/@@PACKAGE@@

        if [ -L $DOCDIR ]; then
                rm $DOCDIR
        fi


cheers,

Andreas
-------------- next part --------------
A non-text attachment was scrubbed...
Name: libgd2-xpm-dev_2.1.0~alpha~8+ecc535-2.log.gz
Type: application/x-gzip
Size: 14520 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-gd-devel/attachments/20130513/24462102/attachment.bin>