/[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.23 Revision 1.24
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.23 2005/06/27 00:27:17 vanquirius Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.24 2005/08/12 10:29:12 neysx 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">
12<abstract> 12<abstract>
13This document explains how new Gentoo releases affect existing installs. 13This document explains how new Gentoo releases affect existing installs.
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/2.0 --> 17<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
18<license/> 18<license/>
19 19
20<version>2.12</version> 20<version>2.13</version>
21<date>2005-06-27</date> 21<date>2005-08-12</date>
22 22
23<chapter> 23<chapter>
24<title>Gentoo and Upgrades</title> 24<title>Gentoo and Upgrades</title>
25<section> 25<section>
26<title>Philosophy</title> 26<title>Philosophy</title>
97 97
98<p> 98<p>
99The profile in use is determined by the symbolic link 99The profile in use is determined by the symbolic link
100<path>/etc/make.profile</path>, which points to a subdirectory of 100<path>/etc/make.profile</path>, which points to a subdirectory of
101<path>/usr/portage/profiles</path> which holds the profile files. For 101<path>/usr/portage/profiles</path> which holds the profile files. For
102instance, the default x86 2005.0 profile can be found 102instance, the default x86 2005.1 profile can be found
103at <path>/usr/portage/profiles/default-linux/x86/2005.0</path>. 103at <path>/usr/portage/profiles/default-linux/x86/2005.1</path>.
104The files in the parent directories are part of the profile as well (and 104The files in the parent directories are part of the profile as well (and
105are therefore shared by different subprofiles). This is why we call these 105are therefore shared by different subprofiles). This is why we call these
106<e>cascaded profiles</e>. 106<e>cascaded profiles</e>.
107</p> 107</p>
108 108
118<p> 118<p>
119There are various reasons that a new profile may be created: the release of 119There are various reasons that a new profile may be created: the release of
120new versions of core packages (such as <c>baselayout</c>, <c>gcc</c>, or 120new versions of core packages (such as <c>baselayout</c>, <c>gcc</c>, or
121<c>glibc</c>) that are incompatible with previous versions, a change in 121<c>glibc</c>) that are incompatible with previous versions, a change in
122the default USE flags or in the virtual mappings, or maybe a change in 122the default USE flags or in the virtual mappings, or maybe a change in
123system-wide settings (such as defining udev to be the default manager 123system-wide settings.
124for <path>/dev</path> instead of devfs).
125</p> 124</p>
126 125
127</body> 126</body>
128</section> 127</section>
129</chapter> 128</chapter>
151<section> 150<section>
152<title>Releases with profile changes</title> 151<title>Releases with profile changes</title>
153<body> 152<body>
154 153
155<p> 154<p>
156If a release (such as 2005.0) introduces a new profile, you have the choice 155If a release (such as 2005.1 for x86) introduces a new profile, you have the
157to migrate to the new profile. 156choice to migrate to the new profile.
158</p> 157</p>
159 158
160<p> 159<p>
161Naturally, you are not forced to do so, and you can continue to use the old 160Naturally, you are not forced to do so, and you can continue to use the old
162profile and just update your packages 161profile and just update your packages
203 <th>Other supported profiles</th> 202 <th>Other supported profiles</th>
204</tr> 203</tr>
205<tr> 204<tr>
206 <th>alpha</th> 205 <th>alpha</th>
207 <ti>2005.0, 2005.0/2.4</ti> 206 <ti>2005.0, 2005.0/2.4</ti>
207 <ti></ti>
208</tr>
209<tr>
210 <th>arm</th>
208 <ti>2004.3</ti> 211 <ti>2004.3</ti>
209</tr>
210<tr>
211 <th>arm</th>
212 <ti>2005.0</ti> 212 <ti></ti>
213 <ti>2004.3</ti>
214</tr> 213</tr>
215<tr> 214<tr>
216 <th>amd64</th> 215 <th>amd64</th>
217 <ti>2005.0, 2005.0/no-multilib</ti> 216 <ti>2005.1, 2005.1/no-multilib</ti>
218 <ti>2004.3</ti> 217 <ti>2005.0, 2005.0/no-multilib, 2004.3</ti>
219</tr> 218</tr>
220<tr> 219<tr>
221 <th>hppa</th> 220 <th>hppa</th>
222 <ti>2005.0, 2005.0/2.4</ti> 221 <ti>2005.0, 2005.0/2.4</ti>
223 <ti>2004.3, 2004.2</ti> 222 <ti>2004.3, 2004.2</ti>
224</tr> 223</tr>
225<tr> 224<tr>
226 <th>ia64</th> 225 <th>ia64</th>
227 <ti>2005.0</ti> 226 <ti>2005.0</ti>
228 <ti></ti> 227 <ti>2004.3</ti>
229</tr> 228</tr>
230<tr> 229<tr>
231 <th>ppc</th> 230 <th>ppc</th>
232 <ti>2005.0</ti> 231 <ti>2005.1</ti>
233 <ti>2004.3, 2004.0</ti> 232 <ti>2005.0, 2004.3, 2004.0</ti>
234</tr> 233</tr>
235<tr> 234<tr>
236 <th>mips</th> 235 <th>mips</th>
237 <ti>2005.0</ti> 236 <ti>2005.0</ti>
238 <ti>2004.2</ti> 237 <ti>2004.2</ti>
239</tr> 238</tr>
240<tr> 239<tr>
241 <th>s390</th> 240 <th>s390</th>
241 <ti>2004.3</ti>
242 <ti></ti>
243</tr>
244<tr>
245 <th>sparc</th>
246 <ti>2005.1</ti>
242 <ti>2005.0</ti> 247 <ti>2005.0</ti>
243 <ti>2004.3</ti>
244</tr>
245<tr>
246 <th>sparc</th>
247 <ti>2005.0</ti>
248 <ti>2004.3, 2004.0</ti>
249</tr> 248</tr>
250<tr> 249<tr>
251 <th>x86</th> 250 <th>x86</th>
251 <ti>2005.1, 2005.1/2.4</ti>
252 <ti>2005.0, 2005.0/2.4</ti> 252 <ti>2005.0, 2005.0/2.4</ti>
253 <ti>2004.3, 2004.2, 2004.0</ti>
254</tr> 253</tr>
255</table> 254</table>
256 255
257</body> 256</body>
258</section> 257</section>
259</chapter> 258</chapter>
260 259
261<chapter id="instructions"> 260<chapter id="instructions">
262<title>Profile updating instructions</title> 261<title>Profile updating instructions</title>
262<section>
263<title>Updating to 2005.1</title>
264<body>
265
266<p>
267To switch to the 2005.1 profile, point the <path>/etc/make.profile</path>
268symlink to the new location. Make sure your Portage is updated before you
269change your profile.
270</p>
271
272<pre caption="Changing to a 2005.1 profile">
273# <i>rm /etc/make.profile</i>
274# <i>ln -s ../usr/portage/profiles/</i>&lt;selected profile&gt;<i> /etc/make.profile</i>
275</pre>
276
277<p>
278<b>All archs</b> - There are no fundamental changes in this profile. No
279specific action needs to be performed.
280</p>
281
282<p>
283<b>ppc</b> - With the 2005.1 release, the ppc and ppc64 profiles were merged
284and a number of subprofiles for specific subarchitectures were created. Make
285sure you choose the correct subprofile for your system when migrating to a
2862005.1 profile.
287</p>
288
289</body>
290</section>
263<section> 291<section>
264<title>Updating to 2005.0</title> 292<title>Updating to 2005.0</title>
265<body> 293<body>
266 294
267<p> 295<p>

Legend:
Removed from v.1.23  
changed lines
  Added in v.1.24

  ViewVC Help
Powered by ViewVC 1.1.20