/[gentoo]/xml/htdocs/doc/en/gentoo-upgrading.xml
Gentoo

Diff of /xml/htdocs/doc/en/gentoo-upgrading.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.4 Revision 1.5
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.4 2004/07/01 00:48:49 neysx Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.5 2004/07/26 19:35:29 dertobi123 Exp $ -->
4 4
5<guide link="/doc/en/gentoo-upgrading.xml"> 5<guide link="/doc/en/gentoo-upgrading.xml">
6<title>Gentoo Upgrading Guide</title> 6<title>Gentoo Upgrading Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="g.guidi@sns.it">Gregorio Guidi</mail> 9 <mail link="g.guidi@sns.it">Gregorio Guidi</mail>
10</author> 10</author>
11 11
12<abstract> 12<abstract>
13This document explains how to react when a new Gentoo release is announced. 13This document explains how to react when a new Gentoo release is announced.
14</abstract> 14</abstract>
15 15
16<!-- The content of this document is licensed under the CC-BY-SA license --> 16<!-- The content of this document is licensed under the CC-BY-SA license -->
17<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 17<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
18<license/> 18<license/>
89when it makes tricky changes to some default parameters, we say that it 89when it makes tricky changes to some default parameters, we say that it
90provides a new <e>profile</e>. 90provides a new <e>profile</e>.
91</p> 91</p>
92 92
93<p> 93<p>
94A <e>profile</e> is a set of configuration files, stored in a subdirectory of 94A <e>profile</e> is a set of configuration files, stored in a subdirectory of
95<path>/usr/portage/profiles/</path>, that describe things such as the ebuilds 95<path>/usr/portage/profiles/</path>, that describe things such as the ebuilds
96that are considered <e>system</e> packages, the default USE flags, the default 96that are considered <e>system</e> packages, the default USE flags, the default
97mapping for virtual packages. 97mapping for virtual packages.
98</p> 98</p>
99 99
100<p> 100<p>
101The profile in use is determined by the symbolic link 101The profile in use is determined by the symbolic link
102<path>/etc/make.profile</path>, which points to the subdirectory of 102<path>/etc/make.profile</path>, which points to the subdirectory of
103<path>/usr/portage/profiles</path> which holds the profile files, for instance 103<path>/usr/portage/profiles</path> which holds the profile files, for instance
104<path>/usr/portage/profiles/default-x86-2004.0</path> (old-style location) or 104<path>/usr/portage/profiles/default-x86-2004.2</path> (old-style location) or
105<path>/usr/portage/profiles/default-linux/x86/2004.0</path> (new-style 105<path>/usr/portage/profiles/default-linux/x86/2004.2</path> (new-style
106location). With respect to new-style profile directories, note that also the 106location). With respect to new-style profile directories, note that also the
107files in parent directories are part of the profile (and are therefore shared 107files in parent directories are part of the profile (and are therefore shared
108by different profiles). 108by different profiles).
109</p> 109</p>
110 110
111<p> 111<p>
112Profiles obsoleted by new ones are kept in <path>/usr/portage/profiles</path> 112Profiles obsoleted by new ones are kept in <path>/usr/portage/profiles</path>
113as the current ones, but they are marked as deprecated. When that happens a 113as the current ones, but they are marked as deprecated. When that happens a
114file named <path>deprecated</path> is put in the profile directory. The content 114file named <path>deprecated</path> is put in the profile directory. The content
115of this file is the name of the profile that should substitute it; portage uses 115of this file is the name of the profile that should substitute it; portage uses
116this information to automatically warn you about the new profile. 116this information to automatically warn you about the new profile.
117</p> 117</p>
118 118
119<p> 119<p>
120There are various reasons that justify the creation of a new profile: the 120There are various reasons that justify the creation of a new profile: the
192<title>Supported profiles</title> 192<title>Supported profiles</title>
193<body> 193<body>
194 194
195<p> 195<p>
196The following profiles are officially supported by Gentoo developers: 196The following profiles are officially supported by Gentoo developers:
197</p> 197</p>
198 198
199<table> 199<table>
200<tr> 200<tr>
201 <th>Architecture</th> 201 <th>Architecture</th>
202 <th>Most recent profile</th> 202 <th>Most recent profile</th>
203 <th>Other supported profiles</th> 203 <th>Other supported profiles</th>
204</tr> 204</tr>
205<tr> 205<tr>
206 <th>x86</th> 206 <th>x86</th>
207 <ti>2004.2</ti>
208 <ti>2004.0, 1.4</ti>
209</tr>
210<tr>
211 <th>hardened-x86</th>
212 <ti>2004.0</ti>
213 <ti></ti>
214</tr>
215<tr>
216 <th>amd64</th>
217 <ti>2004.2</ti>
218 <ti>2004.0</ti>
219</tr>
220<tr>
221 <th>ppc</th>
222 <ti>2004.0</ti>
223 <ti></ti>
224</tr>
225<tr>
226 <th>sparc</th>
207 <ti>2004.0</ti> 227 <ti>2004.0</ti>
208 <ti>1.4</ti> 228 <ti>1.4</ti>
209</tr> 229</tr>
210<tr> 230<tr>
211 <th>hardened-x86</th> 231 <th>mips</th>
232 <ti>2004.1</ti>
233 <ti>1.4</ti>
234</tr>
235<tr>
236 <th>hppa</th>
212 <ti>2004.0</ti> 237 <ti>2004.0</ti>
213 <ti></ti> 238 <ti></ti>
214</tr> 239</tr>
215<tr> 240<tr>
216 <th>amd64</th> 241 <th>arm</th>
217 <ti>2004.0</ti>
218 <ti></ti>
219</tr>
220<tr>
221 <th>ppc</th>
222 <ti>2004.0</ti>
223 <ti></ti>
224</tr>
225<tr>
226 <th>sparc</th>
227 <ti>2004.0</ti>
228 <ti>1.4</ti>
229</tr>
230<tr>
231 <th>mips</th>
232 <ti>2004.0</ti>
233 <ti>1.4</ti>
234</tr>
235<tr>
236 <th>hppa</th>
237 <ti>2004.0</ti> 242 <ti>2004.0</ti>
238 <ti></ti> 243 <ti></ti>
239</tr> 244</tr>
240</table> 245</table>
241 246
242</body> 247</body>
243</section> 248</section>
244</chapter> 249</chapter>
245 250
246<chapter> 251<chapter>
247<title>Profile updating instructions</title> 252<title>Profile updating instructions</title>
248<section> 253<section>
249<title>Updating from 1.4 to 2004.0 (all archs)</title> 254<title>Updating to 2004.2</title>
250<body> 255<body>
251 256
252<p> 257<p>
253There are no fundamental changes between 1.4 and 2004.0 profiles. Just point 258To switch to the 2004.2 profile, point the <path>/etc/make.profile</path> link
254the <path>/etc/make.profile</path> link to the new location: 259to the new location:
255</p> 260</p>
256 261
257<pre caption="Updating the /etc/make.profile link"> 262<pre caption="Updating the /etc/make.profile link">
263<comment>substitute &lt;arch&gt; with your arch</comment>
258# <i>rm /etc/make.profile</i> 264# <i>rm /etc/make.profile</i>
259# <i>ln -s ../usr/portage/profiles/default-linux/x86/2004.0 /etc/make.profile</i> 265# <i>ln -s ../usr/portage/profiles/default-&lt;arch&gt;-2004.2 /etc/make.profile</i>
260</pre> 266</pre>
267
268<p>
269<b>x86</b> - This profile changes the default X11 implementation from
270<c>x11-base/xfree</c> to <c>x11-base/xorg-x11</c>. This change only touches
271the <e>default</e> value, and is only relevant for those who have not installed
272an X server yet. If you already have one installed, then it will not affect
273you at all, you are free to switch from one X server to the other exactly as
274before.
275</p>
276
277<p>
278<b>amd64</b> - There are no fundamental changes from previous profiles, no
279specific action needs to be performed.
280</p>
281
282</body>
283</section>
284<section>
285<title>Updating to 2004.0</title>
286<body>
287
288<p>
289To switch to the 2004.0 profile, point the <path>/etc/make.profile</path> link
290to the new location:
291</p>
292
293<pre caption="Updating the /etc/make.profile link">
294<comment>substitute &lt;arch&gt; with your arch</comment>
295# <i>rm /etc/make.profile</i>
296# <i>ln -s ../usr/portage/profiles/default-&lt;arch&gt;-2004.0 /etc/make.profile</i>
297</pre>
298
299<p>
300<b>All archs</b> - There are no fundamental changes from previous profiles, no
301specific action needs to be performed.
302</p>
261 303
262</body> 304</body>
263</section> 305</section>
264<section> 306<section>
265<title>Updating from profiles older than 1.4 to 1.4</title> 307<title>Updating from profiles older than 1.4 to 1.4</title>
266<body> 308<body>
267 309
268<p> 310<p>
269The instructions for this upgrade are quite complex, you can find them 311The instructions for this upgrade are quite complex, you can find them
270<uri link="/doc/en/new-upgrade-to-gentoo-1.4.xml">here</uri>. 312<uri link="/doc/en/new-upgrade-to-gentoo-1.4.xml">here</uri>.
271</p> 313</p>
272 314
273</body> 315</body>
274</section> 316</section>
275</chapter> 317</chapter>

Legend:
Removed from v.1.4  
changed lines
  Added in v.1.5

  ViewVC Help
Powered by ViewVC 1.1.20