/[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.36 Revision 1.41
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/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.36 2005/10/26 14:37:18 rane Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.41 2006/07/16 09:10:55 neysx Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.31</version> 11<version>1.33</version>
12<date>2005-10-26</date> 12<date>2006-07-16</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>
34 34
35<p> 35<p>
36To help users in deciding what to install/activate and what not, we wanted the 36To help users in deciding what to install/activate and what not, we wanted the
37user to specify his/her environment in an easy way. This forces the user into 37user to specify his/her environment in an easy way. This forces the user into
38deciding what they really want and eases the process for Portage, our package 38deciding what they really want and eases the process for Portage, our package
39managment system, to make useful decisions. 39management system, to make useful decisions.
40</p> 40</p>
41 41
42</body> 42</body>
43</subsection> 43</subsection>
44<subsection> 44<subsection>
89</ul> 89</ul>
90 90
91<p> 91<p>
92A list of available global USE-flags can be found <uri 92A list of available global USE-flags can be found <uri
93link="/dyn/use-index.xml">online</uri> or locally in 93link="/dyn/use-index.xml">online</uri> or locally in
94<path>/usr/portage/profiles/use.desc</path>. A short (<e>very</e> incomplete) 94<path>/usr/portage/profiles/use.desc</path>.
95snippet:
96</p>
97
98<pre caption="A short snippet of available USE-flags">
99gtk - Adds support for x11-libs/gtk+ (The GIMP Toolkit)
100gtk2 - Use gtk+-2.0.0 over gtk+-1.2 in cases where a program supports both.
101gtkhtml - Adds support for gnome-extra/gtkhtml
102guile - Adds support for dev-util/guile (interpreter for Scheme)
103icc - Use the Intel C++ Compiler if the package supports it
104icc-pgo - Enable PGO data generation or use when use icc.
105imap - Adds support for IMAP
106</pre> 95</p>
107 96
108<p> 97<p>
109A list of available local USE-flags can be found locally in 98A list of available local USE-flags can be found locally in
110<path>/usr/portage/profiles/use.local.desc</path>. 99<path>/usr/portage/profiles/use.local.desc</path>.
111</p> 100</p>
146 135
147<pre caption="Cumulative make.defaults USE variable for the 2004.3 profile"> 136<pre caption="Cumulative make.defaults USE variable for the 2004.3 profile">
148<comment>(This example is the sum of the settings in base, default-linux, 137<comment>(This example is the sum of the settings in base, default-linux,
149 default-linux/x86 and default-linux/x86/2004.3)</comment> 138 default-linux/x86 and default-linux/x86/2004.3)</comment>
150USE="x86 oss apm arts avi berkdb bitmap-fonts crypt cups encode fortran f77 139USE="x86 oss apm arts avi berkdb bitmap-fonts crypt cups encode fortran f77
151 foomaticdb gdbm gif gpm gtk gtk2 imlib jpeg kde gnome libg++ libwww mad 140 foomaticdb gdbm gif gpm gtk imlib jpeg kde gnome libg++ libwww mad
152 mikmod motif mpeg ncurses nls oggvorbis opengl pam pdflib png python qt 141 mikmod motif mpeg ncurses nls oggvorbis opengl pam pdflib png python qt
153 quicktime readline sdl spell ssl svga tcpd truetype X xml2 xmms xv zlib" 142 quicktime readline sdl spell ssl svga tcpd truetype X xml2 xmms xv zlib"
154</pre> 143</pre>
155 144
156<p> 145<p>
232</pre> 221</pre>
233 222
234</body> 223</body>
235</subsection> 224</subsection>
236<subsection> 225<subsection>
237<title>Automatic USE Flags</title>
238<body>
239
240<p>
241After certain packages are installed, additional USE flags will automatically
242be enabled for you if you do not explicitly disable them. To view the list
243of packages that trigger automatic USE-flags, check
244<path>/etc/make.profile/use.defaults</path> and the <path>use.defaults</path>
245files of the parent profiles.
246</p>
247
248<pre caption="A snippet from /etc/make.profile/use.defaults">
249gnome gnome-base/gnome
250gtk x11-libs/gtk+
251qt x11-libs/qt
252kde kde-base/kdebase
253motif x11-libs/openmotif
254</pre>
255
256</body>
257</subsection>
258<subsection>
259<title>Precedence</title> 226<title>Precedence</title>
260<body> 227<body>
261 228
262<p> 229<p>
263Of course there is a certain precedence on what setting has priority over the 230Of course there is a certain precedence on what setting has priority over the
269 236
270<ol> 237<ol>
271 <li> 238 <li>
272 Default USE setting declared in the <path>make.defaults</path> files part of 239 Default USE setting declared in the <path>make.defaults</path> files part of
273 your profile 240 your profile
274 </li>
275 <li>
276 Inherited USE setting if a package from profile <path>use.defaults</path> is installed
277 </li> 241 </li>
278 <li> 242 <li>
279 User-defined USE setting in <path>/etc/make.conf</path> 243 User-defined USE setting in <path>/etc/make.conf</path>
280 </li> 244 </li>
281 <li> 245 <li>
361<pre caption="Viewing the used USE-flags"> 325<pre caption="Viewing the used USE-flags">
362# <i>emerge --pretend --verbose mozilla</i> 326# <i>emerge --pretend --verbose mozilla</i>
363These are the packages that I would merge, in order: 327These are the packages that I would merge, in order:
364 328
365Calculating dependencies ...done! 329Calculating dependencies ...done!
366[ebuild N ] net-www/mozilla-1.5-r1 +java +crypt -ipv6 -gtk2 +ssl +ldap 330[ebuild R ] www-client/mozilla-1.7.12-r2 USE="crypt gnome java mozsvg ssl
367+gnome -debug +mozcalendar -mozaccess -mozxmlterm -moznoirc -moznomail 331truetype xprint -debug -ipv6 -ldap -mozcalendar -mozdevelop -moznocompose
368-moznocompose -moznoxft 332-moznoirc -moznomail -moznoxft -postgres -xinerama" 0 kB
369</pre> 333</pre>
370 334
371<p> 335<p>
372<c>emerge</c> isn't the only tool for this job. In fact, we have a tool 336<c>emerge</c> isn't the only tool for this job. In fact, we have a tool
373dedicated to package information called <c>equery</c> which resides in the 337dedicated to package information called <c>equery</c> which resides in the

Legend:
Removed from v.1.36  
changed lines
  Added in v.1.41

  ViewVC Help
Powered by ViewVC 1.1.20