Gentoo Archives: gentoo-user

From: Alan McKinnon <alan@××××××××××××××××.za>
To: gentoo-user@l.g.o
Subject: Re: [gentoo-user] Documentation annoyances
Date: Fri, 23 Feb 2007 08:06:40
Message-Id: 200702230956.03656.alan@linuxholdings.co.za
In Reply to: [gentoo-user] Documentation annoyances by Walter Dnes
1 On Friday 23 February 2007, Walter Dnes wrote:
2 > Thread re-named to reflect topic-drift
3 >
4 > On Wed, Feb 21, 2007 at 09:58:47AM +0200, Alan McKinnon wrote
5 >
6 > > On the one hand, /usr/share/doc has been almost 2G big (!) at
7 > > times, and otoh one can miss the really useful stuff....
8 >
9 > I wouldn't mind terribly if it was actually usable. I'd like to be
10 > able to bookmark the docs in my browser. Here's a list of what's
11 > available to me, even with "-doc"...
12 >
13 > [m3000][waltdnes][~] find /usr/share/doc/ -name "index.html"
14 > /usr/share/doc/freeglut-2.4.0/doc/index.html
15 [snip]
16 > /usr/share/doc/giflib-4.1.4/html/doc/index.html
17 >
18 > Guess what happens to the bookmarks next time there's a minor
19 > version bump to any of those programs (e.g. when I update world)? I
20 > suppose I should try to slap together a script that's run after
21 > emerge. It would run the "find" command above, process the output,
22 > and create a file ~/.docs.html with an unnumbered list of links to
23 > the actual
24 > documentation. Sounds like a plan.
25
26 How about asking for a feature request in portage?
27
28 Something like a "docsymlink" FEATURE which will create an unversioned
29 symlink in /usr/share/doc in the install function. Something like this:
30
31 ln -sfn /usr/share/doc/<app>-1.2.3 /usr/share/doc/<app>
32
33 Put the symlink in your bookmarks, not the actual file. If portage does
34 it for you, then you don't have to do it manually with every update
35
36 alan
37
38 --
39 Optimists say the glass is half full,
40 Pessimists say the glass is half empty,
41 Developers say wtf is the glass twice as big as it needs to be?
42
43 Alan McKinnon
44 alan at linuxholdings dot co dot za
45 +27 82, double three seven, one nine three five
46 --
47 gentoo-user@g.o mailing list