| 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.32 2005/05/27 18:35:41 swift Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.33 2005/07/13 23:53:43 vapier Exp $ --> |
| 8 | |
8 | |
| 9 | <sections> |
9 | <sections> |
| 10 | |
10 | |
| 11 | <version>1.29</version> |
11 | <version>1.29</version> |
| 12 | <date>2005-05-27</date> |
12 | <date>2005-05-27</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> |
| 21 | When you are installing Gentoo (or any other distribution, or even operating |
21 | When you are installing Gentoo (or any other distribution, or even operating |
| 22 | system for that matter) you make choices depending on the environment you are |
22 | system for that matter) you make choices depending on the environment you are |
| … | |
… | |
| 129 | variable. To make it easy for users to search and pick USE-flags, we already |
129 | variable. To make it easy for users to search and pick USE-flags, we already |
| 130 | provide a <e>default</e> USE setting. This setting is a collection of USE-flags |
130 | provide a <e>default</e> USE setting. This setting is a collection of USE-flags |
| 131 | we think are commonly used by the Gentoo users. This default setting is declared |
131 | we think are commonly used by the Gentoo users. This default setting is declared |
| 132 | in the <path>make.defaults</path> files part of your profile. |
132 | in the <path>make.defaults</path> files part of your profile. |
| 133 | </p> |
133 | </p> |
| 134 | |
134 | |
| 135 | <p> |
135 | <p> |
| 136 | The profile your system listens to is pointed to by the |
136 | The profile your system listens to is pointed to by the |
| 137 | <path>/etc/make.profile</path> symlink. Each profile works on top of another, |
137 | <path>/etc/make.profile</path> symlink. Each profile works on top of another, |
| 138 | larger profile, the end result is therefore the sum of all profiles. The top |
138 | larger profile, the end result is therefore the sum of all profiles. The top |
| 139 | profile is the <path>base</path> profile |
139 | profile is the <path>base</path> profile |
| 140 | (<path>/usr/portage/profiles/base</path>). |
140 | (<path>/usr/portage/profiles/base</path>). |
| 141 | </p> |
141 | </p> |
| 142 | |
142 | |
| 143 | <p> |
143 | <p> |
| 144 | Let us take a look at this default setting: |
144 | Let us take a look at this default setting for the 2004.3 profile: |
| 145 | </p> |
145 | </p> |
| 146 | |
146 | |
| 147 | <pre caption="Cumulated /usr/portage/profiles/default-linux/x86/2004.3/make.defaults USE variable"> |
147 | <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, |
148 | <comment>(This example is the sum of the settings in base, default-linux, |
| 149 | default-linux/x86 and default-linux/x86/2004.3)</comment> |
149 | default-linux/x86 and default-linux/x86/2004.3)</comment> |
| 150 | USE="x86 oss apm arts avi berkdb bitmap-fonts crypt cups encode fortran f77 |
150 | USE="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 |
151 | foomaticdb gdbm gif gpm gtk gtk2 imlib jpeg kde gnome libg++ libwww mad |
| 152 | mikmod motif mpeg ncurses nls oggvorbis opengl pam pdflib png python qt |
152 | 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" |
153 | quicktime readline sdl spell ssl svga tcpd truetype X xml2 xmms xv zlib" |
| 154 | </pre> |
154 | </pre> |
| 155 | |
155 | |
| 156 | <p> |
156 | <p> |
| 157 | As you can see, this variable already contains quite a lot of keywords. Do |
157 | As you can see, this variable already contains quite a lot of keywords. Do |
| 158 | <b>not</b> alter any <path>make.defaults</path> file to tailor |
158 | <b>not</b> alter any <path>make.defaults</path> file to tailor |
| 159 | the <c>USE</c> variable to your needs: changes in this file will be undone when |
159 | the <c>USE</c> variable to your needs: changes in this file will be undone when |
| 160 | you update Portage! |
160 | you update Portage! |
| 161 | </p> |
161 | </p> |
| 162 | |
162 | |