public inbox for gentoo-user@lists.gentoo.org
 help / color / mirror / Atom feed
From: "Walter Dnes" <waltdnes@waltdnes.org>
To: gentoo-user@lists.gentoo.org
Subject: [gentoo-user] Documentation annoyances
Date: Thu, 22 Feb 2007 22:53:28 -0500	[thread overview]
Message-ID: <20070223035328.GA25681@waltdnes.org> (raw)
In-Reply-To: <200702210958.47126.alan@linuxholdings.co.za>

  Thread re-named to reflect topic-drift

On Wed, Feb 21, 2007 at 09:58:47AM +0200, Alan McKinnon wrote

> On the one hand, /usr/share/doc has been almost 2G big (!) at times, and 
> otoh one can miss the really useful stuff....

  I wouldn't mind terribly if it was actually usable.  I'd like to be
able to bookmark the docs in my browser.  Here's a list of what's
available to me, even with "-doc"...

[m3000][waltdnes][~] find /usr/share/doc/ -name "index.html"
/usr/share/doc/freeglut-2.4.0/doc/index.html
/usr/share/doc/libxslt-1.1.17/html/html/index.html
/usr/share/doc/libxslt-1.1.17/html/EXSLT/index.html
/usr/share/doc/libxslt-1.1.17/html/index.html
/usr/share/doc/lame-3.96.1/html/index.html
/usr/share/doc/libsdl-1.2.11/html/docs/html/index.html
/usr/share/doc/libsdl-1.2.11/html/docs/index.html
/usr/share/doc/flac-1.1.2-r8/html/ru/index.html
/usr/share/doc/flac-1.1.2-r8/html/index.html
/usr/share/doc/docbook-sgml-utils-0.6.14/html/index.html
/usr/share/doc/mutt-1.5.13-r1/index.html
/usr/share/doc/syslog-ng-1.6.11-r1/html/index.html
/usr/share/doc/libmpeg3-1.5.2-r3/html/docs/index.html
/usr/share/doc/libsndfile-1.0.17/html/index.html
/usr/share/doc/libvorbis-1.1.2/txt/doc/vorbisfile/index.html
/usr/share/doc/libvorbis-1.1.2/txt/doc/index.html
/usr/share/doc/libvorbis-1.1.2/txt/doc/vorbisenc/index.html
/usr/share/doc/tiff-3.8.2/html/man/index.html
/usr/share/doc/tiff-3.8.2/html/index.html
/usr/share/doc/python-xlib-0.12-r1/html/index.html
/usr/share/doc/transcode-1.0.2-r3/html/index.html
/usr/share/doc/imagemagick-6.3.0.5/html/www/Magick++/index.html
/usr/share/doc/imagemagick-6.3.0.5/html/www/index.html
/usr/share/doc/imagemagick-6.3.0.5/html/index.html
/usr/share/doc/gtklife-4.2/html/index.html
/usr/share/doc/gqview-2.0.1/html/index.html
/usr/share/doc/libogg-1.1.2/ogg/index.html
/usr/share/doc/libogg-1.1.2/index.html
/usr/share/doc/exiftool-6.44/html/TagNames/index.html
/usr/share/doc/exiftool-6.44/html/index.html
/usr/share/doc/ghostscript-esp-8.15.3/html/index.html
/usr/share/doc/giflib-4.1.4/html/doc/index.html

  Guess what happens to the bookmarks next time there's a minor version
bump to any of those programs (e.g. when I update world)?  I suppose I
should try to slap together a script that's run after emerge.  It would
run the "find" command above, process the output, and create a file
~/.docs.html with an unnumbered list of links to the actual
documentation.  Sounds like a plan.

-- 
Walter Dnes <waltdnes@waltdnes.org> In linux /sbin/init is Job #1
My musings on technology and security at http://techsec.blog.ca
-- 
gentoo-user@gentoo.org mailing list



  parent reply	other threads:[~2007-02-23  3:58 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2007-02-18  5:30 [gentoo-user] Cryptic warning message x11-drivers:ati-drivers-8.32.5 build Walter Dnes
2007-02-19  8:13 ` Alan McKinnon
2007-02-21  1:21   ` Walter Dnes
     [not found]     ` <200702210958.47126.alan@linuxholdings.co.za>
2007-02-23  3:53       ` Walter Dnes [this message]
2007-02-23  4:06         ` [gentoo-user] Documentation annoyances Zac Medico
2007-02-23  7:58           ` Alan McKinnon
2007-02-24 20:05           ` Walter Dnes
2007-02-23  7:56         ` Alan McKinnon

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20070223035328.GA25681@waltdnes.org \
    --to=waltdnes@waltdnes.org \
    --cc=gentoo-user@lists.gentoo.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox