Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 326543 - handbook misses explanation for (Change USE: ...)
Summary: handbook misses explanation for (Change USE: ...)
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Sven Vermeulen (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-07-02 04:28 UTC by Randy
Modified: 2011-08-12 19:25 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Randy 2010-07-02 04:28:16 UTC
Upon my first Gentoo install, using the online guide, and in virtualbox OSE in Ubuntu, the kernel compilation goes well as well as the the rest until I get to the system logger part. I would like to use syslog-ng but when I emerge it I get the message in the summary followed by [code]!!! One of the following packages is required to complete your request: -app-text/docbook-sgml-utils0.6.14 (Change USE: +jadetex)
(dependency required by "media-libs/fontconfig-2.8.0" [ebuild])
"         "           "  "app-text/poppler-0.12.4-r3"    "
"         "           "  "net-print/cups-1.3.11-r1"
"         "           "  "app-text/ghostscript-gpl-8.71-r1"
"         "           "  "x11-libs/libX11-1.3.3"
"         "           "  "x11-libs/libXaw-1.0.7"
                         "media-gfx/graphviz-2.26.0"
                         "app-doc/doxygen-1.5.8-r1"
                         "x11-libs/libxcb-1.5"[/code]

I get the same thing trying to emerge anything from there. I read somewhere that this is a bug so... here I am. Thanks.

Reproducible: Always

Steps to Reproduce:
1.Fallow Gentoo install instruction at http://www.gentoo.org/doc/en/handbook/handbook-x86.xml to point of selecting system logger.
2.emerge syslog-ng
3.watch dependencies emerge

Actual Results:  
See description.

Expected Results:  
Install and move on to cron daemon...

I did set the kernel for ext4 and ntfs support along with usb and a few other things but nothing I can think of to cause this. Wish I could supply more info...
Comment 1 Sebastian Luther (few) 2010-07-02 05:06:52 UTC
Sorry for the inconvenience. The issue you're seeing is not a bug. emerge asks you to change the use flag settings for app-text/docbook-sgml-utils. Namely to enable the 'jadetex' use flag for it. How to do this is covered by the handbook [1].

[1] http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=2
Comment 2 nm (RETIRED) gentoo-dev 2010-07-05 23:21:11 UTC
There's already plenty of info about how to set USE flags globally, in make.conf, and locally in package.use. Closing.
Comment 3 Sebastian Luther (few) 2010-07-06 04:42:52 UTC
(In reply to comment #2)
> There's already plenty of info about how to set USE flags globally, in
> make.conf, and locally in package.use. Closing.
> 

That's not what this bug is about. The bug is about figuring out that a use flag has to be changed from what emerge outputs. That would belong to [1].

[1] http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1#doc_chap5
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2011-08-12 19:25:25 UTC
Thanks. I've updated the handbook to inform the users about this:

"""
Necessary USE Flag Changes

Code Listing 5.5: 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 --autounmask isn't set:

Code Listing 5.6: 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 app-text/feelings needs to be built with USE="test", 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 /etc/make.conf, or set it for the specific package in /etc/portage/package.use. 
"""

Committed in CVS, should show up on the site in an hour or so.