layman

storage: Directory that will be used to store the overlays and all additional data layman needs. The default is - /usr/local/portage/layman. layman + /var/lib/layman. layman uses a location within the /usr/portage hierarchy instead of /var in order to store its data. This decision has been made to support @@ -146,7 +146,7 @@ end of /etc/make.conf. This is the reason why layman suggests running "echo "source - /usr/local/portage/layman/make.conf" >> + /var/lib/layman/make.conf" >> /etc/make.conf" after it has been installed.
overlays: Specifies the URL for the remote list of all available overlays. The default is @@ -190,7 +190,7 @@ environment variable in case you set it.

Local cache

layman stores a local copy of the fetched remote list. It will be stored in - /usr/local/portage/layman/cache.xml + /var/lib/layman/cache.xml by default. There exists only one such cache file and it will be overwritten every time you run layman. @@ -213,7 +213,7 @@ sourced within the standard /etc/make.conf file. Just add the following line to the end of your /etc/make.conf file: -

source /usr/local/portage/layman/make.conf

/usr/local/portage/layman/make.conf +

source /var/lib/layman/make.conf

/var/lib/layman/make.conf is the default provided in the layman configuration. Change this file name in case you decide to store it somewhere else. @@ -266,9 +266,9 @@ darcs, git, mercurial or provided as tar packages. -

Overlay lists

Overlay list format

Overlay lists

Overlay list format

Layman uses a central list of overlays in XML format. The file looks like this: -

Example 1. An example overlays.xml file

+	    
Example 1. An example overlays.xml file
 	      <?xml version="1.0" encoding="UTF-8"?>
 	      <!DOCTYPE repositories SYSTEM "/dtd/repositories.dtd">
 	      <repositories xmlns="" version="1.0">
@@ -288,13 +288,13 @@
 	        </repo>
 	      </repositories>
 	      


-

Adding an overlay locally

Simply create an overlay list in the format described above and run layman with the -o switch. You need to prepend local file URLs with file://. -

Adding an overlay globally

The global list of overlays used by layman lies at http://www.gentoo.org/proj/en/overlays/repositories.xml. @@ -307,9 +307,9 @@ at <overlays@gentoo.org>. You can also join #gentoo-overlays on irc.freenode.net. -

Examples

Installing an overlay

layman -f -a wrobel

This would add the overlay with the id +

Examples

Installing an overlay

layman -f -a wrobel

This would add the overlay with the id wrobel to your list of installed - overlays.

Syncing your overlays

layman -s ALL

This updates all overlays

Performing several actions at the same time

layman -f -a wrobel -a webapps-experimental

This fetches the remote list and immediately adds two + overlays.

Syncing your overlays

layman -s ALL

This updates all overlays

Performing several actions at the same time

layman -f -a wrobel -a webapps-experimental

This fetches the remote list and immediately adds two overlays

Files

/etc/layman/layman.cfg: Configuration file, holding the defaults for layman

Reporting bugs

Please report bugs you might find at http://bugs.gentoo.org -- cgit v1.2.3-1-g7c22