commit: 86a675d7c9979f245499dd8d2253557933b6a3fe Author: Zac Medico <zmedico <AT> gentoo <DOT> org> AuthorDate: Tue Feb 24 00:13:41 2015 +0000 Commit: Zac Medico <zmedico <AT> gentoo <DOT> org> CommitDate: Tue Feb 24 00:37:48 2015 +0000 URL: http://sources.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=86a675d7
man/portage.5: document sets.conf (bug 541188) This documents /etc/portage/sets.conf, /usr/portage/sets.conf, and /usr/share/portage/config/sets. It refers to "Package Set Configuration" section of the html documentation for more information. X-Gentoo-Bug: 541188 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=541188 Acked-by: Brian Dolbec <dolsen <AT> gentoo.org> --- man/portage.5 | 49 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 48 insertions(+), 1 deletion(-) diff --git a/man/portage.5 b/man/portage.5 index ed5140d..3a64206 100644 --- a/man/portage.5 +++ b/man/portage.5 @@ -1,4 +1,4 @@ -.TH "PORTAGE" "5" "Jan 2015" "Portage VERSION" "Portage" +.TH "PORTAGE" "5" "Feb 2015" "Portage VERSION" "Portage" .SH NAME portage \- the heart of Gentoo .SH "DESCRIPTION" @@ -65,6 +65,7 @@ package.use postsync.d repo.postsync.d repos.conf +sets.conf .fi .TP .BR /etc/portage/env/ @@ -76,6 +77,11 @@ site-specific overrides of \fB/etc/portage/make.profile/\fR .BR /etc/portage/sets/ user\-defined package sets .TP +.BR /usr/portage/ +.nf +sets.conf +.fi +.TP .BR /usr/portage/metadata/ .nf layout.conf @@ -112,6 +118,7 @@ use.stable.force .nf make.globals repos.conf +sets .fi .TP .BR /var/cache/edb/ @@ -1066,6 +1073,30 @@ sync\-uri = git://git.overlays.gentoo.org/proj/voip.git auto\-sync = yes .fi .RE +.TP +.BR sets.conf +A package set configuration file. Settings here override settings from +\fB/usr/portage/sets.conf\fR and \fB/usr/share/portage/config/sets\fR. +The format is described extensively in the +\fIPackage Set Configuration\fR section of the html documentation which +is installed with portage when the "doc" USE flag is enabled. + +.I Example: +.nf +[world] +class = portage.sets.base.DummyPackageSet +packages = @profile @selected @system + +[usersets] +class = portage.sets.files.StaticFileSet +multiset = true +directory = %(PORTAGE_CONFIGROOT)setc/portage/sets +world-candidate = True + +[module-rebuild] +class = portage.sets.dbapi.OwnerSet +files = /lib/modules +.fi .RE .TP .BR /etc/portage/env/ @@ -1106,6 +1137,15 @@ Also see \fB/var/lib/portage/world_sets\fR and the \fBemerge\fR(1) \fB\-\-list\-sets\fR option. .RE .TP +.BR /usr/portage/ +.RS +.TP +.BR sets.conf +A package set configuration file. Also see \fB/etc/portage/sets.conf\fR +which overrides these settings, and +\fB/usr/share/portage/config/sets\fR which contains default settings. +.RE +.TP .BR /usr/portage/metadata/ .RS .TP @@ -1470,6 +1510,13 @@ The default configuration of repositories for Portage. This comes from the portage package itself. Settings in \fB/etc/portage/repos.conf\fR override values set here. The format is described extensively in section for \fB/etc/portage/repos.conf\fR. +.TP +.BR sets +A directory containing package set configuration files. Also see +\fB/etc/portage/sets.conf\fR and \fB/usr/portage/sets.conf\fR, both of +which override values set here. Default set configurations are installed +in \fB/usr/share/portage/config/sets/portage.conf\fR. +.RE .RE .TP .BR /var/cache/edb/