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>
