Re: [gentoo-portage-dev] [PATCH] man/portage.5: document sets.conf (bug 541188)

[Brian Dolbec]

On Mon, 23 Feb 2015 16:14:50 -0800
Zac Medico <zmedico@g.o> wrote:

> 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
> ---
>  man/portage.5 | 47 +++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 47 insertions(+)
>
> diff --git a/man/portage.5 b/man/portage.5
> index ed5140d..c3a50a4 100644
> --- a/man/portage.5
> +++ b/man/portage.5
> @@ -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
> @@ -1472,6 +1512,13 @@ override values set here. The format is
> described extensively in section for \fB/etc/portage/repos.conf\fR.
>  .RE
>  .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
> +.TP
>  .BR /var/cache/edb/
>  .RS
>  This directory is used to store internal portage cache files.  The
> names and

looks good :) Thank you

-- 
Brian Dolbec <dolsen>