/[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.11 Revision 1.12
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.11 2004/04/15 11:59:45 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.12 2004/04/25 13:08:09 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>
13<title>The ideas behind USE-flags</title> 13<title>The ideas behind USE-flags</title>
14<body> 14<body>
15 15
16<p> 16<p>
17When you are installing Gentoo (or any other distribution, or even operating 17When you are installing Gentoo (or any other distribution, or even operating
18system for that matter) you make choices depending on the environment you are 18system for that matter) you make choices depending on the environment you are
19working with. A setup for a server differs from a setup for a workstation. 19working with. A setup for a server differs from a setup for a workstation.
20A gaming workstation differs from a 3D rendering workstation. 20A gaming workstation differs from a 3D rendering workstation.
21</p> 21</p>
22 22
231 </li> 231 </li>
232</ol> 232</ol>
233 233
234<p> 234<p>
235To view the final <c>USE</c> setting as seen by Portage, run <c>emerge info</c>. 235To view the final <c>USE</c> setting as seen by Portage, run <c>emerge info</c>.
236This will list all relevant variables (including the <c>USE</c> variable) with 236This will list all relevant variables (including the <c>USE</c> variable) with
237the content used by Portage. 237the content used by Portage.
238</p> 238</p>
239 239
240<pre caption="Running emerge info"> 240<pre caption="Running emerge info">
241# <i>emerge info</i> 241# <i>emerge info</i>
242</pre> 242</pre>
243 243
244</body> 244</body>
245</subsection> 245</subsection>
246<subsection>
247<title>Adapting your Entire System to New USE Flags</title>
248<body>
249
250<p>
251If you have altered your USE flags and you wish to update your entire system to
252use the new USE flags, you can try following the next steps to accomplish this.
253Note however that these steps will take a long time to finish and that work is
254on the way to adjust Portage to handle this behaviour quicker and automatically.
255</p>
256
257<p>
258First of all, rebuild your entire system using the new USE flags:
259</p>
260
261<pre caption="Rebuilding your entire system">
262# <i>emerge --emptytree world</i>
263</pre>
264
265<p>
266Next, run Portage' depclean to remove the conditional dependencies that
267were emerged on your "old" system but that have been obsoleted by the new USE
268flags.
269</p>
270
271<warn>
272Running <c>emerge depclean</c> is a dangerous operation and should be handled
273with care. Double-check the provided list of "obsoleted" packages to make sure
274it doesn't remove packages you need. In the following example we add the
275<c>-p</c> switch to have depclean only list the packages without removing them.
276</warn>
277
278<pre caption="Removing obsoleted packages">
279# <i>emerge -p depclean</i>
280</pre>
281
282<p>
283When depclean has finished, your system is using the new USE flag settings.
284</p>
285
286</body>
287</subsection>
246</section> 288</section>
247<section> 289<section>
248<title>Package specific USE-flags</title> 290<title>Package specific USE-flags</title>
249<subsection> 291<subsection>
250<title>Viewing available USE-flags</title> 292<title>Viewing available USE-flags</title>
251<body> 293<body>
252 294
253<p> 295<p>
254In the next chapter on <uri link="?part=2&amp;chap=2">Portage and Software</uri> 296In the next chapter on <uri link="?part=2&amp;chap=2">Portage and Software</uri>
255we will explain how to manage your installed software and how to work with 297we will explain how to manage your installed software and how to work with
256<c>emerge</c>. However, we will give you a primer on <c>emerge</c> by showing 298<c>emerge</c>. However, we will give you a primer on <c>emerge</c> by showing
257you how to view what USE-flags a package uses. 299you how to view what USE-flags a package uses.
258</p> 300</p>
259 301
260<p> 302<p>

Legend:
Removed from v.1.11  
changed lines
  Added in v.1.12

  ViewVC Help
Powered by ViewVC 1.1.20