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 <gentoo-user+bounces-66147-garchives=archives.gentoo.org@gentoo.org>)
	id 1I66Ql-0006Ud-3F
	for garchives@archives.gentoo.org; Wed, 04 Jul 2007 15:06:11 +0000
Received: from robin.gentoo.org (localhost [127.0.0.1])
	by robin.gentoo.org (8.14.0/8.14.0) with SMTP id l64F4gTg002041;
	Wed, 4 Jul 2007 15:04:42 GMT
Received: from an-out-0708.google.com (an-out-0708.google.com [209.85.132.250])
	by robin.gentoo.org (8.14.0/8.14.0) with ESMTP id l64Exhwg027481
	for <gentoo-user@lists.gentoo.org>; Wed, 4 Jul 2007 14:59:44 GMT
Received: by an-out-0708.google.com with SMTP id c8so489681ana
        for <gentoo-user@lists.gentoo.org>; Wed, 04 Jul 2007 07:59:43 -0700 (PDT)
DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed;
        d=gmail.com; s=beta;
        h=domainkey-signature:received:received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:references;
        b=lCpObij86tgjcuOsSSh/oNPEELQmUY00WBR5p/XeBi/dr7H4y3j2HdI6yGE2Ql8BhTdNm2FSayJoOFMIfuM3xWndga8NXbPDpXIU6ttXDmgbQGqf1piW1mTuaWdWADXK+UMqWI9N+ApbL/pFm5KD/865bWFCL9rb/fG/71behb4=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=beta;
        h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:references;
        b=L43/xJLl7GLU40hmj6q5Ksaip8nS+4Vg2WDT016w+iTADrIMKSsCOAOk5yRxgdrY5NgjOrl//rjRSQH5wX/1H66L/F1XbycTnAlnFBcTT4F5HEtwljaizCpFEVHXObbL/W1nTIJyjbHb2o/V2FbRuczqy2VcrPV55YxUwj23wik=
Received: by 10.100.194.7 with SMTP id r7mr4857026anf.1183561183008;
        Wed, 04 Jul 2007 07:59:43 -0700 (PDT)
Received: by 10.100.37.16 with HTTP; Wed, 4 Jul 2007 07:59:42 -0700 (PDT)
Message-ID: <9acccfe50707040759t31e42b88t1015951a0627f654@mail.gmail.com>
Date: Wed, 4 Jul 2007 07:59:42 -0700
From: "Kevin O'Gorman" <kogorman@gmail.com>
To: gentoo-user@lists.gentoo.org
Subject: Re: [gentoo-user] Index to /usr/share/doc/...html... a reinvented wheel?
In-Reply-To: <200707040519.18952.nagatoro@gmail.com>
Precedence: bulk
List-Post: <mailto:gentoo-user@lists.gentoo.org>
List-Help: <mailto:gentoo-user+help@gentoo.org>
List-Unsubscribe: <mailto:gentoo-user+unsubscribe@gentoo.org>
List-Subscribe: <mailto:gentoo-user+subscribe@gentoo.org>
List-Id: Gentoo Linux mail <gentoo-user.gentoo.org>
X-BeenThere: gentoo-user@gentoo.org
Reply-to: gentoo-user@lists.gentoo.org
MIME-Version: 1.0
Content-Type: multipart/alternative; 
	boundary="----=_Part_141116_3718176.1183561182972"
References: <9acccfe50707031519w73abc638qb001cc5e9bb64d88@mail.gmail.com>
	 <200707040519.18952.nagatoro@gmail.com>
X-Archives-Salt: e4bd5f11-f5a8-48e5-99d2-6e3c5aca07f8
X-Archives-Hash: e8865a3ecebe440d24810204e2f82ee0

------=_Part_141116_3718176.1183561182972
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

On 7/3/07, Naga <nagatoro@gmail.com> wrote:
>
> On Wednesday 04 July 2007 00:19:14 Kevin O'Gorman wrote:
> > Did I just reinvent a wheel? If not, is there any point it trying to
> make
> > this part of gentoo?  If so, how would one do that?
>
> See DOC_SYMLINKS_DIR in make.conf (man page I think, or .example)


Thanks, I was able to track it down from that hint.

For the record:
   Read about it in "man make.conf".

The description there is quite sparse, and I haven't done any emerges since
I set it,
so I'm not sure exactly how it works.  I think it just sets
version-independent symlinks,
and leaves it up to you whether to bookmark them.

Unless there's more going on, I'm going to prefer my little script.  It
builds a web page
with current links, organized by package.  I run it in a cron job several
times a week,
so it's pretty much up-to-date.    These are all listed unless they are
linked from another
index.html higher in the directory structure.  This makes most of the
entries pretty clean, with
a few notable exceptions: boost, java, apache, drscheme, python-docs and
mplayer among the packages I have.  I'll probably tweak these when I get
some time.

For me the main advantage is in doing a quick check to see if a given
package actually has
any "index.html" files anywhere under /usr/share/doc.  Just browsing to the
index
file can be a pain sometimes, and my patience is usually thinner than usual
when
I'm desperately seeking documentation.

So: am I the only one who likes this?

++ kevin


-- 
Kevin O'Gorman, PhD

------=_Part_141116_3718176.1183561182972
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

On 7/3/07, <b class="gmail_sendername">Naga</b> &lt;<a href="mailto:nagatoro@gmail.com">nagatoro@gmail.com</a>&gt; wrote:<div><span class="gmail_quote"></span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
On Wednesday 04 July 2007 00:19:14 Kevin O&#39;Gorman wrote:<br>&gt; Did I just reinvent a wheel? If not, is there any point it trying to make<br>&gt; this part of gentoo?&nbsp;&nbsp;If so, how would one do that?<br><br>See DOC_SYMLINKS_DIR in 
make.conf (man page I think, or .example)</blockquote><div><br>Thanks, I was able to track it down from that hint.<br><br>For the record:<br>&nbsp;&nbsp; Read about it in &quot;man make.conf&quot;.<br><br>The description there is quite sparse, and I haven&#39;t done any emerges since I set it,
<br>so I&#39;m not sure exactly how it works.&nbsp; I think it just sets version-independent symlinks,<br>and leaves it up to you whether to bookmark them.<br><br>Unless there&#39;s more going on, I&#39;m going to prefer my little script.&nbsp; It builds a web page
<br>with current links, organized by package.&nbsp; I run it in a cron job several times a week,<br>so it&#39;s pretty much up-to-date.&nbsp;&nbsp;&nbsp; These are all listed unless they are linked from another<br>index.html higher in the directory structure.&nbsp; This makes most of the entries pretty clean, with
<br>a few notable exceptions: boost, java, apache, drscheme, python-docs and<br>mplayer among the packages I have.&nbsp; I&#39;ll probably tweak these when I get some time.<br><br>For me the main advantage is in doing a quick check to see if a given package actually has
<br>any &quot;index.html&quot; files anywhere under /usr/share/doc.&nbsp; Just browsing to the index<br>file can be a pain sometimes, and my patience is usually thinner than usual when<br>I&#39;m desperately seeking documentation.
<br><br>So: am I the only one who likes this?<br></div></div><br>
++ kevin<br>
<br clear="all"><br>-- <br>Kevin O&#39;Gorman, PhD<br>

------=_Part_141116_3718176.1183561182972--
-- 
gentoo-user@gentoo.org mailing list