Re: Packages with documentation only in /usr/share/doc
On Sun, Feb 06, 2000 at 01:58:08AM +0000, Julian Gilbey was heard to say:
> On Sat, Feb 05, 2000 at 04:49:56PM -0500, Daniel Burrows wrote:
> > 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
>
> One other thing: it's not at all obvious to test for packages which
> don't manage to clean out the old /usr/doc directory when moving over
> to the new one, except by using bug reports :-(
Yeah, I agree that there isn't a perfect solution here, but the script was
meant to do exactly what you said: find packages whose preinst/postrm scripts
don't create the link in /usr/doc or leave cruft there. I'd like to file
bug reports against all packages that turn up this way, but I'm not sure
(a) what severity level is important -- should it be release-critical that a
package's documentation is in a non-standard location (I agree with Ben that
moving everything to /usr/share is a nice idea, but it doesn't look like
that'll happen in potato, and one place to go for docs is a really good idea)
(b) What should be done about transient problems? For example,
/usr/doc/xfree86-common is cruft on my system. On the other hand, the
ChangeLog claims that this problem is fixed. So the only people affected by it
are people who were tracking potato when the problem occured. Is it worth it
to file a bug saying that xfree86-common should clean up this one case, or
should I just rm the tree myself?
Anyway, here's a list of 'problematic' directories on my system, generated
automagically as above:
/usr/share/doc/HOWTO
/usr/share/doc/aalib-bin
/usr/share/doc/apache-common
/usr/share/doc/bison
/usr/share/doc/cdtool
/usr/share/doc/clanlib0-docs
/usr/share/doc/console-tools-libs
/usr/share/doc/cygnus-stylesheets
/usr/share/doc/dftp
/usr/share/doc/docbook
/usr/share/doc/dotfile
/usr/share/doc/dpkg-perl
/usr/share/doc/dpkg-python
/usr/share/doc/electric-fence
/usr/share/doc/eudc
/usr/share/doc/fakeroot
/usr/share/doc/gnome-print
/usr/share/doc/gpgp
/usr/share/doc/grub
/usr/share/doc/gwm
/usr/share/doc/gxset
/usr/share/doc/hello
/usr/share/doc/iamerican
/usr/share/doc/ibritish
/usr/share/doc/icewm-gnome
/usr/share/doc/imlib-base
/usr/share/doc/jdk1.1
/usr/share/doc/jdk1.1-dev
/usr/share/doc/kernel-image-2.2.13
/usr/share/doc/koth
/usr/share/doc/lftp
/usr/share/doc/libcomerr2
/usr/share/doc/libgsm1
/usr/share/doc/libnspr3
/usr/share/doc/libpanel-applet0
/usr/share/doc/libss2
/usr/share/doc/libwraster1
/usr/share/doc/linpopup
/usr/share/doc/manpages
/usr/share/doc/mnemonic-core
/usr/share/doc/mnemonic-lib-dom
/usr/share/doc/mnemonic-lib-gtklayout
/usr/share/doc/mnemonic-lib-layout
/usr/share/doc/mnemonic-lib-rasterimage
/usr/share/doc/mnemonic-lib-tcpconnection
/usr/share/doc/mnemonic-lib-url
/usr/share/doc/mnemonic-lib-w3render
/usr/share/doc/mnemonic-msg-client
/usr/share/doc/mnemonic-msg-demo
/usr/share/doc/mnemonic-msg-display
/usr/share/doc/mnemonic-msg-dom
/usr/share/doc/mnemonic-msg-gtkdisplay
/usr/share/doc/mnemonic-msg-network
/usr/share/doc/mnemonic-oil-csshandler
/usr/share/doc/mnemonic-oil-demo
/usr/share/doc/mnemonic-oil-filehandler
/usr/share/doc/mnemonic-oil-ftphandler
/usr/share/doc/mnemonic-oil-gtkclient
/usr/share/doc/mnemonic-oil-gtkdisplay
/usr/share/doc/mnemonic-oil-gtkimagedisplay
/usr/share/doc/mnemonic-oil-helpers
/usr/share/doc/mnemonic-oil-httphandler
/usr/share/doc/mnemonic-oil-xmlhandler
/usr/share/doc/navigator-base-47
/usr/share/doc/netpbm
/usr/share/doc/netpbm1
/usr/share/doc/netscape-java-47
/usr/share/doc/nfs-common
/usr/share/doc/openssl
/usr/share/doc/penguineyes-gnome
/usr/share/doc/php3-gd
/usr/share/doc/ppp
/usr/share/doc/python
/usr/share/doc/rplay-client
/usr/share/doc/rplay-server
/usr/share/doc/strace
/usr/share/doc/texmf
/usr/share/doc/vim-gtk
/usr/share/doc/vrms
/usr/share/doc/wdm
/usr/share/doc/wine-doc
/usr/share/doc/wmspaceweather
/usr/share/doc/workbone
/usr/share/doc/xanim-modules
/usr/share/doc/xfree86-common
/usr/share/doc/xmorph
/usr/share/doc/xserver-fbdev
/usr/share/doc/xserver-svga
/usr/share/doc/xserver-vga16
/usr/share/doc/zed
/usr/share/doc/zlib1
Daniel
--
All generalizations are dangerous.
Reply to: