Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 274725 - It would be useful to have a reference to eix in the overlays userguide.
Summary: It would be useful to have a reference to eix in the overlays userguide.
Status: RESOLVED WONTFIX
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Gentoo Overlays Project
URL: http://www.gentoo.org/proj/en/overlay...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-06-19 16:36 UTC by peyser.alex
Modified: 2016-05-23 06:52 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---
tampakrap: Bugday+


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description peyser.alex 2009-06-19 16:36:25 UTC
The best way to search through overlays appears to be with eix & update-eix-remote. I've been trying to figure out a way to search overlays without installing every overlay in existence for many months, and only recently found a reference in a closed bug report (http://bugs.gentoo.org/show_bug.cgi?id=180464) that eix with update-eix-remote does exactly that.

A reference to the package would surely save folks a lot of time.

Reproducible: Always

Steps to Reproduce:
1.How do I search overlays?
2.
3.

Actual Results:  
I dunno -- google doesn't help me, there's no web interface to do it....

Expected Results:  
Magical full knowledge of the universe.
Comment 1 Xavier Neys (RETIRED) gentoo-dev 2009-06-19 17:04:39 UTC
Better not use any overlay. Anyway, not our problem.
Comment 2 peyser.alex 2009-06-19 17:25:56 UTC
(In reply to comment #1)
> Better not use any overlay. Anyway, not our problem.
> 

What???? Nice, nice response. Of course folks have to use overlays -- gentoo supports them specifically to have a migration path of new projects into the official tree, with testing by those who are willing and able to test.

And not your problem? Well then, nothing is your problem. Get rid of all the documentation -- problem solved. Get rid of eix while your at it -- which is in the official build tree. Get rid of the user overlay documentation. Get rid of gentoo -- that'll reduce the bug list to zero.

What a ridiculous response -- just pure flamage. That to a request purely added as a help to OTHERS (since I've found my answer) which requires the addition of a single line to OFFICIAL documentation referencing an OFFICIAL project, based off a suggestion from the bug list as a resolution to a BUG.

Why did you bother?
Comment 3 Robert Buchholz (RETIRED) gentoo-dev 2009-06-28 18:24:51 UTC
Thanks for your bug report. Xavier probably intended the "not for us" to mean that the bug is not for the Gentoo Docs team because that specific piece of documentation is being maintained by the Overlays team.

I'm happy to include the reference to eix in the overlays guide. Can you provide a patch to the documentation or a paragraph that can be included?

Thanks!
Comment 4 Jeremy Olexa (darkside) (RETIRED) archtester gentoo-dev Security 2009-08-23 00:04:35 UTC
(In reply to comment #2)

> a single line to OFFICIAL documentation referencing an OFFICIAL project

What are you thinking would be a good addition?
Comment 5 peyser.alex 2009-11-05 17:54:44 UTC
(In reply to comment #4)
> (In reply to comment #2)
> 
> > a single line to OFFICIAL documentation referencing an OFFICIAL project
> 
> What are you thinking would be a good addition?
> 

I ran into this in the layman man page:
"You can search through the ebuilds available in the overlays on http://overlays.gentoo.org by using "eix". Emerge the package and run update-eix-remote update."

So it is referenced, just obscurely rather than in the main documentation.

And Robert, thanks for being polite -- but your interpretation of the initial response is impossible (aka, it followed "better not to use overlays", which is a ridiculously stupid comment).
Comment 6 Robert Buchholz (RETIRED) gentoo-dev 2009-11-05 19:58:05 UTC
(In reply to comment #5)
> I ran into this in the layman man page:
> "You can search through the ebuilds available in the overlays on
> http://overlays.gentoo.org by using "eix". Emerge the package and run
> update-eix-remote update."
> 
> So it is referenced, just obscurely rather than in the main documentation.

If you have a patch against the GuideXML, I am happy to apply it.
Comment 7 peyser.alex 2009-11-05 21:35:26 UTC
I'd be happy to insert text and run patch, if I knew what & where "GuideXML" was! Is there a guide to the guides that explains the guide documentation process? Is there a location to download the overlay guide in it's original xml, since all I see is the html return?
Comment 8 Jeremy Olexa (darkside) (RETIRED) archtester gentoo-dev Security 2009-11-16 01:03:07 UTC
(In reply to comment #7)
> I'd be happy to insert text and run patch, if I knew what & where "GuideXML"
> was! Is there a guide to the guides that explains the guide documentation
> process? 

http://www.gentoo.org/doc/en/xml-guide.xml

> Is there a location to download the overlay guide in it's original
> xml, since all I see is the html return?

http://sources.gentoo.org/viewcvs.py/gentoo/

Or, I find it easier to browse to the page in your web client and append "?passthru=1" to the URL.

Comment 9 Theo Chatzimichos (RETIRED) archtester gentoo-dev Security 2012-06-27 16:18:47 UTC
My task. I plan to write a doc with tools that can be used for local overlays' administration (layman, eix etc)
Comment 10 Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2016-05-23 06:52:05 UTC
Overlays team is no longer doing guides for tools. This is what belongs in general user or tool documentation.