| 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.13 2004/05/07 07:42:53 swift Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-use.xml,v 1.14 2004/06/30 21:44:46 neysx 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> |
| 17 | When you are installing Gentoo (or any other distribution, or even operating |
17 | When you are installing Gentoo (or any other distribution, or even operating |
| 18 | system for that matter) you make choices depending on the environment you are |
18 | system for that matter) you make choices depending on the environment you are |
| 19 | working with. A setup for a server differs from a setup for a workstation. |
19 | working with. A setup for a server differs from a setup for a workstation. |
| 20 | A gaming workstation differs from a 3D rendering workstation. |
20 | A gaming workstation differs from a 3D rendering workstation. |
| 21 | </p> |
21 | </p> |
| 22 | |
22 | |
| … | |
… | |
| 112 | |
112 | |
| 113 | <p> |
113 | <p> |
| 114 | In the hope you are convinced of the importance of USE-flags we will now inform |
114 | In the hope you are convinced of the importance of USE-flags we will now inform |
| 115 | you how to declare USE-flags. |
115 | you how to declare USE-flags. |
| 116 | </p> |
116 | </p> |
| 117 | |
117 | |
| 118 | <p> |
118 | <p> |
| 119 | As previously mentioned, all USE-flags are declared inside the <c>USE</c> |
119 | As previously mentioned, all USE-flags are declared inside the <c>USE</c> |
| 120 | variable. To make it easy for users to search and pick USE-flags, we already |
120 | variable. To make it easy for users to search and pick USE-flags, we already |
| 121 | provide a <e>default</e> USE setting. This setting is a collection of USE-flags |
121 | provide a <e>default</e> USE setting. This setting is a collection of USE-flags |
| 122 | we think are commonly used by the Gentoo users. This default setting is declared |
122 | we think are commonly used by the Gentoo users. This default setting is declared |
| 123 | in the <path>/etc/make.profile/make.defaults</path> file. Let us take a look at |
123 | in the <path>/etc/make.profile/make.defaults</path> file. Let us take a look at |
| 124 | this default setting: |
124 | this default setting: |
| 125 | </p> |
125 | </p> |
| 126 | |
126 | |
| 127 | <pre caption="/etc/make.profile/make.defaults USE variable"> |
127 | <pre caption="/etc/make.profile/make.defaults USE variable on an x86 system"> |
| 128 | USE="x86 oss apm arts avi berkdb crypt cups encode foomaticdb gdbm gif gpm gtk |
128 | USE="x86 oss apm arts avi berkdb crypt cups encode foomaticdb gdbm gif gpm |
| 129 | imlib jpeg kde gnome libg++ libwww mad mikmod motif mpeg ncurses nls |
129 | gtk gtk2 imlib jpeg kde gnome libg++ libwww mad mikmod motif mpeg ncurses |
| 130 | oggvorbis opengl pam pdflib png python qt quicktime readline sdl slang |
130 | nls oggvorbis opengl pam pdflib png python qt quicktime readline sdl |
| 131 | spell ssl svga tcpd truetype X xml2 xmms xv zlib" |
131 | slang spell ssl svga tcpd truetype X xml2 xmms xv zlib" |
| 132 | </pre> |
132 | </pre> |
| 133 | |
133 | |
| 134 | <p> |
134 | <p> |
| 135 | As you can see, this variable already contains quite a lot of keywords. Do |
135 | As you can see, this variable already contains quite a lot of keywords. Do |
| 136 | <b>not</b> alter the <path>/etc/make.profile/make.defaults</path> file to tailor |
136 | <b>not</b> alter the <path>/etc/make.profile/make.defaults</path> file to tailor |
| 137 | the <c>USE</c> variable to your needs: changes in this file will be undone when |
137 | the <c>USE</c> variable to your needs: changes in this file will be undone when |
| 138 | you update Portage! |
138 | you update Portage! |
| 139 | </p> |
139 | </p> |
| 140 | |
140 | |
| 141 | <p> |
141 | <p> |
| 142 | To change this default setting, you need to add or remove keywords to the |
142 | To change this default setting, you need to add or remove keywords to the |
| 143 | <c>USE</c> variable. This is done globally by defining the <c>USE</c> variable |
143 | <c>USE</c> variable. This is done globally by defining the <c>USE</c> variable |
| 144 | in <path>/etc/make.conf</path>. In this variable you add the extra USE-flags you |
144 | in <path>/etc/make.conf</path>. In this variable you add the extra USE-flags you |
| 145 | require, or remove the USE-flags you don't want. This latter is done by |
145 | require, or remove the USE-flags you don't want. This latter is done by |
| 146 | prefixing the keyword with the minus-sign ("-"). |
146 | prefixing the keyword with the minus-sign ("-"). |