Documentation: how to use overlays

[juniper]

Hello all,

I was looking online for documentation on how to use an existing official overlay. While gentoo documentation is usually quite good, I find the documentation on this topic not great.

The first hit for googling is this site

https://wiki.gentoo.org/wiki/Project:Overlays/Overlays_guide

But this doesn't clearly explain how to add a respository so you can emerge software. If you go up the tree and back down you get to this page

https://wiki.gentoo.org/wiki/Project:Overlays/Old_User_Guide

which is clear but obviously totally out of date.

The following site also comes up in google searches

https://wiki.gentoo.org/wiki/User:Shunlir/An_Overlay_Tutorial#Using_eselect-repository

but again it's mainly a guide on setting up a respository.

EDIT: I found this in the gentoo handbook. The trouble is that it is buried deep and hard to find via google.

https://wiki.gentoo.org/wiki/Handbook:Parts/Portage/CustomTree#Working_with_several_overlays

There is a line that clearly explains how to add an official repo.

[grknight]

On the wiki, a main source is https://wiki.gentoo.org/wiki/Ebuild_repository which explains both the Gentoo repository as well as alternative ones.

[wjb]

These are the two pages of most use:

• https://wiki.gentoo.org/wiki/Layman
  
• https://wiki.gentoo.org/wiki/Eselect/Repository

Eselect-repository is supposed to be the way forward, but the sync is a pain when you have a bunch of PCs sharing a gentoo repo, i.e. no equiv to "layman -S".

[grknight]