Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 154017 - Obscurity in USE-settings documentation
Summary: Obscurity in USE-settings documentation
Status: RESOLVED WORKSFORME
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-11-04 04:27 UTC by Stefan Salewski
Modified: 2006-11-04 18:11 UTC (History)
0 users

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 Stefan Salewski 2006-11-04 04:27:37 UTC
2. USE flags (Updated November 3, 2006)
http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=2

I think there is one point in the explanation of Gentoo USE-settings which makes it difficul for new users to understand how useflags are combined:

Gentoo writes:
>As previously mentioned, all USE-flags are declared
>inside the USE variable.
>[...]
>Code Listing 2: An example USE setting in /etc/make.conf
>USE="-kde -qt3 -qt4 ldap"

The problem is, that the reader of the document may think that all portage useflags are stored in an (environment) USE variable, and that statements like
'USE="-kde -qt3 -qt4 ldap"' or 'USE="-java" emerge mozilla' will overwrite/replace all default useflags.

Of course, if reading the document very carefully, all will become clear.
And I hope if you read my remarks very carefully, my criticism will become clear too. But maybe I am wrong.

Best regards

Stefan Salewski
Comment 1 SpanKY gentoo-dev 2006-11-04 15:32:21 UTC
so what's the request ?  we mention the fact that USE is incremental earlier on ?
Comment 2 nm (RETIRED) gentoo-dev 2006-11-04 18:11:47 UTC
What vapier said -- the docs are very clear about USE flags. We also already note emerging with " USE="-X" emerge links " will do things like override a global value set in make.conf, but only that value. Doc stays as-is, thanks.