/[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.26 Revision 1.27
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
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.26 2004/12/28 20:01:06 cam Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.27 2005/01/22 01:24:31 cam Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.23</version> 11<version>1.24</version>
12<date>2004-12-28</date> 12<date>2005-01-22</date>
13 13
14<section> 14<section>
15<title>What are USE-flags?</title> 15<title>What are USE-flags?</title>
16<subsection> 16<subsection>
17<title>The ideas behind USE-flags</title> 17<title>The ideas behind USE-flags</title>
18<body> 18<body>
19 19
20<p> 20<p>
21When you are installing Gentoo (or any other distribution, or even operating 21When you are installing Gentoo (or any other distribution, or even operating
22system for that matter) you make choices depending on the environment you are 22system for that matter) you make choices depending on the environment you are
23working with. A setup for a server differs from a setup for a workstation. 23working with. A setup for a server differs from a setup for a workstation.
24A gaming workstation differs from a 3D rendering workstation. 24A gaming workstation differs from a 3D rendering workstation.
25</p> 25</p>
26 26
27<p> 27<p>
262 Inherited USE setting if a package from 262 Inherited USE setting if a package from
263 <path>/etc/make.profile/use.defaults</path> is installed 263 <path>/etc/make.profile/use.defaults</path> is installed
264 </li> 264 </li>
265 <li> 265 <li>
266 User-defined USE setting in <path>/etc/make.conf</path> 266 User-defined USE setting in <path>/etc/make.conf</path>
267 </li> 267 </li>
268 <li> 268 <li>
269 User-defined USE setting in <path>/etc/portage/package.use</path> 269 User-defined USE setting in <path>/etc/portage/package.use</path>
270 </li> 270 </li>
271 <li> 271 <li>
272 User-defined USE setting as environment variable 272 User-defined USE setting as environment variable
273 </li> 273 </li>
274</ol> 274</ol>
275 275
276<p> 276<p>
277To view the final <c>USE</c> setting as seen by Portage, run <c>emerge info</c>. 277To view the final <c>USE</c> setting as seen by Portage, run <c>emerge
278This will list all relevant variables (including the <c>USE</c> variable) with 278--info</c>. This will list all relevant variables (including the <c>USE</c>
279the content used by Portage. 279variable) with the content used by Portage.
280</p> 280</p>
281 281
282<pre caption="Running emerge info"> 282<pre caption="Running emerge --info">
283# <i>emerge info</i> 283# <i>emerge --info</i>
284</pre> 284</pre>
285 285
286</body> 286</body>
287</subsection> 287</subsection>
288<subsection> 288<subsection>
289<title>Adapting your Entire System to New USE Flags</title> 289<title>Adapting your Entire System to New USE Flags</title>
290<body> 290<body>
291 291
292<p> 292<p>
293If you have altered your USE flags and you wish to update your entire system to 293If you have altered your USE flags and you wish to update your entire system to
294use the new USE flags, use <c>emerge</c>'s <c>--newuse</c> option: 294use the new USE flags, use <c>emerge</c>'s <c>--newuse</c> option:
295</p> 295</p>
296 296
297<pre caption="Rebuilding your entire system"> 297<pre caption="Rebuilding your entire system">
298# <i>emerge --update --deep --newuse world</i> 298# <i>emerge --update --deep --newuse world</i>
299</pre> 299</pre>
300 300
301<p> 301<p>
302Next, run Portage's depclean to remove the conditional dependencies that 302Next, run Portage's depclean to remove the conditional dependencies that
303were emerged on your "old" system but that have been obsoleted by the new USE 303were emerged on your "old" system but that have been obsoleted by the new USE
304flags. 304flags.
305</p> 305</p>
306 306
307<warn> 307<warn>
308Running <c>emerge depclean</c> is a dangerous operation and should be handled 308Running <c>emerge --depclean</c> is a dangerous operation and should be handled
309with care. Double-check the provided list of "obsoleted" packages to make sure 309with care. Double-check the provided list of "obsoleted" packages to make sure
310it doesn't remove packages you need. In the following example we add the 310it doesn't remove packages you need. In the following example we add the
311<c>-p</c> switch to have depclean only list the packages without removing them. 311<c>-p</c> switch to have depclean only list the packages without removing them.
312</warn> 312</warn>
313 313
314<pre caption="Removing obsoleted packages"> 314<pre caption="Removing obsoleted packages">
315# <i>emerge -p depclean</i> 315# <i>emerge -p --depclean</i>
316</pre> 316</pre>
317 317
318<p> 318<p>
319When depclean has finished, run <c>revdep-rebuild</c> to rebuild the 319When depclean has finished, run <c>revdep-rebuild</c> to rebuild the
320applications that are dynamically linked against shared objects provided by 320applications that are dynamically linked against shared objects provided by
321possibly removed packages. <c>revdep-rebuild</c> is part of the 321possibly removed packages. <c>revdep-rebuild</c> is part of the
322<c>gentoolkit</c> package; don't forget to emerge it first. 322<c>gentoolkit</c> package; don't forget to emerge it first.
323</p> 323</p>
324 324
325<pre caption="Running revdep-rebuild"> 325<pre caption="Running revdep-rebuild">
326# <i>revdep-rebuild</i> 326# <i>revdep-rebuild</i>
327</pre> 327</pre>
328 328
329<p> 329<p>
330When all this is accomplished, your system is using the new USE flag settings. 330When all this is accomplished, your system is using the new USE flag settings.

Legend:
Removed from v.1.26  
changed lines
  Added in v.1.27

  ViewVC Help
Powered by ViewVC 1.1.20