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/<app>-1.2.3 /usr/share/doc/<app>

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

Reply via email to