Packages with documentation only in /usr/share/doc

[Daniel Burrows <Daniel_Burrows@brown.edu>]

  What should be done about packages that have documentation in /usr/share/doc
but not in /usr/doc (ie, no symlink..for example, grub) or (worse) have some
sort of messed up situation where /usr/doc/<package> gets removed from the dpkg
database but the directory is still there (python did this for a while..it left
a .dhelp file behind and the directory couldn't be deleted), or where the
documentation is split between /usr/doc and /usr/share/doc?

  In other words, is it necessary to fix these before potato is released, and
would it be ok to mass-file important bugs against such packages?  It's fairly
simple to write a script that at least tries to find packages that do this:

for i in /usr/share/doc/*; do
  if [ -d $i ] && ! [ -l /usr/doc/`basename $i` ]; then echo $i
  else; if [ -l $i && ! [ -l /usr/doc/`basename $i`]; then echo $i; fi; fi
done

  (this should probably check that the links point at the right place, maybe
using the readlink program..)

  Daniel

-- 
The only thing worse than infinite recursion is infinite recursion.