summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMarius Mauch <genone@gentoo.org>2008-09-28 17:57:45 +0000
committerMarius Mauch <genone@gentoo.org>2008-09-28 17:57:45 +0000
commit3136c4ab8cc36599f64839778b984079f7298cc5 (patch)
treefd7ab2b28813a341571295428c146e05afea01bd /doc
parent11e35d82f16e3966a958daa2c6737077ca819424 (diff)
downloadportage-3136c4ab8cc36599f64839778b984079f7298cc5.tar.gz
portage-3136c4ab8cc36599f64839778b984079f7298cc5.tar.bz2
portage-3136c4ab8cc36599f64839778b984079f7298cc5.zip
update set config documentation to include extend, remove and intersect options
svn path=/main/trunk/; revision=11586
Diffstat (limited to 'doc')
-rw-r--r--doc/config/sets.docbook25
1 files changed, 18 insertions, 7 deletions
diff --git a/doc/config/sets.docbook b/doc/config/sets.docbook
index cfce6ecf6..ad37486c6 100644
--- a/doc/config/sets.docbook
+++ b/doc/config/sets.docbook
@@ -49,12 +49,21 @@
isn't stricly required, but it should always be used as the default
handler might be changed in future versions.</para></footnote>.
That option defines which handler class should be used to
- create the set. Other universal options available for single sets are
- <varname>name</varname> (which is usually not needed as the name
+ create the set. Other universal options available for single sets are:
+ <itemizedlist>
+ <listitem><varname>name</varname> (which is usually not needed as the name
of the set is generated from the section name if <varname>name</varname>
- is missing) and <varname>world-candidate</varname>, which determines if
- given package should be added to the <varname>world</varname> set. Some
- handler classes might require additional options for their configuration,
+ is missing)</listitem>
+ <listitem><varname>world-candidate</varname>, which determines if
+ given package should be added to the <varname>world</varname> set</listitem>
+ <listitem><varname>extend</varname> to include the contents of other package sets
+ </listitem>
+ <listitem><varname>remove</varname> to remove the contents of other package sets
+ </listitem>
+ <listitem><varname>intersect</varname> to only include packages that are also
+ included in one or more other package sets</listitem>
+ </itemizedlist>
+ Some handler classes might require additional options for their configuration,
these will be covered later in this chapter.
</para>
<para>
@@ -83,8 +92,10 @@
sets each section still requires the <varname>class</varname> option,
but to indicate that the section should generate multiple sets it's
also necessary to set the <varname>multiset</varname> option to
- <parameter>true</parameter>. The <varname>world-candidate</varname>
- option is also supported like with single sets.
+ <parameter>true</parameter>. The <varname>world-candidate</varname>,
+ <varname>extend</varname>, <varname>remove</varname> and
+ <varname>intersect</varname> options are also supported like with
+ single sets (they'll apply to all sets generated by the section).
</para>
<para>
As it doesn't make much sense to specify a single name for multiple sets