/[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.24 Revision 1.25
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.24 2005/08/12 10:29:12 neysx Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.25 2005/09/20 18:24:14 swift 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="greg_g@gentoo.org">Gregorio Guidi</mail> 9 <mail link="greg_g@gentoo.org">Gregorio Guidi</mail>
10</author> 10</author>
11 11
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.5 --> 17<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
18<license/> 18<license/>
487that if you run <c>emerge --depclean</c>, Portage will try to remove them from 487that if you run <c>emerge --depclean</c>, Portage will try to remove them from
488your system. If you need any of those packages, add them to 488your system. If you need any of those packages, add them to
489<path>/var/lib/portage/world</path> after the profile switch, or manually 489<path>/var/lib/portage/world</path> after the profile switch, or manually
490emerge them. 490emerge them.
491</p> 491</p>
492 492
493<p> 493<p>
494<b>ppc</b> - <c>sys-fs/udev</c> is now the default instead of 494<b>ppc</b> - <c>sys-fs/udev</c> is now the default instead of
495<c>sys-fs/devfs</c> for newly installed machines. This has no 495<c>sys-fs/devfs</c> for newly installed machines. This has no
496effect on already installed machines, though. 496effect on already installed machines, though.
497</p> 497</p>
498 498
499</body> 499</body>
500</section> 500</section>
501<section> 501<section>
502<title>Updating Portage to Support Cascading Profiles</title>
503<body>
504
505<p>
506Although this section does not seem to integrate well in this upgrading guide,
507it is quite important. Any profile listed above this section requires a Portage
508version that supports cascading profiles. However, some obsoleted profiles don't
509allow the user to upgrade Portage or the user is using a profile that isn't
510available anymore - any attempt to upgrade Portage will result in a failure.
511</p>
512
513<p>
514To work around this problem, users can set a temporary symbolic link to the
515<e>obsolete</e> profile, allowing them to upgrade their Portage after which
516they can continue with the upgrade procedure set forth in this guide:
517</p>
518
519<pre caption="Updating Portage through the obsolete profile">
520# <i>rm /etc/make.profile</i>
521# <i>cd /etc</i>
522# <i>ln -sf ../usr/portage/profiles/obsolete make.profile</i>
523# <i>emerge -n '>=sys-apps/portage-2.0.51'</i>
524</pre>
525
526</body>
527</section>
528<section>
502<title>Updating to 2004.2</title> 529<title>Updating to 2004.2</title>
503<body> 530<body>
504 531
505<p> 532<p>
506To switch to the 2004.2 profile, point the <path>/etc/make.profile</path> 533To switch to the 2004.2 profile, point the <path>/etc/make.profile</path>
507symlink to the new location: 534symlink to the new location:
508</p> 535</p>
509 536
510<warn> 537<warn>
511Don't forget to upgrade Portage <e>before</e> you change your profile!!! 538Don't forget to upgrade Portage <e>before</e> you change your profile!!!
512</warn> 539</warn>
513 540
514<pre caption="Updating the /etc/make.profile symlink"> 541<pre caption="Updating the /etc/make.profile symlink">
515<comment>substitute &lt;arch&gt; with your arch</comment> 542<comment>substitute &lt;arch&gt; with your arch</comment>
516# <i>rm /etc/make.profile</i> 543# <i>rm /etc/make.profile</i>

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

  ViewVC Help
Powered by ViewVC 1.1.20