From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.62) (envelope-from ) id 1HKRa3-00008N-5K for garchives@archives.gentoo.org; Fri, 23 Feb 2007 03:58:47 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.0/8.14.0) with SMTP id l1N3vdAX006948; Fri, 23 Feb 2007 03:57:39 GMT Received: from mailout1.igs.net (mailout1.igs.net [216.58.97.34]) by robin.gentoo.org (8.14.0/8.14.0) with ESMTP id l1N3rQsg002172 for ; Fri, 23 Feb 2007 03:53:27 GMT Received: from waltdnes.org (i209-195-87-24.cia.com [209.195.87.24]) by mailout1.igs.net (Postfix) with SMTP id 653D06AAE for ; Thu, 22 Feb 2007 22:53:25 -0500 (EST) Received: by waltdnes.org (sSMTP sendmail emulation); Thu, 22 Feb 2007 22:53:28 -0500 From: "Walter Dnes" Date: Thu, 22 Feb 2007 22:53:28 -0500 To: gentoo-user@lists.gentoo.org Subject: [gentoo-user] Documentation annoyances Message-ID: <20070223035328.GA25681@waltdnes.org> References: <20070218053010.GA9098@waltdnes.org> <200702191013.36320.alan@linuxholdings.co.za> <20070221012144.GA13692@waltdnes.org> <200702210958.47126.alan@linuxholdings.co.za> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-user@gentoo.org Reply-to: gentoo-user@lists.gentoo.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200702210958.47126.alan@linuxholdings.co.za> User-Agent: Mutt/1.5.13 (2006-08-11) X-Archives-Salt: 70073b35-21b3-4eba-b850-07ebf787ee2a X-Archives-Hash: 2175385dc85a6e66ecfe4022a18f48cf 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 In linux /sbin/init is Job #1 My musings on technology and security at http://techsec.blog.ca -- gentoo-user@gentoo.org mailing list