[pkg-fso-maint] Bug#715453: libfsotransport3: copyright file missing after upgrade (policy 12.5)

[Andreas Beckmann]

Package: libfsotransport3
Version: 0.12.0-1
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:

  wheezy -> sid

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

  MISSING COPYRIGHT FILE: /usr/share/doc/libfsotransport3/copyright
  # ls -lad /usr/share/doc/libfsotransport3
  drwxr-xr-x 2 root root 40 Jun 24 23:48 /usr/share/doc/libfsotransport3
  # ls -la /usr/share/doc/libfsotransport3/
  total 0
  drwxr-xr-x  2 root root   40 Jun 24 23:48 .
  drwxr-xr-x 87 root root 1840 Jun 24 23:48 ..


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: libfsotransport3_0.12.0-1.log.gz
Type: application/x-gzip
Size: 19323 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-fso-maint/attachments/20130709/2ba3223f/attachment-0001.bin>