Gentoo Archives: gentoo-commits

From: "Marius Mauch (genone)" <genone@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] portage r11586 - main/trunk/doc/config
Date: Sun, 28 Sep 2008 17:57:48
Message-Id: E1Kk0Wf-0000WZ-U8@stork.gentoo.org
1 Author: genone
2 Date: 2008-09-28 17:57:45 +0000 (Sun, 28 Sep 2008)
3 New Revision: 11586
4
5 Modified:
6 main/trunk/doc/config/sets.docbook
7 Log:
8 update set config documentation to include extend, remove and intersect options
9
10 Modified: main/trunk/doc/config/sets.docbook
11 ===================================================================
12 --- main/trunk/doc/config/sets.docbook 2008-09-28 17:33:00 UTC (rev 11585)
13 +++ main/trunk/doc/config/sets.docbook 2008-09-28 17:57:45 UTC (rev 11586)
14 @@ -49,12 +49,21 @@
15 isn't stricly required, but it should always be used as the default
16 handler might be changed in future versions.</para></footnote>.
17 That option defines which handler class should be used to
18 - create the set. Other universal options available for single sets are
19 - <varname>name</varname> (which is usually not needed as the name
20 + create the set. Other universal options available for single sets are:
21 + <itemizedlist>
22 + <listitem><varname>name</varname> (which is usually not needed as the name
23 of the set is generated from the section name if <varname>name</varname>
24 - is missing) and <varname>world-candidate</varname>, which determines if
25 - given package should be added to the <varname>world</varname> set. Some
26 - handler classes might require additional options for their configuration,
27 + is missing)</listitem>
28 + <listitem><varname>world-candidate</varname>, which determines if
29 + given package should be added to the <varname>world</varname> set</listitem>
30 + <listitem><varname>extend</varname> to include the contents of other package sets
31 + </listitem>
32 + <listitem><varname>remove</varname> to remove the contents of other package sets
33 + </listitem>
34 + <listitem><varname>intersect</varname> to only include packages that are also
35 + included in one or more other package sets</listitem>
36 + </itemizedlist>
37 + Some handler classes might require additional options for their configuration,
38 these will be covered later in this chapter.
39 </para>
40 <para>
41 @@ -83,8 +92,10 @@
42 sets each section still requires the <varname>class</varname> option,
43 but to indicate that the section should generate multiple sets it's
44 also necessary to set the <varname>multiset</varname> option to
45 - <parameter>true</parameter>. The <varname>world-candidate</varname>
46 - option is also supported like with single sets.
47 + <parameter>true</parameter>. The <varname>world-candidate</varname>,
48 + <varname>extend</varname>, <varname>remove</varname> and
49 + <varname>intersect</varname> options are also supported like with
50 + single sets (they'll apply to all sets generated by the section).
51 </para>
52 <para>
53 As it doesn't make much sense to specify a single name for multiple sets