From: Marius Mauch <genone@gentoo.org>
Date: Sun, 28 Sep 2008 17:57:45 +0000 (-0000)
Subject: update set config documentation to include extend, remove and intersect options
X-Git-Tag: v2.2_rc12~66
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=3136c4ab8cc36599f64839778b984079f7298cc5;p=portage.git

update set config documentation to include extend, remove and intersect options

svn path=/main/trunk/; revision=11586
---

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