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 1HKVRw-0006Da-1K for garchives@archives.gentoo.org; Fri, 23 Feb 2007 08:06:40 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.0/8.14.0) with SMTP id l1N84MVV031866; Fri, 23 Feb 2007 08:04:22 GMT Received: from cranium.sybase.co.za (sqlprd.sybase.co.za [192.96.139.1]) by robin.gentoo.org (8.14.0/8.14.0) with ESMTP id l1N7wRhG023984 for ; Fri, 23 Feb 2007 07:58:30 GMT Received: from localhost (cranium.sybase.co.za [127.0.0.1]) by cranium.sybase.co.za (Postfix) with ESMTP id 3A0618346C for ; Fri, 23 Feb 2007 10:06:21 +0200 (SAST) X-Virus-Scanned: amavisd-new at sybase.co.za Received: from cranium.sybase.co.za ([127.0.0.1]) by localhost (cranium.sybase.co.za [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Zhix5cXe8alV for ; Fri, 23 Feb 2007 10:06:10 +0200 (SAST) Received: from bard.sybase.co.za (bard.sybase.co.za [192.168.2.6]) by cranium.sybase.co.za (Postfix) with ESMTP id BD77B83462 for ; Fri, 23 Feb 2007 10:05:58 +0200 (SAST) Received: from nazgul.sybase.co.za ([192.168.2.68]) by bard.sybase.co.za with Microsoft SMTPSVC(6.0.3790.1830); Fri, 23 Feb 2007 09:59:57 +0200 From: Alan McKinnon To: gentoo-user@lists.gentoo.org Subject: Re: [gentoo-user] Documentation annoyances Date: Fri, 23 Feb 2007 09:56:03 +0200 User-Agent: KMail/1.9.6 References: <20070218053010.GA9098@waltdnes.org> <200702210958.47126.alan@linuxholdings.co.za> <20070223035328.GA25681@waltdnes.org> In-Reply-To: <20070223035328.GA25681@waltdnes.org> 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="iso-8859-1" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200702230956.03656.alan@linuxholdings.co.za> X-OriginalArrivalTime: 23 Feb 2007 07:59:57.0453 (UTC) FILETIME=[9C335BD0:01C75720] X-Archives-Salt: 7b78dd7c-0b75-4805-9f04-2ea78ff31d13 X-Archives-Hash: c7e4a26d5c31bd6d0b6056ee092e77b2 On Friday 23 February 2007, Walter Dnes wrote: > 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 [snip] > /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. How about asking for a feature request in portage? Something like a "docsymlink" FEATURE which will create an unversioned symlink in /usr/share/doc in the install function. Something like this: ln -sfn /usr/share/doc/-1.2.3 /usr/share/doc/ Put the symlink in your bookmarks, not the actual file. If portage does it for you, then you don't have to do it manually with every update alan -- Optimists say the glass is half full, Pessimists say the glass is half empty, Developers say wtf is the glass twice as big as it needs to be? Alan McKinnon alan at linuxholdings dot co dot za +27 82, double three seven, one nine three five -- gentoo-user@gentoo.org mailing list