update set config documentation to include extend, remove and intersect options
authorMarius Mauch <genone@gentoo.org>
Sun, 28 Sep 2008 17:57:45 +0000 (17:57 -0000)
committerMarius Mauch <genone@gentoo.org>
Sun, 28 Sep 2008 17:57:45 +0000 (17:57 -0000)
svn path=/main/trunk/; revision=11586

doc/config/sets.docbook

index cfce6ecf686dd567db9e05936df89137fd378e40..ad37486c6103e3d40cb775972b886bcdaf7a333e 100644 (file)
                        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>
                        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