[Python-apps-team] Bug#691704: /usr/share/doc/cython-dbg is empty on upgrade

[Andreas Beckmann]

Followup-For: Bug #691704
Control: found -1 0.19+git51-g3078752-1

> cython (0.19+git51-g3078752-1) unstable; urgency=low
>   * debian/rules
>     - use explicit --link-doc for dh_installdocs to get correct
>       links for doc/ directories of -dbg packages

That does not fix the upgrade issue.

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/cython-dbg/copyright
  # ls -lad /usr/share/doc/cython-dbg
  drwxr-xr-x 2 root root 40 May  8 23:22 /usr/share/doc/cython-dbg
  # ls -la /usr/share/doc/cython-dbg/
  total 0
  drwxr-xr-x  2 root root   40 May  8 23:22 .
  drwxr-xr-x 89 root root 1900 May  8 23:22 ..


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: cython-dbg_0.19+git51-g3078752-1.log.gz
Type: application/x-gzip
Size: 15725 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/python-apps-team/attachments/20130511/767e2c0f/attachment-0001.bin>