====== CVPCS Gentoo Overlay ======

---- dataentry project ----
Name_              : CVPCS Gentoo Overlay
Tags_tags          : linux, gentoo, overlay
Description_       : A custom overlay for Gentoo Linux.
Last Update_dt     : 2011-11-15
----

===== Description =====

As an avid [[http://gentoo.org|Gentoo Linux]] user, I often find that there are packages that I wish were available in Portage (the Gentoo package management system) that simply aren't there.

As such, I have for some time now been maintaining an unofficial Gentoo overlay to include various packages that I have found useful.

===== Installation =====

Installing the overlay is actually quite simple.  Essentially we will set up the layman utility to become aware of the repo, and then let it take care of things from there!

==== Install layman ====

<note important>
If you already have layman installed and set up you can skip to the [[#Configure_layman|Configure layman]] section.
</note>

The first step is to install the layman overlay management utility:

<code bash>
emerge layman
</code>

==== Add the cvpcs overlay ====

Now that you have layman installed, you need to add the cvpcs overlay.  To do this you first need to tell layman where to find the overlay.

You do this by editing the ///etc/layman/layman.cfg// file.  Find the section that looks like this:

<file>
#-----------------------------------------------------------
# URLs of the remote lists of overlays (one per line) or
# local overlay definitions
#
#overlays  : http://www.gentoo.org/proj/en/overlays/repositories.xml
#            http://dev.gentoo.org/~wrobel/layman/global-overlays.xml
#            http://mydomain.org/my-layman-list.xml
#            file:///var/lib/layman/my-list.xml

overlays  : http://www.gentoo.org/proj/en/overlays/repositories.xml

</file>

And add the cvpcs overlay location to it:

<file>
#-----------------------------------------------------------
# URLs of the remote lists of overlays (one per line) or
# local overlay definitions
#
#overlays  : http://www.gentoo.org/proj/en/overlays/repositories.xml
#            http://dev.gentoo.org/~wrobel/layman/global-overlays.xml
#            http://mydomain.org/my-layman-list.xml
#            file:///var/lib/layman/my-list.xml

overlays  : http://www.gentoo.org/proj/en/overlays/repositories.xml
            https://raw.github.com/cvpcs/gentoo-overlay/master/profiles/repo.xml

</file>

You can now sync the layman overlay list and add the cvpcs overlay:

<code bash>
layman -L
layman -a cvpcs
</code>

==== Tell portage to use the overlays ====

Lastly, you'll need to make sure you set your ///etc/make.conf// to source layman's makefile in order to pull in the overlays it installs:

<code bash>
echo "source /var/lib/layman/make.conf" >> /etc/make.conf
</code>

===== Source =====

The source is available on my personal github:

[[http://github.com/cvpcs/gentoo-overlay]]