/[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.25 Revision 1.26
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.25 2004/12/26 14:56:32 swift Exp $ --> 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 $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.22</version> 11<version>1.23</version>
12<date>2004-12-26</date> 12<date>2004-12-28</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>
123In the hope you are convinced of the importance of USE-flags we will now inform 123In the hope you are convinced of the importance of USE-flags we will now inform
124you how to declare USE-flags. 124you how to declare USE-flags.
125</p> 125</p>
126 126
127<p> 127<p>
128As previously mentioned, all USE-flags are declared inside the <c>USE</c> 128As previously mentioned, all USE-flags are declared inside the <c>USE</c>
129variable. To make it easy for users to search and pick USE-flags, we already 129variable. To make it easy for users to search and pick USE-flags, we already
130provide a <e>default</e> USE setting. This setting is a collection of USE-flags 130provide a <e>default</e> USE setting. This setting is a collection of USE-flags
131we think are commonly used by the Gentoo users. This default setting is declared 131we think are commonly used by the Gentoo users. This default setting is declared
132in the <path>make.defaults</path> files part of your profile. Let us take a 132in the <path>make.defaults</path> files part of your profile. Let us take a
133look at this default setting: 133look at this default setting:
134</p> 134</p>
135 135
136<pre caption="/usr/portage/profiles/default-linux/x86/2004.3/make.defaults USE variable"> 136<pre caption="/usr/portage/profiles/default-linux/x86/2004.3/make.defaults USE variable">
137<comment>(This is an example and might have changed since it was taken)</comment> 137<comment>(This is an example and might have changed since it was taken)</comment>
138USE="x86 oss apm arts avi berkdb crypt cups encode foomaticdb gdbm gif gpm 138USE="x86 oss apm arts avi berkdb bitmap-fonts crypt cups encode fortran f77
139 gtk gtk2 imlib jpeg kde gnome libg++ libwww mad mikmod motif mpeg ncurses 139 foomaticdb gdbm gif gpm gtk gtk2 imlib jpeg kde gnome libg++ libwww mad
140 nls oggvorbis opengl pam pdflib png python qt quicktime readline sdl 140 mikmod motif mpeg ncurses nls oggvorbis opengl pam pdflib png python qt
141 slang spell ssl svga tcpd truetype X xml2 xmms xv zlib" 141 quicktime readline sdl spell ssl svga tcpd truetype X xml2 xmms xv zlib"
142</pre> 142</pre>
143 143
144<p> 144<p>
145As you can see, this variable already contains quite a lot of keywords. Do 145As you can see, this variable already contains quite a lot of keywords. Do
146<b>not</b> alter any <path>make.defaults</path> file to tailor 146<b>not</b> alter any <path>make.defaults</path> file to tailor
147the <c>USE</c> variable to your needs: changes in this file will be undone when 147the <c>USE</c> variable to your needs: changes in this file will be undone when
148you update Portage! 148you update Portage!
149</p> 149</p>
150 150
151<p> 151<p>
152To change this default setting, you need to add or remove keywords to the 152To change this default setting, you need to add or remove keywords to the
153<c>USE</c> variable. This is done globally by defining the <c>USE</c> variable 153<c>USE</c> variable. This is done globally by defining the <c>USE</c> variable
154in <path>/etc/make.conf</path>. In this variable you add the extra USE-flags you 154in <path>/etc/make.conf</path>. In this variable you add the extra USE-flags you
155require, or remove the USE-flags you don't want. This latter is done by 155require, or remove the USE-flags you don't want. This latter is done by
156prefixing the keyword with the minus-sign ("-"). 156prefixing the keyword with the minus-sign ("-").

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

  ViewVC Help
Powered by ViewVC 1.1.20