[gentoo-dev] Proposal for /usr/share/doc hierarchy

[gentoo-dev] Proposal for /usr/share/doc hierarchy

[Leo Laursen]

This was sent to gentoo-user, but I was informed that this list is more
apropriate

Hi. I am rather new to gentoo, so I don't know if this has been
discussed before.

On debian and now gentoo, one little irritating issue is the large
number of files in /usr/share/doc. On gentoo there is a very natural
solution by mirroring the portage tree in the doc directory.

Eg. /usr/share/doc/mutt-1.5.6 would be
    /usr/share/doc/net-mail/mutt/mutt-1.5.6

It should be quite easy to implement (I think).

For those with USE=doc, packages could register html-documentation in
/usr/share/doc/html/<package> (perhaps symlink)
I would like very much to have a http://localhost/doc with persistant
filenames across package upgrade.

Leo

--
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] Proposal for /usr/share/doc hierarchy

[Matthew Kennedy]

[-- Attachment #1: Type: text/plain, Size: 1141 bytes --]

Leo Laursen <ll_news@stofanet.dk> writes:

> This was sent to gentoo-user, but I was informed that this list is more
> apropriate
>
> Hi. I am rather new to gentoo, so I don't know if this has been
> discussed before.
>
> On debian and now gentoo, one little irritating issue is the large
> number of files in /usr/share/doc. On gentoo there is a very natural
> solution by mirroring the portage tree in the doc directory.
>
> Eg. /usr/share/doc/mutt-1.5.6 would be
>     /usr/share/doc/net-mail/mutt/mutt-1.5.6
>
> It should be quite easy to implement (I think).
>

I agree.  At the moment it sucks to have
/usr/share/doc/foo-package-x.y.z/ as it is impossible to bookmark
such a place over upgrades.  I think you're mistaken about Debian's
approach though.  IIRC, on Debian its /usr/share/doc/foo-package
(ie. no version information in the path name).

You proposal has a sub-directory for the portage category.  I
wouldn't bother with that.  A flat view is more useful, IMO.  You
also have a sub-directory for versions -- that is not really
necessary -- most packages have only one slot.

Matt

-- 
Matthew Kennedy
Gentoo Linux Developer

[-- Attachment #2: Type: application/pgp-signature, Size: 188 bytes --]

Re: [gentoo-dev] Proposal for /usr/share/doc hierarchy

[Stuart Herbert]

On Saturday 03 April 2004 08:34, Matthew Kennedy wrote:
> Leo Laursen <ll_news@stofanet.dk> writes:
> > Eg. /usr/share/doc/mutt-1.5.6 would be
> >     /usr/share/doc/net-mail/mutt/mutt-1.5.6
> >
> > It should be quite easy to implement (I think).

This seems like a reasonable idea.

> You proposal has a sub-directory for the portage category.  I
> wouldn't bother with that.  A flat view is more useful, IMO.  

Having the category as a directory would seem to make docs easier to navigate.

> You 
> also have a sub-directory for versions -- that is not really
> necessary -- most packages have only one slot.

Urgh.  No.  This remains very necessary.  Every single web-based app will be 
SLOT'ed by the time we are done.

Best regards,
Stu
-- 
Stuart Herbert                                              stuart@gentoo.org
Gentoo Developer                                       http://www.gentoo.org/
Missed the php|cruise?             http://dev.gentoo.org/~stuart/cruise-2004/

GnuGP key id# F9AFC57C available from http://pgp.mit.edu
Key fingerprint = 31FB 50D4 1F88 E227 F319  C549 0C2F 80BA F9AF C57C
--

--
gentoo-dev@gentoo.org mailing list