Gentoo Archives: gentoo-doc-cvs

From: "Sven Vermeulen (swift)" <swift@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-portage.xml
Date: Fri, 12 Aug 2011 19:35:05
Message-Id: 20110812192418.32A0F2004C@flycatcher.gentoo.org
1 swift 11/08/12 19:24:18
2
3 Modified: hb-working-portage.xml
4 Log:
5 Fix bug #326543 - Inform users about USE flag dependency error/warning by portage, thanks to Randy Curry for reporting
6
7 Revision Changes Path
8 1.76 xml/htdocs/doc/en/handbook/hb-working-portage.xml
9
10 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.76&view=markup
11 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.76&content-type=text/plain
12 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.75&r2=1.76
13
14 Index: hb-working-portage.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
17 retrieving revision 1.75
18 retrieving revision 1.76
19 diff -u -r1.75 -r1.76
20 --- hb-working-portage.xml 30 Oct 2010 01:54:20 -0000 1.75
21 +++ hb-working-portage.xml 12 Aug 2011 19:24:18 -0000 1.76
22 @@ -4,7 +4,7 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.75 2010/10/30 01:54:20 nightmorph Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.76 2011/08/12 19:24:18 swift Exp $ -->
28
29 <sections>
30
31 @@ -13,8 +13,8 @@
32 maintain the software on his system.
33 </abstract>
34
35 -<version>2</version>
36 -<date>2010-10-29</date>
37 +<version>3</version>
38 +<date>2011-08-12</date>
39
40 <section>
41 <title>Welcome to Portage</title>
42 @@ -627,6 +627,45 @@
43
44 </body>
45 </subsection>
46 +<subsection id="USEdependency">
47 +<title>Necessary USE Flag Changes</title>
48 +<body>
49 +
50 +<pre caption="Portage warning about USE flag change requirement">
51 +The following USE changes are necessary to proceed:
52 +#required by app-text/happypackage-2.0, required by happypackage (argument)
53 +>=app-text/feelings-1.0.0 test
54 +</pre>
55 +
56 +<p>
57 +The error message might also be displayed as follows, if <c>--autounmask</c>
58 +isn't set:
59 +</p>
60 +
61 +<pre caption="Portage error about USE flag change requirement">
62 +emerge: there are no ebuilds built with USE flags to satisfy "app-text/feelings[test]".
63 +!!! One of the following packages is required to complete your request:
64 +- app-text/feelings-1.0.0 (Change USE: +test)
65 +(dependency required by "app-text/happypackage-2.0" [ebuild])
66 +(dependency required by "happypackage" [argument])
67 +</pre>
68 +
69 +<p>
70 +Such warning or error occurs when you want to install a package which not only
71 +depends on another package, but also requires that that package is built with a
72 +particular USE flag (or set of USE flags). In the given example, the package
73 +<c>app-text/feelings</c> needs to be built with <c>USE="test"</c>, but this USE
74 +flag is not set on the system.
75 +</p>
76 +
77 +<p>
78 +To resolve this, either add the requested USE flag to your global USE flags in
79 +<path>/etc/make.conf</path>, or set it for the specific package in
80 +<path>/etc/portage/package.use</path>.
81 +</p>
82 +
83 +</body>
84 +</subsection>
85 <subsection id="missingdependencies">
86 <title>Missing Dependencies</title>
87 <body>