/[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.15 Revision 1.20
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/1.0 --> 5<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.15 2004/07/07 14:01:31 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.20 2004/10/10 11:09:27 swift Exp $ -->
8 8
9<sections> 9<sections>
10<section> 10<section>
11<title>What are USE-flags?</title> 11<title>What are USE-flags?</title>
12<subsection> 12<subsection>
99icc - Use the Intel C++ Compiler if the package supports it 99icc - Use the Intel C++ Compiler if the package supports it
100icc-pgo - Enable PGO data generation or use when use icc. 100icc-pgo - Enable PGO data generation or use when use icc.
101imap - Adds support for IMAP 101imap - Adds support for IMAP
102</pre> 102</pre>
103 103
104<p>
105A list of available local USE-flags can be found locally in
106<path>/usr/portage/profiles/use.local.desc</path>.
107</p>
108
104</body> 109</body>
105</subsection> 110</subsection>
106</section> 111</section>
107<section> 112<section>
108<title>Using USE-flags</title> 113<title>Using USE-flags</title>
156</pre> 161</pre>
157 162
158</body> 163</body>
159</subsection> 164</subsection>
160<subsection> 165<subsection>
166<title>Declaring USE flags for individual packages</title>
167<body>
168
169<p>
170Sometimes you want to declare a certain USE flag for one (or a couple) of
171applications but not system-wide. To accomplish this, you will need to create
172the <path>/etc/portage</path> directory (if it doesn't exist yet) and edit
173<path>/etc/portage/package.use</path>.
174</p>
175
176<p>
177For instance, if you don't want <c>berkdb</c> support globally but you do want
178it for <c>mysql</c>, you would add:
179</p>
180
181<pre caption="/etc/portage/package.use example">
182dev-db/mysql berkdb
183</pre>
184
185<p>
186You can of course also explicitly <e>disable</e> USE flags for a certain
187application. For instance, if you don't want <c>java</c> support in PHP:
188</p>
189
190<pre caption="/etc/portage/package.use 2nd example">
191dev-php/php -java
192</pre>
193
194</body>
195</subsection>
196<subsection>
161<title>Declare temporary USE-flags</title> 197<title>Declare temporary USE-flags</title>
162<body> 198<body>
163 199
164<p> 200<p>
165Sometimes you want to set a certain USE-setting only once. Instead of editing 201Sometimes you want to set a certain USE-setting only once. Instead of editing
166<path>/etc/make.conf</path> twice (to do and undo the USE-changes) you can just 202<path>/etc/make.conf</path> twice (to do and undo the USE-changes) you can just
167declare the USE-variable as environment variable. 203declare the USE-variable as environment variable. Remember that, when you
204re-emerge or update this application (either explicitly or as part of a system
205update) your changes will be lost!
168</p> 206</p>
169 207
170<p> 208<p>
171As an example we will temporarily remove java from the USE-setting 209As an example we will temporarily remove java from the USE-setting
172during the installation of mozilla. 210during the installation of mozilla.
207<subsection> 245<subsection>
208<title>Precedence</title> 246<title>Precedence</title>
209<body> 247<body>
210 248
211<p> 249<p>
212Of course there is a certain precdence on what setting has priority over the 250Of course there is a certain precedence on what setting has priority over the
213USE setting. You don't want to declare <c>USE="-java"</c> only to see that 251USE setting. You don't want to declare <c>USE="-java"</c> only to see that
214<c>java</c> is declared anyway. The precedence for the USE setting is, ordered 252<c>java</c> is declared anyway. The precedence for the USE setting is, ordered
215by priority (first has lowest priority): 253by priority (first has lowest priority):
216</p> 254</p>
217 255
223 Inherited USE setting if a package from 261 Inherited USE setting if a package from
224 <path>/etc/make.profile/use.defaults</path> is installed 262 <path>/etc/make.profile/use.defaults</path> is installed
225 </li> 263 </li>
226 <li> 264 <li>
227 User-defined USE setting in <path>/etc/make.conf</path> 265 User-defined USE setting in <path>/etc/make.conf</path>
266 </li>
267 <li>
268 User-defined USE setting in <path>/etc/portage/package.use</path>
228 </li> 269 </li>
229 <li> 270 <li>
230 User-defined USE setting as environment variable 271 User-defined USE setting as environment variable
231 </li> 272 </li>
232</ol> 273</ol>
261<pre caption="Rebuilding your entire system"> 302<pre caption="Rebuilding your entire system">
262# <i>emerge --emptytree world</i> 303# <i>emerge --emptytree world</i>
263</pre> 304</pre>
264 305
265<p> 306<p>
266Next, run Portage' depclean to remove the conditional dependencies that 307Next, run Portage's depclean to remove the conditional dependencies that
267were emerged on your "old" system but that have been obsoleted by the new USE 308were emerged on your "old" system but that have been obsoleted by the new USE
268flags. 309flags.
269</p> 310</p>
270 311
271<warn> 312<warn>

Legend:
Removed from v.1.15  
changed lines
  Added in v.1.20

  ViewVC Help
Powered by ViewVC 1.1.20