Gentoo Archives: gentoo-user

From: Walter Dnes <waltdnes@××××××××.org>
To: gentoo-user@l.g.o
Subject: [gentoo-user] Documentation annoyances
Date: Fri, 23 Feb 2007 03:58:47
Message-Id: 20070223035328.GA25681@waltdnes.org
1 Thread re-named to reflect topic-drift
2
3 On Wed, Feb 21, 2007 at 09:58:47AM +0200, Alan McKinnon wrote
4
5 > On the one hand, /usr/share/doc has been almost 2G big (!) at times, and
6 > otoh one can miss the really useful stuff....
7
8 I wouldn't mind terribly if it was actually usable. I'd like to be
9 able to bookmark the docs in my browser. Here's a list of what's
10 available to me, even with "-doc"...
11
12 [m3000][waltdnes][~] find /usr/share/doc/ -name "index.html"
13 /usr/share/doc/freeglut-2.4.0/doc/index.html
14 /usr/share/doc/libxslt-1.1.17/html/html/index.html
15 /usr/share/doc/libxslt-1.1.17/html/EXSLT/index.html
16 /usr/share/doc/libxslt-1.1.17/html/index.html
17 /usr/share/doc/lame-3.96.1/html/index.html
18 /usr/share/doc/libsdl-1.2.11/html/docs/html/index.html
19 /usr/share/doc/libsdl-1.2.11/html/docs/index.html
20 /usr/share/doc/flac-1.1.2-r8/html/ru/index.html
21 /usr/share/doc/flac-1.1.2-r8/html/index.html
22 /usr/share/doc/docbook-sgml-utils-0.6.14/html/index.html
23 /usr/share/doc/mutt-1.5.13-r1/index.html
24 /usr/share/doc/syslog-ng-1.6.11-r1/html/index.html
25 /usr/share/doc/libmpeg3-1.5.2-r3/html/docs/index.html
26 /usr/share/doc/libsndfile-1.0.17/html/index.html
27 /usr/share/doc/libvorbis-1.1.2/txt/doc/vorbisfile/index.html
28 /usr/share/doc/libvorbis-1.1.2/txt/doc/index.html
29 /usr/share/doc/libvorbis-1.1.2/txt/doc/vorbisenc/index.html
30 /usr/share/doc/tiff-3.8.2/html/man/index.html
31 /usr/share/doc/tiff-3.8.2/html/index.html
32 /usr/share/doc/python-xlib-0.12-r1/html/index.html
33 /usr/share/doc/transcode-1.0.2-r3/html/index.html
34 /usr/share/doc/imagemagick-6.3.0.5/html/www/Magick++/index.html
35 /usr/share/doc/imagemagick-6.3.0.5/html/www/index.html
36 /usr/share/doc/imagemagick-6.3.0.5/html/index.html
37 /usr/share/doc/gtklife-4.2/html/index.html
38 /usr/share/doc/gqview-2.0.1/html/index.html
39 /usr/share/doc/libogg-1.1.2/ogg/index.html
40 /usr/share/doc/libogg-1.1.2/index.html
41 /usr/share/doc/exiftool-6.44/html/TagNames/index.html
42 /usr/share/doc/exiftool-6.44/html/index.html
43 /usr/share/doc/ghostscript-esp-8.15.3/html/index.html
44 /usr/share/doc/giflib-4.1.4/html/doc/index.html
45
46 Guess what happens to the bookmarks next time there's a minor version
47 bump to any of those programs (e.g. when I update world)? I suppose I
48 should try to slap together a script that's run after emerge. It would
49 run the "find" command above, process the output, and create a file
50 ~/.docs.html with an unnumbered list of links to the actual
51 documentation. Sounds like a plan.
52
53 --
54 Walter Dnes <waltdnes@××××××××.org> In linux /sbin/init is Job #1
55 My musings on technology and security at http://techsec.blog.ca
56 --
57 gentoo-user@g.o mailing list

Replies

Subject Author
Re: [gentoo-user] Documentation annoyances Zac Medico <zmedico@g.o>
Re: [gentoo-user] Documentation annoyances Alan McKinnon <alan@××××××××××××××××.za>