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
swift       11/08/12 19:24:18

  Modified:             hb-working-portage.xml
  Log:
  Fix bug #326543 - Inform users about USE flag dependency error/warning by portage, thanks to Randy Curry for reporting

Revision  Changes    Path
1.76                 xml/htdocs/doc/en/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.76&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.76&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.75&r2=1.76

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
retrieving revision 1.75
retrieving revision 1.76
diff -u -r1.75 -r1.76
--- hb-working-portage.xml	30 Oct 2010 01:54:20 -0000	1.75
+++ hb-working-portage.xml	12 Aug 2011 19:24:18 -0000	1.76
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.75 2010/10/30 01:54:20 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.76 2011/08/12 19:24:18 swift Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 maintain the software on his system.
 </abstract>
 
-<version>2</version>
-<date>2010-10-29</date>
+<version>3</version>
+<date>2011-08-12</date>
 
 <section>
 <title>Welcome to Portage</title>
@@ -627,6 +627,45 @@
 
 </body>
 </subsection>
+<subsection id="USEdependency">
+<title>Necessary USE Flag Changes</title>
+<body>
+
+<pre caption="Portage warning about USE flag change requirement">
+The following USE changes are necessary to proceed:
+#required by app-text/happypackage-2.0, required by happypackage (argument)
+>=app-text/feelings-1.0.0 test
+</pre>
+
+<p>
+The error message might also be displayed as follows, if <c>--autounmask</c>
+isn't set:
+</p>
+
+<pre caption="Portage error about USE flag change requirement">
+emerge: there are no ebuilds built with USE flags to satisfy "app-text/feelings[test]".
+!!! One of the following packages is required to complete your request:
+- app-text/feelings-1.0.0 (Change USE: +test)
+(dependency required by "app-text/happypackage-2.0" [ebuild])
+(dependency required by "happypackage" [argument])
+</pre>
+
+<p>
+Such warning or error occurs when you want to install a package which not only
+depends on another package, but also requires that that package is built with a
+particular USE flag (or set of USE flags). In the given example, the package
+<c>app-text/feelings</c> needs to be built with <c>USE="test"</c>, but this USE
+flag is not set on the system.
+</p>
+
+<p>
+To resolve this, either add the requested USE flag to your global USE flags in
+<path>/etc/make.conf</path>, or set it for the specific package in
+<path>/etc/portage/package.use</path>.
+</p>
+
+</body>
+</subsection>
 <subsection id="missingdependencies">
 <title>Missing Dependencies</title>
 <body>