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

  Modified:             hb-working-portage.xml
  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 :
diff :

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 -->
-<!-- $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 $ -->
@@ -13,8 +13,8 @@
 maintain the software on his system.
 <title>Welcome to Portage</title>
@@ -627,6 +627,45 @@
+<subsection id="USEdependency">
+<title>Necessary USE Flag Changes</title>
+<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
+The error message might also be displayed as follows, if <c>--autounmask</c>
+isn't set:
+<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])
+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.
+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
 <subsection id="missingdependencies">
 <title>Missing Dependencies</title>