aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2014-12-09 19:19:17 -0800
committerZac Medico <zmedico@gentoo.org>2014-12-11 00:05:40 -0800
commit28828655da860324861af9adea0794a0a61196bf (patch)
tree66a47285d8742cf7b33788d921eddcad0bc50648 /doc
parentSort PORTAGE_ARCHLIST. (diff)
downloadportage-28828655da860324861af9adea0794a0a61196bf.tar.gz
portage-28828655da860324861af9adea0794a0a61196bf.tar.bz2
portage-28828655da860324861af9adea0794a0a61196bf.zip
Support @profile package set for bug #532224
Add support for a new @profile set which allows the profile to pull in additional packages that do not belong to the @system set. The motivation to have @profile separate from @system is that @system packages may have incomplete dependency specifications (due to long-standing Gentoo policy), and incomplete dependency specifications have deleterious effects on the ability of emerge --jobs to parallelize builds. So, unlike @system, packages added to @profile do not hurt emerge --jobs parallelization. Packages are added to the @profile set in the same way that they are added to the @system set, except that atoms in the @profile set are not preceded with a '*' character. Also, the @profile package set is only supported when 'profile-set' is listed in the layout.conf profile-formats field of the containing repository. X-Gentoo-Bug: 532224 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=532224 Acked-by: Alexander Berntsen <bernalex@gentoo.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/config/sets.docbook21
1 files changed, 19 insertions, 2 deletions
diff --git a/doc/config/sets.docbook b/doc/config/sets.docbook
index d3aa147cc..749b7753a 100644
--- a/doc/config/sets.docbook
+++ b/doc/config/sets.docbook
@@ -286,7 +286,7 @@
<filename>packages</filename> files in the profile.
<!-- TODO: Add reference to profile documentation regarding "packages" -->
There is no reason to use this in a user configuration as it is already
- confgured by default and doesn't support any options.
+ configured by default and doesn't support any options.
</para>
<sect3>
@@ -296,7 +296,23 @@
</para>
</sect3>
</sect2>
-
+
+ <sect2 id='config-set-classes-ProfilePackageSet'>
+ <title>portage.sets.ProfilePackageSet.ProfilePackageSet</title>
+ <para>
+ This class implements the <parameter>profile</parameter> set, based on the
+ <filename>packages</filename> files in the profile.
+ There is no reason to use this in a user configuration as it is already
+ confgured by default and doesn't support any options.
+ </para>
+ <sect3>
+ <title>Single Set Configuration</title>
+ <para>
+ This class doesn't support any extra options.
+ </para>
+ </sect3>
+ </sect2>
+
<sect2 id='config-set-classes-SecuritySet' xreflabel='SecuritySet'>
<title>portage.sets.security.SecuritySet</title>
<para>
@@ -601,6 +617,7 @@
</para>
<itemizedlist>
<listitem><para><varname>world</varname>: uses <classname>DummySet</classname></para></listitem>
+ <listitem><para><varname>profile</varname>: uses <classname>ProfilePackageSet</classname></para></listitem>
<listitem><para><varname>selected</varname>: uses <classname>WorldSelectedSet</classname></para></listitem>
<listitem><para><varname>system</varname>: uses <classname>PackagesSystemSet</classname></para></listitem>
<listitem><para><varname>security</varname>: uses <classname>NewAffectedSet</classname> with default options</para></listitem>