/[gentoo]/xml/htdocs/doc/en/handbook/hb-working-use.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-working-use.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.51 Revision 1.52
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.51 2012/07/09 04:34:16 nightmorph Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.52 2012/07/24 12:12:52 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<abstract> 11<abstract>
12USE flags are a very important aspect of Gentoo. In this chapter, you learn to 12USE flags are a very important aspect of Gentoo. In this chapter, you learn to
13work with USE flags and understand how USE flags interact with your system. 13work with USE flags and understand how USE flags interact with your system.
14</abstract> 14</abstract>
15 15
16<version>2</version> 16<version>3</version>
17<date>2012-07-08</date> 17<date>2012-07-24</date>
18 18
19<section> 19<section>
20<title>What are USE flags?</title> 20<title>What are USE flags?</title>
21<subsection> 21<subsection>
22<title>The ideas behind USE flags</title> 22<title>The ideas behind USE flags</title>
126in the <path>make.defaults</path> files part of your profile. 126in the <path>make.defaults</path> files part of your profile.
127</p> 127</p>
128 128
129<p> 129<p>
130The profile your system listens to is pointed to by the 130The profile your system listens to is pointed to by the
131<path>/etc/make.profile</path> symlink. Each profile works on top of another, 131<path>/etc/portage/make.profile</path> symlink. Each profile works on top of
132larger profile, the end result is therefore the sum of all profiles. The top 132another, larger profile, the end result is therefore the sum of all profiles.
133profile is the <path>base</path> profile 133The top profile is the <path>base</path> profile
134(<path>/usr/portage/profiles/base</path>). 134(<path>/usr/portage/profiles/base</path>).
135</p> 135</p>
136 136
137<p> 137<p>
138Let us take a look at this default setting for the 10.0 profile: 138Let us take a look at this default setting for the 10.0 profile:
156</p> 156</p>
157 157
158<p> 158<p>
159To change this default setting, you need to add or remove keywords to the 159To change this default setting, you need to add or remove keywords to the
160<c>USE</c> variable. This is done globally by defining the <c>USE</c> variable 160<c>USE</c> variable. This is done globally by defining the <c>USE</c> variable
161in <path>/etc/make.conf</path>. In this variable you add the extra USE flags you 161in <path>/etc/portage/make.conf</path>. In this variable you add the extra USE
162require, or remove the USE flags you don't want. This latter is done by 162flags you require, or remove the USE flags you don't want. This latter is done
163prefixing the keyword with the minus-sign ("-"). 163by prefixing the keyword with the minus-sign ("-").
164</p> 164</p>
165 165
166<p> 166<p>
167For instance, to remove support for KDE and QT but add support for ldap, the 167For instance, to remove support for KDE and QT but add support for ldap, the
168following <c>USE</c> can be defined in <path>/etc/make.conf</path>: 168following <c>USE</c> can be defined in <path>/etc/portage/make.conf</path>:
169</p> 169</p>
170 170
171<pre caption="An example USE setting in /etc/make.conf"> 171<pre caption="An example USE setting in /etc/portage/make.conf">
172USE="-kde -qt4 ldap" 172USE="-kde -qt4 ldap"
173</pre> 173</pre>
174 174
175</body> 175</body>
176</subsection> 176</subsection>
211<title>Declare temporary USE flags</title> 211<title>Declare temporary USE flags</title>
212<body> 212<body>
213 213
214<p> 214<p>
215Sometimes you want to set a certain USE setting only once. Instead of editing 215Sometimes you want to set a certain USE setting only once. Instead of editing
216<path>/etc/make.conf</path> twice (to do and undo the USE changes) you can just 216<path>/etc/portage/make.conf</path> twice (to do and undo the USE changes) you
217declare the USE variable as environment variable. Remember that, when you 217can just declare the USE variable as environment variable. Remember that, when
218re-emerge or update this application (either explicitly or as part of a system 218you re-emerge or update this application (either explicitly or as part of a
219update) your changes will be lost! 219system update) your changes will be lost!
220</p> 220</p>
221 221
222<p> 222<p>
223As an example we will temporarily remove java from the USE setting 223As an example we will temporarily remove java from the USE setting
224during the installation of seamonkey. 224during the installation of seamonkey.
246 <li> 246 <li>
247 Default USE setting declared in the <path>make.defaults</path> files part of 247 Default USE setting declared in the <path>make.defaults</path> files part of
248 your profile 248 your profile
249 </li> 249 </li>
250 <li> 250 <li>
251 User-defined USE setting in <path>/etc/make.conf</path> 251 User-defined USE setting in <path>/etc/portage/make.conf</path>
252 </li> 252 </li>
253 <li> 253 <li>
254 User-defined USE setting in <path>/etc/portage/package.use</path> 254 User-defined USE setting in <path>/etc/portage/package.use</path>
255 </li> 255 </li>
256 <li> 256 <li>

Legend:
Removed from v.1.51  
changed lines
  Added in v.1.52

  ViewVC Help
Powered by ViewVC 1.1.20