Go to:
Gentoo Home
Documentation
Forums
Lists
Bugs
Planet
Store
Wiki
Get Gentoo!
Gentoo's Bugzilla – Attachment 72245 Details for
Bug 105809
Changes to documentation to help ease end-user issues
Home
|
New
–
[Ex]
|
Browse
|
Search
|
Privacy Policy
|
[?]
|
Reports
|
Requests
|
Help
|
New Account
|
Log In
[x]
|
Forgot Password
Login:
[x]
[patch]
Patch to Gentoo docs regarding stage1/2 deprecation
TEMPFILE (text/plain), 94.67 KB, created by
Sven Vermeulen (RETIRED)
on 2005-11-05 15:07:15 UTC
(
hide
)
Description:
Patch to Gentoo docs regarding stage1/2 deprecation
Filename:
MIME Type:
Creator:
Sven Vermeulen (RETIRED)
Created:
2005-11-05 15:07:15 UTC
Size:
94.67 KB
patch
obsolete
>Index: faq.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/faq.xml,v >retrieving revision 1.98 >diff -u -t -r1.98 faq.xml >--- faq.xml 9 Sep 2005 08:29:49 -0000 1.98 >+++ faq.xml 5 Nov 2005 23:04:59 -0000 >@@ -120,6 +120,10 @@ > <uri link="#dualboot">I want to boot Windows from GRUB or LILO but it shows > only black screen. What should I do?</uri> > </li> >+ <li> >+ <uri link="#stage12">How do I Install Gentoo Using a Stage1 or Stage2 >+ Tarball?</uri> >+ </li> > </ul> > > </body> >@@ -533,8 +537,8 @@ > </p> > > <p> >-If you are building from a Stage 1, please note that many more options exist >-than those for which Gentoo builds binary stages. Please see the <uri >+Please note that many more options exist than those for which Gentoo builds >+binary stages. Please see the <uri > link="http://gcc.gnu.org/onlinedocs/gcc-3.4.4/gcc/i386-and-x86_002d64-Options.html#i386-and-x86_002d64-Options">gcc > guide</uri> for setting <c>-march</c>. > </p> >@@ -618,6 +622,49 @@ > > </body> > </section> >+<section id="stage12"> >+<title>How do I Install Gentoo Using a Stage1 or Stage2 Tarball?</title> >+<body> >+ >+<p> >+The Gentoo Handbook only describes a Gentoo installation using a stage3 tarball. >+However, Gentoo still provides stage1 and stage2 tarballs. This is for >+development purposes (the Release Engineering team starts from a stage1 tarball >+to obtain a stage3) but shouldn't be used by users: a stage3 tarball can very >+well be used to bootstrap the system. You do need a working Internet connection. >+</p> >+ >+<p> >+Bootstrapping means building the toolchain (the C library and compiler) for >+your system after which you install all core system packages. To bootstrap the >+system, perform a stage3 installation. Before you start the chapter on >+<e>Configuring the Kernel</e>, modify the <path>bootstrap.sh</path> script to >+suit your needs and then run it: >+</p> >+ >+<pre caption="Bootstrapping the system"> >+# <i>cd /usr/portage/scripts</i> >+# <i>vi bootstrap.sh</i> >+ >+# <i>./bootstrap.sh</i> >+</pre> >+ >+<p> >+Next, rebuild all core system packages with the newly built toolchain. We need >+to rebuild them since the stage3 tarball already offers them: >+</p> >+ >+<pre caption="Rebuilding the core system packages"> >+# <i>emerge -e system</i> >+</pre> >+ >+<p> >+Now you can continue with <e>Configuring the Kernel</e>. You can not use the >+prebuilt GRP packages anymore though. >+</p> >+ >+</body> >+</section> > </chapter> > > <chapter> >Index: handbook/handbook-alpha.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v >retrieving revision 1.117 >diff -u -t -r1.117 handbook-alpha.xml >--- handbook/handbook-alpha.xml 13 Oct 2005 15:08:00 -0000 1.117 >+++ handbook/handbook-alpha.xml 5 Nov 2005 23:05:01 -0000 >@@ -170,8 +170,8 @@ > <chapter> > <title>Installing the Gentoo Installation Files</title> > <abstract> >-Gentoo installs work through so-called stage-files. In this chapter we >-describe how you extract a stage-file and configure Portage. >+Gentoo installs work through a stage3 archive. In this chapter we >+describe how you extract the stage3 archive and configure Portage. > </abstract> > <include href="hb-install-stage.xml"/> > </chapter> >Index: handbook/handbook-amd64.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v >retrieving revision 1.125 >diff -u -t -r1.125 handbook-amd64.xml >--- handbook/handbook-amd64.xml 13 Oct 2005 15:08:00 -0000 1.125 >+++ handbook/handbook-amd64.xml 5 Nov 2005 23:05:01 -0000 >@@ -170,8 +170,8 @@ > <chapter> > <title>Installing the Gentoo Installation Files</title> > <abstract> >-Gentoo installs work through so-called stage-files. In this chapter we >-describe how you extract a stage-file and configure Portage. >+Gentoo installs work through a stage3 archive. In this chapter we >+describe how you extract the stage3 archive and configure Portage. > </abstract> > <include href="hb-install-stage.xml"/> > </chapter> >Index: handbook/handbook-hppa.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v >retrieving revision 1.114 >diff -u -t -r1.114 handbook-hppa.xml >--- handbook/handbook-hppa.xml 13 Oct 2005 15:08:00 -0000 1.114 >+++ handbook/handbook-hppa.xml 5 Nov 2005 23:05:02 -0000 >@@ -170,8 +170,8 @@ > <chapter> > <title>Installing the Gentoo Installation Files</title> > <abstract> >-Gentoo installs work through so-called stage-files. In this chapter we >-describe how you extract a stage-file and configure Portage. >+Gentoo installs work through a stage3 archive. In this chapter we >+describe how you extract the stage3 archive and configure Portage. > </abstract> > <include href="hb-install-stage.xml"/> > </chapter> >Index: handbook/handbook-mips.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v >retrieving revision 1.104 >diff -u -t -r1.104 handbook-mips.xml >--- handbook/handbook-mips.xml 13 Oct 2005 15:08:00 -0000 1.104 >+++ handbook/handbook-mips.xml 5 Nov 2005 23:05:03 -0000 >@@ -172,8 +172,8 @@ > <chapter> > <title>Installing the Gentoo Installation Files</title> > <abstract> >-Gentoo installs work through so-called stage-files. In this chapter we >-describe how you extract a stage-file and configure Portage. >+Gentoo installs work through a stage3 archive. In this chapter we >+describe how you extract the stage3 archive and configure Portage. > </abstract> > <include href="hb-install-stage.xml"/> > </chapter> >Index: handbook/handbook-ppc.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v >retrieving revision 1.134 >diff -u -t -r1.134 handbook-ppc.xml >--- handbook/handbook-ppc.xml 13 Oct 2005 15:08:00 -0000 1.134 >+++ handbook/handbook-ppc.xml 5 Nov 2005 23:05:05 -0000 >@@ -173,8 +173,8 @@ > <chapter> > <title>Installing the Gentoo Installation Files</title> > <abstract> >-Gentoo installs work through so-called stage-files. In this chapter we describe >-how you extract a stage-file and configure Portage. >+Gentoo installs work through a stage3 archive. In this chapter we describe >+how you extract a stage3 archive and configure Portage. > </abstract> > <include href="hb-install-stage.xml"/> > </chapter> >Index: handbook/handbook-ppc64.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v >retrieving revision 1.56 >diff -u -t -r1.56 handbook-ppc64.xml >--- handbook/handbook-ppc64.xml 13 Oct 2005 15:08:00 -0000 1.56 >+++ handbook/handbook-ppc64.xml 5 Nov 2005 23:05:05 -0000 >@@ -170,8 +170,8 @@ > <chapter> > <title>Installing the Gentoo Installation Files</title> > <abstract> >-Gentoo installs work through so-called stage-files. In this chapter we describe >-how you extract a stage-file and configure Portage. >+Gentoo installs work through a stage3 archive. In this chapter we describe >+how you extract a stage3 archive and configure Portage. > </abstract> > <include href="hb-install-stage.xml"/> > </chapter> >Index: handbook/handbook-sparc.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v >retrieving revision 1.117 >diff -u -t -r1.117 handbook-sparc.xml >--- handbook/handbook-sparc.xml 13 Oct 2005 15:08:00 -0000 1.117 >+++ handbook/handbook-sparc.xml 5 Nov 2005 23:05:06 -0000 >@@ -170,8 +170,8 @@ > <chapter> > <title>Installing the Gentoo Installation Files</title> > <abstract> >-Gentoo installs work through so-called stage-files. In this chapter we >-describe how you extract a stage-file and configure Portage. >+Gentoo installs work through a stage3 archive. In this chapter we >+describe how you extract the stage3 archive and configure Portage. > </abstract> > <include href="hb-install-stage.xml"/> > </chapter> >Index: handbook/handbook-x86.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v >retrieving revision 1.144 >diff -u -t -r1.144 handbook-x86.xml >--- handbook/handbook-x86.xml 13 Oct 2005 15:08:00 -0000 1.144 >+++ handbook/handbook-x86.xml 5 Nov 2005 23:05:07 -0000 >@@ -170,8 +170,8 @@ > <chapter> > <title>Installing the Gentoo Installation Files</title> > <abstract> >-Gentoo installs work through so-called stage-files. In this chapter we >-describe how you extract a stage-file and configure Portage. >+Gentoo installs work through a stage3 archive. In this chapter we >+describe how you extract the stage3 archive and configure Portage. > </abstract> > <include href="hb-install-stage.xml"/> > </chapter> >Index: handbook/hb-install-alpha-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v >retrieving revision 1.36 >diff -u -t -r1.36 hb-install-alpha-medium.xml >--- handbook/hb-install-alpha-medium.xml 9 Oct 2005 16:33:54 -0000 1.36 >+++ handbook/hb-install-alpha-medium.xml 5 Nov 2005 23:05:08 -0000 >@@ -53,208 +53,9 @@ > </body> > </subsection> > </section> >-<!-- Copy/paste from the hb-install-x86-medium.xml file. --> >-<!-- START --> >-<section> >-<title>The Gentoo Installation Approaches</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-To help you decide what stage file you want to use, we have written down the >-major advantages and disadvantages of each stage file. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage1 Approach</title> >-<body> >- >-<p> >-A <e>stage1</e> is used when you want to bootstrap and build the entire system >-from scratch. >-</p> >- >-<p> >-This approach builds core system packages that are vital to your system and is >-used by Gentoo developers to prepare the Gentoo release media. It is a great >-installation method for those who would like to learn more about the inner >-workings of bootstrapping, toolchains and the like. >-</p> >- >-<p> >-However, if you do not plan to tweak the bootstrapping instructions in the >-<path>bootstrap.sh</path> script written by the Gentoo developers, then a >-stage1 approach has no benefits for you. >-</p> >- >-<table> >-<tr> >- <th>Stage1</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- Allows you to have total control over the installation routine, bootstrap >- sequence, etc. >- </ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Suitable for powerusers and developers who know what they are doing</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Takes a long time to finish the installation (it is the lengthiest approach) >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- If you don't intend to tweak the settings, it is a waste of time >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage2 Approach</title> >-<body> >- >-<p> >-A <e>stage2</e> is used for building the entire system from a bootstrapped >-"semi-compiled" state. >-</p> >- >-<p> >-When you perform a stage2 installation approach, you will build all system >-packages (core packages, including toolchain) using your specific <c>USE</c>, >-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be >-optimized to your preference. >-</p> >- >-<p> >-However, this installation takes some time and if you do not intend to change >-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good >-default", using this approach only makes sense if your <c>USE</c> variable is >-sufficiently different from the default <c>USE</c> we provide. >-</p> >- >-<table> >-<tr> >- <th>Stage2</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>You don't need to bootstrap</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Faster than starting with stage1</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>You can still tweak your settings</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti>It's still not the fastest way to install Gentoo</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage3 Approach</title> >-<body> >- >-<p> >-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been >-built for you. You will only need to build a few packages (such as system >-logger, networking tools, ...) before you can boot into a base Gentoo >-installation. >-</p> >- >-<p> >-Choosing to go with a stage3 allows for the fastest install of Gentoo >-Linux, but also means that your base system will have the optimization >-settings that we chose for you (which to be honest, are good settings >-and were carefully chosen to enhance performance while maintaining >-stability). Stage3 is also required if you want to install Gentoo using >-prebuilt packages or without a network connection. >-</p> >- >-<table> >-<tr> >- <th>Stage3</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>Fastest way to get a Gentoo base system</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- You can still tweak your system >- </ti> >-</tr> >-</table> >- >-<p> >-You might be interested to know that, if you decide to use different >-optimization settings after having installed Gentoo, you will be able to >-recompile your entire system with the new optimization settings. The same goes >-for any <c>USE</c> flag changes: Portage is intelligent enough to know what >-packages need to be rebuild. >-</p> >- >-</body> >-</subsection> >-</section> > >+<!-- Copy/paste from hb-install-x86-medium.xml --> >+<!-- START --> > <section> > <title>The Gentoo Installation CDs</title> > <subsection> >@@ -294,8 +95,8 @@ > </li> > <li> > The Gentoo Universal Installation CD, a bootable CD with the same abilities >- as the Minimal Installation CD. Additionally, it contains a stage1 and >- several stage3 tarballs (optimized for the individual subarchitectures). >+ as the Minimal Installation CD. Additionally, it contains several stage3 >+ tarballs (optimized for the individual subarchitectures). > </li> > </ul> > >@@ -326,16 +127,9 @@ > <ti>Smallest download</ti> > </tr> > <tr> >- <th>+</th> >- <ti> >- You can do a stage1, stage2 or stage3 by getting the stage tarball off the >- net >- </ti> >-</tr> >-<tr> > <th>-</th> > <ti> >- Contains no stages, no Portage snapshot, no prebuilt packages and is >+ Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is > therefore not suitable for networkless installation > </ti> > </tr> >@@ -392,7 +186,24 @@ > > <p> > If you intend to use the Packages CD to quickly install additional software, >-make sure that you use the same subarchitecture as the stage-3 tarball you use. >+make sure that you use the same subarchitecture as the stage3 tarball you use. >+</p> >+ >+</body> >+</subsection> >+<subsection> >+<title>The Stage3 Tarball</title> >+<body> >+ >+<p> >+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable >+to continue the Gentoo installation using the instructions in this manual. >+Previously, the Gentoo Handbook described the installation using one of three >+stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the >+official installation method uses the stage3 tarball. If you are interested in >+performing a Gentoo installation using a stage1 or stage2 tarball, please read >+the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo >+Using a Stage1 or Stage2 Tarball?</uri> > </p> > > </body> >Index: handbook/hb-install-amd64-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml,v >retrieving revision 1.38 >diff -u -t -r1.38 hb-install-amd64-medium.xml >--- handbook/hb-install-amd64-medium.xml 31 Oct 2005 13:31:33 -0000 1.38 >+++ handbook/hb-install-amd64-medium.xml 5 Nov 2005 23:05:09 -0000 >@@ -58,206 +58,6 @@ > <!-- Copy/paste from hb-install-x86-medium.xml --> > <!-- START --> > <section> >-<title>The Gentoo Installation Approaches</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-To help you decide what stage file you want to use, we have written down the >-major advantages and disadvantages of each stage file. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage1 Approach</title> >-<body> >- >-<p> >-A <e>stage1</e> is used when you want to bootstrap and build the entire system >-from scratch. >-</p> >- >-<p> >-This approach builds core system packages that are vital to your system and is >-used by Gentoo developers to prepare the Gentoo release media. It is a great >-installation method for those who would like to learn more about the inner >-workings of bootstrapping, toolchains and the like. >-</p> >- >-<p> >-However, if you do not plan to tweak the bootstrapping instructions in the >-<path>bootstrap.sh</path> script written by the Gentoo developers, then a >-stage1 approach has no benefits for you. >-</p> >- >-<table> >-<tr> >- <th>Stage1</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- Allows you to have total control over the installation routine, bootstrap >- sequence, etc. >- </ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Suitable for powerusers and developers who know what they are doing</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Takes a long time to finish the installation (it is the lengthiest approach) >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- If you don't intend to tweak the settings, it is a waste of time >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage2 Approach</title> >-<body> >- >-<p> >-A <e>stage2</e> is used for building the entire system from a bootstrapped >-"semi-compiled" state. >-</p> >- >-<p> >-When you perform a stage2 installation approach, you will build all system >-packages (core packages, including toolchain) using your specific <c>USE</c>, >-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be >-optimized to your preference. >-</p> >- >-<p> >-However, this installation takes some time and if you do not intend to change >-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good >-default", using this approach only makes sense if your <c>USE</c> variable is >-sufficiently different from the default <c>USE</c> we provide. >-</p> >- >-<table> >-<tr> >- <th>Stage2</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>You don't need to bootstrap</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Faster than starting with stage1</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>You can still tweak your settings</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti>It's still not the fastest way to install Gentoo</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage3 Approach</title> >-<body> >- >-<p> >-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been >-built for you. You will only need to build a few packages (such as system >-logger, networking tools, ...) before you can boot into a base Gentoo >-installation. >-</p> >- >-<p> >-Choosing to go with a stage3 allows for the fastest install of Gentoo >-Linux, but also means that your base system will have the optimization >-settings that we chose for you (which to be honest, are good settings >-and were carefully chosen to enhance performance while maintaining >-stability). Stage3 is also required if you want to install Gentoo using >-prebuilt packages or without a network connection. >-</p> >- >-<table> >-<tr> >- <th>Stage3</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>Fastest way to get a Gentoo base system</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- You can still tweak your system >- </ti> >-</tr> >-</table> >- >-<p> >-You might be interested to know that, if you decide to use different >-optimization settings after having installed Gentoo, you will be able to >-recompile your entire system with the new optimization settings. The same goes >-for any <c>USE</c> flag changes: Portage is intelligent enough to know what >-packages need to be rebuild. >-</p> >- >-</body> >-</subsection> >-</section> >- >-<section> > <title>The Gentoo Installation CDs</title> > <subsection> > <title>Introduction</title> >@@ -296,9 +96,8 @@ > </li> > <li> > The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same >- abilities as the Minimal Installation CD. Additionally, it contains a >- stage1 and several stage3 tarballs (optimized for the individual >- subarchitectures). >+ abilities as the Minimal Installation CD. Additionally, it contains >+ several stage3 tarballs (optimized for the individual subarchitectures). > </li> > </ul> > >@@ -330,16 +129,9 @@ > <ti>Smallest download</ti> > </tr> > <tr> >- <th>+</th> >- <ti> >- You can do a stage1, stage2 or stage3 by getting the stage tarball off the >- net >- </ti> >-</tr> >-<tr> > <th>-</th> > <ti> >- Contains no stages, no Portage snapshot, no prebuilt packages and is >+ Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is > therefore not suitable for networkless installation > </ti> > </tr> >@@ -395,7 +187,24 @@ > > <p> > If you intend to use the Packages CD to quickly install additional software, >-make sure that you use the same subarchitecture as the stage-3 tarball you use. >+make sure that you use the same subarchitecture as the stage3 tarball you use. >+</p> >+ >+</body> >+</subsection> >+<subsection> >+<title>The Stage3 Tarball</title> >+<body> >+ >+<p> >+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable >+to continue the Gentoo installation using the instructions in this manual. >+Previously, the Gentoo Handbook described the installation using one of three >+stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the >+official installation method uses the stage3 tarball. If you are interested in >+performing a Gentoo installation using a stage1 or stage2 tarball, please read >+the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo >+Using a Stage1 or Stage2 Tarball?</uri> > </p> > > </body> >Index: handbook/hb-install-hppa-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v >retrieving revision 1.34 >diff -u -t -r1.34 hb-install-hppa-medium.xml >--- handbook/hb-install-hppa-medium.xml 25 Oct 2005 17:27:35 -0000 1.34 >+++ handbook/hb-install-hppa-medium.xml 5 Nov 2005 23:05:10 -0000 >@@ -56,206 +56,6 @@ > <!-- Copy/paste from hb-install-x86-medium.xml --> > <!-- START --> > <section> >-<title>The Gentoo Installation Approaches</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-To help you decide what stage file you want to use, we have written down the >-major advantages and disadvantages of each stage file. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage1 Approach</title> >-<body> >- >-<p> >-A <e>stage1</e> is used when you want to bootstrap and build the entire system >-from scratch. >-</p> >- >-<p> >-This approach builds core system packages that are vital to your system and is >-used by Gentoo developers to prepare the Gentoo release media. It is a great >-installation method for those who would like to learn more about the inner >-workings of bootstrapping, toolchains and the like. >-</p> >- >-<p> >-However, if you do not plan to tweak the bootstrapping instructions in the >-<path>bootstrap.sh</path> script written by the Gentoo developers, then a >-stage1 approach has no benefits for you. >-</p> >- >-<table> >-<tr> >- <th>Stage1</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- Allows you to have total control over the installation routine, bootstrap >- sequence, etc. >- </ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Suitable for powerusers and developers who know what they are doing</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Takes a long time to finish the installation (it is the lengthiest approach) >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- If you don't intend to tweak the settings, it is a waste of time >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage2 Approach</title> >-<body> >- >-<p> >-A <e>stage2</e> is used for building the entire system from a bootstrapped >-"semi-compiled" state. >-</p> >- >-<p> >-When you perform a stage2 installation approach, you will build all system >-packages (core packages, including toolchain) using your specific <c>USE</c>, >-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be >-optimized to your preference. >-</p> >- >-<p> >-However, this installation takes some time and if you do not intend to change >-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good >-default", using this approach only makes sense if your <c>USE</c> variable is >-sufficiently different from the default <c>USE</c> we provide. >-</p> >- >-<table> >-<tr> >- <th>Stage2</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>You don't need to bootstrap</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Faster than starting with stage1</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>You can still tweak your settings</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti>It's still not the fastest way to install Gentoo</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage3 Approach</title> >-<body> >- >-<p> >-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been >-built for you. You will only need to build a few packages (such as system >-logger, networking tools, ...) before you can boot into a base Gentoo >-installation. >-</p> >- >-<p> >-Choosing to go with a stage3 allows for the fastest install of Gentoo >-Linux, but also means that your base system will have the optimization >-settings that we chose for you (which to be honest, are good settings >-and were carefully chosen to enhance performance while maintaining >-stability). Stage3 is also required if you want to install Gentoo using >-prebuilt packages or without a network connection. >-</p> >- >-<table> >-<tr> >- <th>Stage3</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>Fastest way to get a Gentoo base system</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- You can still tweak your system >- </ti> >-</tr> >-</table> >- >-<p> >-You might be interested to know that, if you decide to use different >-optimization settings after having installed Gentoo, you will be able to >-recompile your entire system with the new optimization settings. The same goes >-for any <c>USE</c> flag changes: Portage is intelligent enough to know what >-packages need to be rebuild. >-</p> >- >-</body> >-</subsection> >-</section> >- >-<section> > <title>The Gentoo Installation CDs</title> > <subsection> > <title>Introduction</title> >@@ -294,9 +94,8 @@ > </li> > <li> > The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same >- abilities as the Minimal Installation CD. Additionally, it contains a >- stage1 and several stage3 tarballs (optimized for the individual >- subarchitectures). >+ abilities as the Minimal Installation CD. Additionally, it contains >+ several stage3 tarballs (optimized for the individual subarchitectures). > </li> > </ul> > >@@ -327,16 +126,9 @@ > <ti>Smallest download</ti> > </tr> > <tr> >- <th>+</th> >- <ti> >- You can do a stage1, stage2 or stage3 by getting the stage tarball off the >- net >- </ti> >-</tr> >-<tr> > <th>-</th> > <ti> >- Contains no stages, no Portage snapshot, no prebuilt packages and is >+ Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is > therefore not suitable for networkless installation > </ti> > </tr> >@@ -390,7 +182,24 @@ > > <p> > If you intend to use the Packages CD to quickly install additional software, >-make sure that you use the same subarchitecture as the stage-3 tarball you use. >+make sure that you use the same subarchitecture as the stage3 tarball you use. >+</p> >+ >+</body> >+</subsection> >+<subsection> >+<title>The Stage3 Tarball</title> >+<body> >+ >+<p> >+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable >+to continue the Gentoo installation using the instructions in this manual. >+Previously, the Gentoo Handbook described the installation using one of three >+stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the >+official installation method uses the stage3 tarball. If you are interested in >+performing a Gentoo installation using a stage1 or stage2 tarball, please read >+the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo >+Using a Stage1 or Stage2 Tarball?</uri> > </p> > > </body> >Index: handbook/hb-install-mips-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v >retrieving revision 1.15 >diff -u -t -r1.15 hb-install-mips-medium.xml >--- handbook/hb-install-mips-medium.xml 9 Oct 2005 16:33:54 -0000 1.15 >+++ handbook/hb-install-mips-medium.xml 5 Nov 2005 23:05:12 -0000 >@@ -51,208 +51,9 @@ > </body> > </subsection> > </section> >-<!-- Only the stuff about the stages is replicated from the >- hb-install-x86-medium.xml file since MIPS uses netbooting >- --> >-<!-- START --> >-<section> >-<title>The Gentoo Installation Approaches</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-To help you decide what stage file you want to use, we have written down the >-major advantages and disadvantages of each stage file. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage1 Approach</title> >-<body> >- >-<p> >-A <e>stage1</e> is used when you want to bootstrap and build the entire system >-from scratch. >-</p> >- >-<p> >-This approach builds core system packages that are vital to your system and is >-used by Gentoo developers to prepare the Gentoo release media. It is a great >-installation method for those who would like to learn more about the inner >-workings of bootstrapping, toolchains and the like. >-</p> >- >-<p> >-However, if you do not plan to tweak the bootstrapping instructions in the >-<path>bootstrap.sh</path> script written by the Gentoo developers, then a >-stage1 approach has no benefits for you. >-</p> >- >-<table> >-<tr> >- <th>Stage1</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- Allows you to have total control over the installation routine, bootstrap >- sequence, etc. >- </ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Suitable for powerusers and developers who know what they are doing</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Takes a long time to finish the installation (it is the lengthiest approach) >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- If you don't intend to tweak the settings, it is a waste of time >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage2 Approach</title> >-<body> >- >-<p> >-A <e>stage2</e> is used for building the entire system from a bootstrapped >-"semi-compiled" state. >-</p> >- >-<p> >-When you perform a stage2 installation approach, you will build all system >-packages (core packages, including toolchain) using your specific <c>USE</c>, >-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be >-optimized to your preference. >-</p> >- >-<p> >-However, this installation takes some time and if you do not intend to change >-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good >-default", using this approach only makes sense if your <c>USE</c> variable is >-sufficiently different from the default <c>USE</c> we provide. >-</p> >- >-<table> >-<tr> >- <th>Stage2</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>You don't need to bootstrap</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Faster than starting with stage1</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>You can still tweak your settings</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti>It's still not the fastest way to install Gentoo</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> > >-</body> >-</subsection> >-<subsection> >-<title>A Stage3 Approach</title> >-<body> >- >-<p> >-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been >-built for you. You will only need to build a few packages (such as system >-logger, networking tools, ...) before you can boot into a base Gentoo >-installation. >-</p> >- >-<p> >-Choosing to go with a stage3 allows for the fastest install of Gentoo >-Linux, but also means that your base system will have the optimization >-settings that we chose for you (which to be honest, are good settings >-and were carefully chosen to enhance performance while maintaining >-stability). Stage3 is also required if you want to install Gentoo using >-prebuilt packages or without a network connection. >-</p> >- >-<table> >-<tr> >- <th>Stage3</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>Fastest way to get a Gentoo base system</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- You can still tweak your system >- </ti> >-</tr> >-</table> >- >-<p> >-You might be interested to know that, if you decide to use different >-optimization settings after having installed Gentoo, you will be able to >-recompile your entire system with the new optimization settings. The same goes >-for any <c>USE</c> flag changes: Portage is intelligent enough to know what >-packages need to be rebuild. >-</p> >- >-</body> >-</subsection> >+<section> >+<title>Installation Notes</title> > <subsection> > <title>A note about Processor Architectures</title> > <body> >@@ -394,7 +195,23 @@ > > </body> > </subsection> >+<subsection> >+<title>The Stage3 Tarball</title> >+<body> > >+<p> >+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable >+to continue the Gentoo installation using the instructions in this manual. >+Previously, the Gentoo Handbook described the installation using one of three >+stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the >+official installation method uses the stage3 tarball. If you are interested in >+performing a Gentoo installation using a stage1 or stage2 tarball, please read >+the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo >+Using a Stage1 or Stage2 Tarball?</uri> >+</p> >+ >+</body> >+</subsection> > </section> > > <section> >Index: handbook/hb-install-ppc-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v >retrieving revision 1.48 >diff -u -t -r1.48 hb-install-ppc-medium.xml >--- handbook/hb-install-ppc-medium.xml 9 Oct 2005 16:33:54 -0000 1.48 >+++ handbook/hb-install-ppc-medium.xml 5 Nov 2005 23:05:13 -0000 >@@ -81,206 +81,6 @@ > <!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) --> > <!-- START --> > <section> >-<title>The Gentoo Installation Approaches</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-To help you decide what stage file you want to use, we have written down the >-major advantages and disadvantages of each stage file. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage1 Approach</title> >-<body> >- >-<p> >-A <e>stage1</e> is used when you want to bootstrap and build the entire system >-from scratch. >-</p> >- >-<p> >-This approach builds core system packages that are vital to your system and is >-used by Gentoo developers to prepare the Gentoo release media. It is a great >-installation method for those who would like to learn more about the inner >-workings of bootstrapping, toolchains and the like. >-</p> >- >-<p> >-However, if you do not plan to tweak the bootstrapping instructions in the >-<path>bootstrap.sh</path> script written by the Gentoo developers, then a >-stage1 approach has no benefits for you. >-</p> >- >-<table> >-<tr> >- <th>Stage1</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- Allows you to have total control over the installation routine, bootstrap >- sequence, etc. >- </ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Suitable for powerusers and developers who know what they are doing</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Takes a long time to finish the installation (it is the lengthiest approach) >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- If you don't intend to tweak the settings, it is a waste of time >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage2 Approach</title> >-<body> >- >-<p> >-A <e>stage2</e> is used for building the entire system from a bootstrapped >-"semi-compiled" state. >-</p> >- >-<p> >-When you perform a stage2 installation approach, you will build all system >-packages (core packages, including toolchain) using your specific <c>USE</c>, >-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be >-optimized to your preference. >-</p> >- >-<p> >-However, this installation takes some time and if you do not intend to change >-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good >-default", using this approach only makes sense if your <c>USE</c> variable is >-sufficiently different from the default <c>USE</c> we provide. >-</p> >- >-<table> >-<tr> >- <th>Stage2</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>You don't need to bootstrap</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Faster than starting with stage1</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>You can still tweak your settings</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti>It's still not the fastest way to install Gentoo</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage3 Approach</title> >-<body> >- >-<p> >-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been >-built for you. You will only need to build a few packages (such as system >-logger, networking tools, ...) before you can boot into a base Gentoo >-installation. >-</p> >- >-<p> >-Choosing to go with a stage3 allows for the fastest install of Gentoo >-Linux, but also means that your base system will have the optimization >-settings that we chose for you (which to be honest, are good settings >-and were carefully chosen to enhance performance while maintaining >-stability). Stage3 is also required if you want to install Gentoo using >-prebuilt packages or without a network connection. >-</p> >- >-<table> >-<tr> >- <th>Stage3</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>Fastest way to get a Gentoo base system</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- You can still tweak your system >- </ti> >-</tr> >-</table> >- >-<p> >-You might be interested to know that, if you decide to use different >-optimization settings after having installed Gentoo, you will be able to >-recompile your entire system with the new optimization settings. The same goes >-for any <c>USE</c> flag changes: Portage is intelligent enough to know what >-packages need to be rebuild. >-</p> >- >-</body> >-</subsection> >-</section> >- >-<section> > <title>The Gentoo Installation CDs</title> > <subsection> > <title>Introduction</title> >@@ -319,9 +119,8 @@ > </li> > <li> > The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same >- abilities as the Minimal Installation CD. Additionally, it contains a >- stage1 and several stage3 tarballs (optimized for the individual >- subarchitectures). >+ abilities as the Minimal Installation CD. Additionally, it contains >+ several stage3 tarballs (optimized for the individual subarchitectures). > </li> > </ul> > >@@ -352,16 +151,9 @@ > <ti>Smallest download</ti> > </tr> > <tr> >- <th>+</th> >- <ti> >- You can do a stage1, stage2 or stage3 by getting the stage tarball off the >- net >- </ti> >-</tr> >-<tr> > <th>-</th> > <ti> >- Contains no stages, no Portage snapshot, no prebuilt packages and is >+ Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is > therefore not suitable for networkless installation > </ti> > </tr> >@@ -416,7 +208,24 @@ > > <p> > If you intend to use the Packages CD to quickly install additional software, >-make sure that you use the same subarchitecture as the stage-3 tarball you use. >+make sure that you use the same subarchitecture as the stage3 tarball you use. >+</p> >+ >+</body> >+</subsection> >+<subsection> >+<title>The Stage3 Tarball</title> >+<body> >+ >+<p> >+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable >+to continue the Gentoo installation using the instructions in this manual. >+Previously, the Gentoo Handbook described the installation using one of three >+stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the >+official installation method uses the stage3 tarball. If you are interested in >+performing a Gentoo installation using a stage1 or stage2 tarball, please read >+the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo >+Using a Stage1 or Stage2 Tarball?</uri> > </p> > > </body> >Index: handbook/hb-install-ppc64-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v >retrieving revision 1.24 >diff -u -t -r1.24 hb-install-ppc64-medium.xml >--- handbook/hb-install-ppc64-medium.xml 9 Oct 2005 16:33:54 -0000 1.24 >+++ handbook/hb-install-ppc64-medium.xml 5 Nov 2005 23:05:14 -0000 >@@ -64,206 +64,6 @@ > <!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ --> > <!-- START --> > <section> >-<title>The Gentoo Installation Approaches</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-To help you decide what stage file you want to use, we have written down the >-major advantages and disadvantages of each stage file. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage1 Approach</title> >-<body> >- >-<p> >-A <e>stage1</e> is used when you want to bootstrap and build the entire system >-from scratch. >-</p> >- >-<p> >-This approach builds core system packages that are vital to your system and is >-used by Gentoo developers to prepare the Gentoo release media. It is a great >-installation method for those who would like to learn more about the inner >-workings of bootstrapping, toolchains and the like. >-</p> >- >-<p> >-However, if you do not plan to tweak the bootstrapping instructions in the >-<path>bootstrap.sh</path> script written by the Gentoo developers, then a >-stage1 approach has no benefits for you. >-</p> >- >-<table> >-<tr> >- <th>Stage1</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- Allows you to have total control over the installation routine, bootstrap >- sequence, etc. >- </ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Suitable for powerusers and developers who know what they are doing</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Takes a long time to finish the installation (it is the lengthiest approach) >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- If you don't intend to tweak the settings, it is a waste of time >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage2 Approach</title> >-<body> >- >-<p> >-A <e>stage2</e> is used for building the entire system from a bootstrapped >-"semi-compiled" state. >-</p> >- >-<p> >-When you perform a stage2 installation approach, you will build all system >-packages (core packages, including toolchain) using your specific <c>USE</c>, >-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be >-optimized to your preference. >-</p> >- >-<p> >-However, this installation takes some time and if you do not intend to change >-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good >-default", using this approach only makes sense if your <c>USE</c> variable is >-sufficiently different from the default <c>USE</c> we provide. >-</p> >- >-<table> >-<tr> >- <th>Stage2</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>You don't need to bootstrap</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Faster than starting with stage1</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>You can still tweak your settings</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti>It's still not the fastest way to install Gentoo</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage3 Approach</title> >-<body> >- >-<p> >-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been >-built for you. You will only need to build a few packages (such as system >-logger, networking tools, ...) before you can boot into a base Gentoo >-installation. >-</p> >- >-<p> >-Choosing to go with a stage3 allows for the fastest install of Gentoo >-Linux, but also means that your base system will have the optimization >-settings that we chose for you (which to be honest, are good settings >-and were carefully chosen to enhance performance while maintaining >-stability). Stage3 is also required if you want to install Gentoo using >-prebuilt packages or without a network connection. >-</p> >- >-<table> >-<tr> >- <th>Stage3</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>Fastest way to get a Gentoo base system</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- You can still tweak your system >- </ti> >-</tr> >-</table> >- >-<p> >-You might be interested to know that, if you decide to use different >-optimization settings after having installed Gentoo, you will be able to >-recompile your entire system with the new optimization settings. The same goes >-for any <c>USE</c> flag changes: Portage is intelligent enough to know what >-packages need to be rebuild. >-</p> >- >-</body> >-</subsection> >-</section> >- >-<section> > <title>The Gentoo Installation CDs</title> > <subsection> > <title>Introduction</title> >@@ -321,16 +121,9 @@ > <ti>Smallest download</ti> > </tr> > <tr> >- <th>+</th> >- <ti> >- You can do a stage1, stage2 or stage3 by getting the stage tarball off the >- net >- </ti> >-</tr> >-<tr> > <th>-</th> > <ti> >- Contains no stages, no Portage snapshot, no prebuilt packages and is >+ Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is > therefore not suitable for networkless installation > </ti> > </tr> >@@ -338,6 +131,23 @@ > > </body> > </subsection> >+<subsection> >+<title>The Stage3 Tarball</title> >+<body> >+ >+<p> >+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable >+to continue the Gentoo installation using the instructions in this manual. >+Previously, the Gentoo Handbook described the installation using one of three >+stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the >+official installation method uses the stage3 tarball. If you are interested in >+performing a Gentoo installation using a stage1 or stage2 tarball, please read >+the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo >+Using a Stage1 or Stage2 Tarball?</uri> >+</p> >+ >+</body> >+</subsection> > </section> > <!-- STOP --> > <section> >Index: handbook/hb-install-sparc-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v >retrieving revision 1.35 >diff -u -t -r1.35 hb-install-sparc-medium.xml >--- handbook/hb-install-sparc-medium.xml 9 Oct 2005 16:33:54 -0000 1.35 >+++ handbook/hb-install-sparc-medium.xml 5 Nov 2005 23:05:15 -0000 >@@ -63,206 +63,6 @@ > <!-- Warning: The part originally contains "x86" --> > <!-- START --> > <section> >-<title>The Gentoo Installation Approaches</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-To help you decide what stage file you want to use, we have written down the >-major advantages and disadvantages of each stage file. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage1 Approach</title> >-<body> >- >-<p> >-A <e>stage1</e> is used when you want to bootstrap and build the entire system >-from scratch. >-</p> >- >-<p> >-This approach builds core system packages that are vital to your system and is >-used by Gentoo developers to prepare the Gentoo release media. It is a great >-installation method for those who would like to learn more about the inner >-workings of bootstrapping, toolchains and the like. >-</p> >- >-<p> >-However, if you do not plan to tweak the bootstrapping instructions in the >-<path>bootstrap.sh</path> script written by the Gentoo developers, then a >-stage1 approach has no benefits for you. >-</p> >- >-<table> >-<tr> >- <th>Stage1</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- Allows you to have total control over the installation routine, bootstrap >- sequence, etc. >- </ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Suitable for powerusers and developers who know what they are doing</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Takes a long time to finish the installation (it is the lengthiest approach) >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- If you don't intend to tweak the settings, it is a waste of time >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage2 Approach</title> >-<body> >- >-<p> >-A <e>stage2</e> is used for building the entire system from a bootstrapped >-"semi-compiled" state. >-</p> >- >-<p> >-When you perform a stage2 installation approach, you will build all system >-packages (core packages, including toolchain) using your specific <c>USE</c>, >-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be >-optimized to your preference. >-</p> >- >-<p> >-However, this installation takes some time and if you do not intend to change >-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good >-default", using this approach only makes sense if your <c>USE</c> variable is >-sufficiently different from the default <c>USE</c> we provide. >-</p> >- >-<table> >-<tr> >- <th>Stage2</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>You don't need to bootstrap</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Faster than starting with stage1</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>You can still tweak your settings</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti>It's still not the fastest way to install Gentoo</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage3 Approach</title> >-<body> >- >-<p> >-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been >-built for you. You will only need to build a few packages (such as system >-logger, networking tools, ...) before you can boot into a base Gentoo >-installation. >-</p> >- >-<p> >-Choosing to go with a stage3 allows for the fastest install of Gentoo >-Linux, but also means that your base system will have the optimization >-settings that we chose for you (which to be honest, are good settings >-and were carefully chosen to enhance performance while maintaining >-stability). Stage3 is also required if you want to install Gentoo using >-prebuilt packages or without a network connection. >-</p> >- >-<table> >-<tr> >- <th>Stage3</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>Fastest way to get a Gentoo base system</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- You can still tweak your system >- </ti> >-</tr> >-</table> >- >-<p> >-You might be interested to know that, if you decide to use different >-optimization settings after having installed Gentoo, you will be able to >-recompile your entire system with the new optimization settings. The same goes >-for any <c>USE</c> flag changes: Portage is intelligent enough to know what >-packages need to be rebuild. >-</p> >- >-</body> >-</subsection> >-</section> >- >-<section> > <title>The Gentoo Installation CDs</title> > <subsection> > <title>Introduction</title> >@@ -301,9 +101,8 @@ > </li> > <li> > The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same >- abilities as the Minimal Installation CD. Additionally, it contains a >- stage1 and several stage3 tarballs (optimized for the individual >- subarchitectures). >+ abilities as the Minimal Installation CD. Additionally, it contains >+ several stage3 tarballs (optimized for the individual subarchitectures). > </li> > </ul> > >@@ -342,16 +141,9 @@ > <ti>Smallest download</ti> > </tr> > <tr> >- <th>+</th> >- <ti> >- You can do a stage1, stage2 or stage3 by getting the stage tarball off the >- net >- </ti> >-</tr> >-<tr> > <th>-</th> > <ti> >- Contains no stages, no Portage snapshot, no prebuilt packages and is >+ Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is > therefore not suitable for networkless installation > </ti> > </tr> >@@ -407,7 +199,24 @@ > > <p> > If you intend to use the Packages CD to quickly install additional software, >-make sure that you use the same subarchitecture as the stage-3 tarball you use. >+make sure that you use the same subarchitecture as the stage3 tarball you use. >+</p> >+ >+</body> >+</subsection> >+<subsection> >+<title>The Stage3 Tarball</title> >+<body> >+ >+<p> >+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable >+to continue the Gentoo installation using the instructions in this manual. >+Previously, the Gentoo Handbook described the installation using one of three >+stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the >+official installation method uses the stage3 tarball. If you are interested in >+performing a Gentoo installation using a stage1 or stage2 tarball, please read >+the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo >+Using a Stage1 or Stage2 Tarball?</uri> > </p> > > </body> >Index: handbook/hb-install-stage.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v >retrieving revision 1.89 >diff -u -t -r1.89 hb-install-stage.xml >--- handbook/hb-install-stage.xml 13 Aug 2005 21:21:30 -0000 1.89 >+++ handbook/hb-install-stage.xml 5 Nov 2005 23:05:16 -0000 >@@ -49,8 +49,8 @@ > <body> > > <p> >-The next step you need to perform is to install the <e>stage</e> tarball of >-your choice onto your system. You have the option of downloading the required >+The next step you need to perform is to install the <e>stage3</e> tarball >+onto your system. You have the option of downloading the required > tarball from the Internet or, if you are booted from one of the Gentoo > Universal Installation CDs, copy it over from the CD itself. If you have a > Universal CD and the stage you want to use is on the CD, downloading it from >@@ -124,14 +124,19 @@ > </pre> > > <p> >+Make sure you download a stage3 tarball - installations using a stage1 or stage2 >+tarball are not supported anymore. >+</p> >+ >+<p> > If you want to check the integrity of the downloaded stage tarball, use > <c>md5sum</c> and compare the output with the MD5 checksum provided on the > mirror. For instance, to check the validity of the x86 stage tarball: > </p> > > <pre caption="Example checking integrity of a stage tarball"> >-# <i>md5sum -c stage1-x86-2005.1.tar.bz2.md5</i> >-stage1-x86-2005.1.tar.bz2: OK >+# <i>md5sum -c stage3-x86-2005.1.tar.bz2.md5</i> >+stage3-x86-2005.1.tar.bz2: OK > </pre> > > </body> >@@ -146,7 +151,7 @@ > </p> > > <pre caption="Unpacking the stage"> >-# <i>tar -xvjpf stage?-*.tar.bz2</i> >+# <i>tar -xvjpf stage3-*.tar.bz2</i> > </pre> > > <p> >@@ -340,105 +345,11 @@ > <title>CHOST</title> > <body> > >-<warn> >-Although it might be tempting for non-stage1 users, they should <e>not</e> >-change the <c>CHOST</c> setting in <path>make.conf</path>. Doing so might render >-their system unusable. Again: only change this variable if you use a >-<e>stage1</e> installation. >-</warn> >- >-<p> >-The <c>CHOST</c> variable defines what architecture <c>gcc</c> has to >-compile programs for. The possibilities are: >-</p> >- >-<table> >-<tr> >- <th>Architecture</th> >- <th>Subarchitecture</th> >- <th>CHOST Setting</th> >-</tr> >-<tr> >- <ti>x86</ti> >- <ti>i386</ti> >- <ti>i386-pc-linux-gnu</ti> >-</tr> >-<tr> >- <ti>x86</ti> >- <ti>i486</ti> >- <ti>i486-pc-linux-gnu</ti> >-</tr> >-<tr> >- <ti>x86</ti> >- <ti>i586</ti> >- <ti>i586-pc-linux-gnu</ti> >-</tr> >-<tr> >- <ti>x86</ti> >- <ti>i686 and above (incl. athlon)</ti> >- <ti>i686-pc-linux-gnu</ti> >-</tr> >-<tr> >- <ti>alpha</ti> >- <ti></ti> >- <ti>alpha-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>ppc</ti> >- <ti></ti> >- <ti>powerpc-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>ppc64</ti> >- <ti></ti> >- <ti>powerpc64-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>sparc</ti> >- <ti></ti> >- <ti>sparc-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>sparc64</ti> >- <ti></ti> >- <ti>sparc-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>hppa</ti> >- <ti>(generic)</ti> >- <ti>hppa-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>hppa</ti> >- <ti>pa7000</ti> >- <ti>hppa1.1-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>hppa</ti> >- <ti>pa8000 and above</ti> >- <ti>hppa2.0-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>mips</ti> >- <ti></ti> >- <ti>mips-unknown-linux-gnu</ti> >-</tr> >-<tr> >- <ti>amd64</ti> >- <ti></ti> >- <ti>x86_64-pc-linux-gnu</ti> >-</tr> >-</table> >- >-<p> >-Please, make sure that you use the <e>correct</e> CHOST setting. For instance, >-the CHOST setting for sparc64 still is <c>sparc-unknown-linux-gnu</c> and >-<e>not</e> <c>sparc64-unknown-linux-gnu</c>! >-</p> >- > <p> >-Users interested in bootstrapping their entire system with NPTL support on an >-x86 system need to set their CHOST to <c>i586-pc-linux-gnu</c> or higher. >+The <c>CHOST</c> variable declares the target build host for your system. This >+variable should already be set to the correct value. <brite>Do not edit >+it</brite> as that might break your system. If the <c>CHOST</c> variable does >+not look correct to you, you might be using the wrong stage3 tarball. > </p> > > </body> >Index: handbook/hb-install-system.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v >retrieving revision 1.84 >diff -u -t -r1.84 hb-install-system.xml >--- handbook/hb-install-system.xml 16 Aug 2005 22:14:44 -0000 1.84 >+++ handbook/hb-install-system.xml 5 Nov 2005 23:05:17 -0000 >@@ -124,6 +124,10 @@ > > </body> > </subsection> >+</section> >+ >+<section> >+<title>Configuring Portage</title> > <subsection> > <title>Updating the Portage tree</title> > <body> >@@ -341,8 +345,7 @@ > after compiling <c>glibc</c> a full set of all available locales will be > created. As of now you can activate the <c>userlocales</c> USE flag and specify > only the locales you will need in <path>/etc/locales.build</path>. Only do this >-if you know what locales to choose. This will not work for the bootstrapping, >-but when you recompile glibc afterwards it will. >+if you know what locales to choose. > </p> > > <pre caption="Activate the userlocales USE flag especially for glibc"> >@@ -370,208 +373,11 @@ > de_DE@euro/ISO-8859-15 > </pre> > >-</body> >-</subsection> >-</section> >-<section> >-<title>Differences between Stage1, Stage2 and Stage3</title> >-<body> >- >-<p> >-Now take a seat and think of your previous steps. We asked you to >-select a <e>stage1</e>, <e>stage2</e> or <e>stage3</e> and warned you >-that your choice is important for further installation steps. Well, this >-is the first place where your choice defines the subsequent steps. >-</p> >- >-<ul> >-<li> >- If you chose <e>stage1</e>, then you have to follow <e>both</e> steps in >- this chapter (starting with <uri link="#doc_chap3">Progressing from Stage1 >- to Stage2</uri>) >-</li> >-<li> >- If you chose <e>stage2</e> you only can skip the first step >- and immediately start with the second one (<uri link="#doc_chap4">Progressing >- from Stage2 to Stage3</uri>) >-</li> >-<li> >- If you chose <e>stage3</e> then you can skip both >- steps and continue with <uri link="?part=1&chap=7">Configuring the >- Kernel</uri> >-</li> >-</ul> >- >-</body> >-</section> >-<section> >-<title>Progressing from Stage1 to Stage2</title> >-<subsection> >-<title>Introduction to Bootstrapping</title> >-<body> >- >-<p> >-So, you want to compile everything from scratch? Okay then :-) >-</p> >- >-<p> >-In this step, we will <e>bootstrap</e> your Gentoo system. This takes a >-long time, but the result is a system that has been optimized from the >-ground up for your specific machine and needs. >-</p> >- >-<p> >-<e>Bootstrapping</e> means building the GNU C Library, GNU Compiler >-Collection and several other key system programs. >-</p> >- >-<p> >-Before starting the bootstrap, you might want to download all necessary >-sourcecode first. If you do not want to do this, continue >-with <uri link="#bootstrap">Bootstrapping the System</uri>. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>Optional: Downloading the Sources First</title> >-<body> >- >-<p> >-If you haven't copied over all source code before, then the bootstrap >-script will download all necessary files. If you want to >-download the source code first and later bootstrap the system (for instance >-because you don't want to have your internet connection open during the >-compilation) use the <e>-f</e> option of the bootstrap script, which will >-fetch (hence the letter <e>f</e>) all source code for you. >-</p> >- >-<pre caption = "Downloading the necessary sources"> >-# <i>cd /usr/portage</i> >-# <i>scripts/bootstrap.sh -f</i> >-</pre> >- >-</body> >-</subsection> >-<subsection id="bootstrap"> >-<title>Bootstrapping the System</title> >-<body> >- >-<p> >-Okay then, take your keyboard and punch in the next commands to start >-the bootstrap. Then go amuse yourself with something else because this step >-takes quite some time to finish. >-</p> >- >-<pre caption = "Bootstrapping the system"> >-# <i>cd /usr/portage</i> >-# <i>scripts/bootstrap.sh</i> >-</pre> >- >-<p> >-Now continue with the next step, <uri link="#doc_chap4">Progressing from Stage2 >-to Stage3</uri>. >-</p> >- >-</body> >-</subsection> >-</section> >-<section> >-<title>Progressing from Stage2 to Stage3</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-If you are reading this section, then you have a bootstrapped system >-(either because you bootstrapped it previously, or you are using a >-<e>stage2</e>). Then it is now time to build all system packages. >-</p> >- >-<p> >-<e>All</e> system packages? No, not really. In this step, you will build >-the system packages of which there are no alternatives to use. >-Some system packages have several alternatives (such as system loggers) >-and as Gentoo is all about choices, we don't want to force one upon you. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>Optional: Viewing what will be done</title> >-<body> >- >-<p> >-If you want to know what packages will be installed, execute <c>emerge >---pretend --emptytree system</c>. This will list all packages that will be >-built. As this list is pretty big, you should also use a pager like >-<c>less</c> or <c>more</c> to go up and down the list. >-</p> >- >-<pre caption = "View what 'emerge system' will do"> >-# <i>emerge --pretend --emptytree system | less</i> >-</pre> >- >-<p> >-Note that, if you haven't touched the default CFLAGS/CXXFLAGS setting, using >-<c>emerge --pretend --newuse system</c> is sufficient: it will rebuild the >-applications that are affected by a change in USE flags (compared to the USE >-flag we used while building the stage2). If you didn't touch >-the USE flag either, why are you running a stage2 installation then? >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>Optional: Downloading the Sources</title> >-<body> >- >-<p> >-If you want <c>emerge</c> to download the sources before you continue >-(for instance because you don't want the internet connection to be left >-open while you are building all packages) you can use the <e>--fetchonly</e> >-option of <c>emerge</c> which will fetch all sources for you. >-</p> >- >-<pre caption = "Fetching the sources"> >-# <i>emerge --fetchonly --emptytree system</i> >-</pre> >- >-</body> >-</subsection> >-<subsection> >-<title>Building the System</title> >-<body> >- >-<p> >-To start building the system, execute <c>emerge --emptytree system</c>. Then >-go do something to keep your mind busy, because this step takes a long time to >-complete. >-</p> >- >-<pre caption = "Building the System"> >-# <i>emerge --emptytree system</i> >-</pre> >- > <p> >-Again, if you haven't touched the default CFLAGS and CXXFLAGS setting, using >-<c>--newuse</c> is sufficient. >-</p> >- >-<p> >-You can for now safely ignore any warnings about updated configuration files >-(and running <c>etc-update</c>). When your Gentoo system is fully installed and >-booted, do read our documentation on <uri >-link="?part=3&chap=2#doc_chap3">Configuration File Protection</uri>. >-</p> >- >-<p> >-When the build process has completed, continue with <uri >-link="?part=1&chap=7">Configuring the Kernel</uri>. >+Now continue with <uri link="?part=1&chap=7">Configuring the Kernel</uri>. > </p> > > </body> > </subsection> > </section> >- > </sections> >Index: handbook/hb-install-x86-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml,v >retrieving revision 1.40 >diff -u -t -r1.40 hb-install-x86-medium.xml >--- handbook/hb-install-x86-medium.xml 9 Oct 2005 16:33:54 -0000 1.40 >+++ handbook/hb-install-x86-medium.xml 5 Nov 2005 23:05:18 -0000 >@@ -53,205 +53,6 @@ > <!-- This part can be propagated to the other architectures as well. --> > <!-- START --> > <section> >-<title>The Gentoo Installation Approaches</title> >-<subsection> >-<title>Introduction</title> >-<body> >- >-<p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-To help you decide what stage file you want to use, we have written down the >-major advantages and disadvantages of each stage file. >-</p> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage1 Approach</title> >-<body> >- >-<p> >-A <e>stage1</e> is used when you want to bootstrap and build the entire system >-from scratch. >-</p> >- >-<p> >-This approach builds core system packages that are vital to your system and is >-used by Gentoo developers to prepare the Gentoo release media. It is a great >-installation method for those who would like to learn more about the inner >-workings of bootstrapping, toolchains and the like. >-</p> >- >-<p> >-However, if you do not plan to tweak the bootstrapping instructions in the >-<path>bootstrap.sh</path> script written by the Gentoo developers, then a >-stage1 approach has no benefits for you. >-</p> >- >-<table> >-<tr> >- <th>Stage1</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- Allows you to have total control over the installation routine, bootstrap >- sequence, etc. >- </ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Suitable for powerusers and developers who know what they are doing</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Takes a long time to finish the installation (it is the lengthiest approach) >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- If you don't intend to tweak the settings, it is a waste of time >- </ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage2 Approach</title> >-<body> >- >-<p> >-A <e>stage2</e> is used for building the entire system from a bootstrapped >-"semi-compiled" state. >-</p> >- >-<p> >-When you perform a stage2 installation approach, you will build all system >-packages (core packages, including toolchain) using your specific <c>USE</c>, >-<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be >-optimized to your preference. >-</p> >- >-<p> >-However, this installation takes some time and if you do not intend to change >-the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good >-default", using this approach only makes sense if your <c>USE</c> variable is >-sufficiently different from the default <c>USE</c> we provide. >-</p> >- >-<table> >-<tr> >- <th>Stage2</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>You don't need to bootstrap</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>Faster than starting with stage1</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti>You can still tweak your settings</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti>It's still not the fastest way to install Gentoo</ti> >-</tr> >-<tr> >- <th>-</th> >- <ti> >- Requires a working Internet connection during the installation >- </ti> >-</tr> >-</table> >- >-</body> >-</subsection> >-<subsection> >-<title>A Stage3 Approach</title> >-<body> >- >-<p> >-A <e>stage3</e> installation contains a basic Gentoo Linux system that has been >-built for you. You will only need to build a few packages (such as system >-logger, networking tools, ...) before you can boot into a base Gentoo >-installation. >-</p> >- >-<p> >-Choosing to go with a stage3 allows for the fastest install of Gentoo >-Linux, but also means that your base system will have the optimization >-settings that we chose for you (which to be honest, are good settings >-and were carefully chosen to enhance performance while maintaining >-stability). Stage3 is also required if you want to install Gentoo using >-prebuilt packages or without a network connection. >-</p> >- >-<table> >-<tr> >- <th>Stage3</th> >- <th>Pros and Cons</th> >-</tr> >-<tr> >- <th>+</th> >- <ti>Fastest way to get a Gentoo base system</ti> >-</tr> >-<tr> >- <th>+</th> >- <ti> >- You can still tweak your system >- </ti> >-</tr> >-</table> >- >-<p> >-You might be interested to know that, if you decide to use different >-optimization settings after having installed Gentoo, you will be able to >-recompile your entire system with the new optimization settings. The same goes >-for any <c>USE</c> flag changes: Portage is intelligent enough to know what >-packages need to be rebuild. >-</p> >- >-</body> >-</subsection> >-</section> >-<section> > <title>The Gentoo Installation CDs</title> > <subsection> > <title>Introduction</title> >@@ -290,9 +91,8 @@ > </li> > <li> > The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same >- abilities as the Minimal Installation CD. Additionally, it contains a >- stage1 and several stage3 tarballs (optimized for the individual >- subarchitectures). >+ abilities as the Minimal Installation CD. Additionally, it contains >+ several stage3 tarballs (optimized for the individual subarchitectures). > </li> > </ul> > >@@ -323,16 +123,9 @@ > <ti>Smallest download</ti> > </tr> > <tr> >- <th>+</th> >- <ti> >- You can do a stage1, stage2 or stage3 by getting the stage tarball off the >- net >- </ti> >-</tr> >-<tr> > <th>-</th> > <ti> >- Contains no stages, no Portage snapshot, no prebuilt packages and is >+ Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is > therefore not suitable for networkless installation > </ti> > </tr> >@@ -388,7 +181,24 @@ > > <p> > If you intend to use the Packages CD to quickly install additional software, >-make sure that you use the same subarchitecture as the stage-3 tarball you use. >+make sure that you use the same subarchitecture as the stage3 tarball you use. >+</p> >+ >+</body> >+</subsection> >+<subsection> >+<title>The Stage3 Tarball</title> >+<body> >+ >+<p> >+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable >+to continue the Gentoo installation using the instructions in this manual. >+Previously, the Gentoo Handbook described the installation using one of three >+stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the >+official installation method uses the stage3 tarball. If you are interested in >+performing a Gentoo installation using a stage1 or stage2 tarball, please read >+the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo >+Using a Stage1 or Stage2 Tarball?</uri> > </p> > > </body> >Index: handbook/index.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v >retrieving revision 1.54 >diff -u -t -r1.54 index.xml >--- handbook/index.xml 8 Aug 2005 13:48:40 -0000 1.54 >+++ handbook/index.xml 5 Nov 2005 23:05:18 -0000 >@@ -290,9 +290,7 @@ > <p> > By not separating the instructions for each possible option, the user can view > the results of the other choices easily. This provides a <b>better view on the >-installation instructions</b> for the user: even though they chose - for >-instance - stage3, they are easily informed about what stage2 or stage1 does. >-Not hiding these instructions is a good thing. >+installation instructions</b> for the user. > </p> > > </body> >@@ -302,14 +300,9 @@ > <body> > > <p> >-You are reading the wrong Gentoo Handbook. >-</p> >- >-<p> >-The release-specific Gentoo Handbooks (such as the 2005.0 one) are meant for >-networkless installations only. Running a stage1 or stage2 installation requires >-source code that isn't available on the universal installation CD, so you would >-need a working Internet connection to do a stage1 or stage2 installation. >+Instructions on using a stage1 or stage2 tarball are now available in the <uri >+link="/doc/en/faq.xml#stage12">Gentoo FAQ</uri>. A stage3 installation is the >+only supported installation as of now. > </p> > > </body> >Index: handbook/2005.1/hb-install-alpha-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml,v >retrieving revision 1.3 >diff -u -t -r1.3 hb-install-alpha-medium.xml >--- handbook/2005.1/hb-install-alpha-medium.xml 25 Aug 2005 19:53:25 -0000 1.3 >+++ handbook/2005.1/hb-install-alpha-medium.xml 5 Nov 2005 23:05:21 -0000 >@@ -64,35 +64,15 @@ > <body> > > <p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. >-A stage file is a tarball (compressed archive) that contains a minimal >-environment. >+Gentoo Linux can be installed using a <e>stage3</e> tarball file. >+Such a tarball is an archive that contains a minimal environment from >+which you can succesfully install Gentoo Linux onto your system. > </p> > >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the compiler >- or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- > <p> >-We will opt for a stage3 installation throughout this document. If you want to >-perform a Gentoo installation using the stage1 or stage2 files, please use the >-installation instructions in the <uri >-link="/doc/en/handbook/handbook-alpha.xml">Gentoo Handbook</uri>. They do >-require a working Internet connection though. >+Installations using a stage1 or stage2 tarball file are not documented in the >+Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo >+FAQ</uri> on these matters. > </p> > > </body> >Index: handbook/2005.1/hb-install-amd64-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml,v >retrieving revision 1.2 >diff -u -t -r1.2 hb-install-amd64-medium.xml >--- handbook/2005.1/hb-install-amd64-medium.xml 8 Aug 2005 13:24:46 -0000 1.2 >+++ handbook/2005.1/hb-install-amd64-medium.xml 5 Nov 2005 23:05:22 -0000 >@@ -64,35 +64,15 @@ > <body> > > <p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A >-stage file is a tarball (compressed archive) that contains a minimal >-environment. >+Gentoo Linux can be installed using a <e>stage3</e> tarball file. >+Such a tarball is an archive that contains a minimal environment from >+which you can succesfully install Gentoo Linux onto your system. > </p> > >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the >- compiler or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- > <p> >-We will opt for a stage3 installation throughout this document. If you want to >-perform a Gentoo installation using the stage1 or stage2 files, please use the >-installation instructions in the <uri >-link="/doc/en/handbook/handbook-amd64.xml">Gentoo Handbook</uri>. They do >-require a working Internet connection though. >+Installations using a stage1 or stage2 tarball file are not documented in the >+Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo >+FAQ</uri> on these matters. > </p> > > </body> >Index: handbook/2005.1/hb-install-hppa-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml,v >retrieving revision 1.2 >diff -u -t -r1.2 hb-install-hppa-medium.xml >--- handbook/2005.1/hb-install-hppa-medium.xml 8 Aug 2005 13:24:46 -0000 1.2 >+++ handbook/2005.1/hb-install-hppa-medium.xml 5 Nov 2005 23:05:22 -0000 >@@ -62,35 +62,15 @@ > <body> > > <p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A >-stage file is a tarball (compressed archive) that contains a minimal >-environment. >+Gentoo Linux can be installed using a <e>stage3</e> tarball file. >+Such a tarball is an archive that contains a minimal environment from >+which you can succesfully install Gentoo Linux onto your system. > </p> > >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the >- compiler or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- > <p> >-We will opt for a stage3 installation throughout this document. If you want to >-perform a Gentoo installation using the stage1 or stage2 files, please use the >-installation instructions in the <uri >-link="/doc/en/handbook/handbook-hppa.xml">Gentoo Handbook</uri>. They do >-require a working Internet connection though. >+Installations using a stage1 or stage2 tarball file are not documented in the >+Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo >+FAQ</uri> on these matters. > </p> > > </body> >Index: handbook/2005.1/hb-install-ppc-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml,v >retrieving revision 1.3 >diff -u -t -r1.3 hb-install-ppc-medium.xml >--- handbook/2005.1/hb-install-ppc-medium.xml 17 Aug 2005 06:48:04 -0000 1.3 >+++ handbook/2005.1/hb-install-ppc-medium.xml 5 Nov 2005 23:05:24 -0000 >@@ -87,35 +87,15 @@ > <body> > > <p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A >-stage file is a tarball (compressed archive) that contains a minimal >-environment. >+Gentoo Linux can be installed using a <e>stage3</e> tarball file. >+Such a tarball is an archive that contains a minimal environment from >+which you can succesfully install Gentoo Linux onto your system. > </p> > >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the >- compiler or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- > <p> >-We will opt for a stage3 installation throughout this document. If you want to >-perform a Gentoo installation using the stage1 or stage2 files, please use the >-installation instructions in the <uri >-link="/doc/en/handbook/handbook-ppc.xml">Gentoo Handbook</uri>. They do >-require a working Internet connection though. >+Installations using a stage1 or stage2 tarball file are not documented in the >+Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo >+FAQ</uri> on these matters. > </p> > > </body> >Index: handbook/2005.1/hb-install-ppc64-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc64-medium.xml,v >retrieving revision 1.3 >diff -u -t -r1.3 hb-install-ppc64-medium.xml >--- handbook/2005.1/hb-install-ppc64-medium.xml 13 Sep 2005 20:39:12 -0000 1.3 >+++ handbook/2005.1/hb-install-ppc64-medium.xml 5 Nov 2005 23:05:24 -0000 >@@ -70,41 +70,15 @@ > <body> > > <p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A >-stage file is a tarball (compressed archive) that contains a minimal >-environment. >+Gentoo Linux can be installed using a <e>stage3</e> tarball file. >+Such a tarball is an archive that contains a minimal environment from >+which you can succesfully install Gentoo Linux onto your system. > </p> > > <p> >-The Gentoo/PPC64 team provides you with additional options at this point. >-You have the choice to use a 32bit or a 64bit userland; a full set of stages >-is provided for both options. >-</p> >- >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the >- compiler or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- >-<p> >-We will opt for a stage3 installation throughout this document. If you want to >-perform a Gentoo installation using the stage1 or stage2 files, please use the >-installation instructions in the <uri >-link="/doc/en/handbook/handbook-ppc64.xml">Gentoo Handbook</uri>. They do >-require a working Internet connection though. >+Installations using a stage1 or stage2 tarball file are not documented in the >+Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo >+FAQ</uri> on these matters. > </p> > > </body> >Index: handbook/2005.1/hb-install-sparc-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml,v >retrieving revision 1.3 >diff -u -t -r1.3 hb-install-sparc-medium.xml >--- handbook/2005.1/hb-install-sparc-medium.xml 5 Sep 2005 15:22:02 -0000 1.3 >+++ handbook/2005.1/hb-install-sparc-medium.xml 5 Nov 2005 23:05:25 -0000 >@@ -77,35 +77,15 @@ > <body> > > <p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A >-stage file is a tarball (compressed archive) that contains a minimal >-environment. >+Gentoo Linux can be installed using a <e>stage3</e> tarball file. >+Such a tarball is an archive that contains a minimal environment from >+which you can succesfully install Gentoo Linux onto your system. > </p> > >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the >- compiler or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- > <p> >-We will opt for a stage3 installation throughout this document. If you want to >-perform a Gentoo installation using the stage1 or stage2 files, please use the >-installation instructions in the <uri >-link="/doc/en/handbook/handbook-sparc.xml">Gentoo Handbook</uri>. They do >-require a working Internet connection though. >+Installations using a stage1 or stage2 tarball file are not documented in the >+Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo >+FAQ</uri> on these matters. > </p> > > </body> >Index: handbook/2005.1/hb-install-stage.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml,v >retrieving revision 1.7 >diff -u -t -r1.7 hb-install-stage.xml >--- handbook/2005.1/hb-install-stage.xml 16 Aug 2005 21:56:01 -0000 1.7 >+++ handbook/2005.1/hb-install-stage.xml 5 Nov 2005 23:05:27 -0000 >@@ -180,6 +180,11 @@ > </pre> > > <p> >+Make sure you download a stage3 tarball - installations using a stage1 or stage2 >+tarball are not supported anymore. >+</p> >+ >+<p> > If you want to check the integrity of the downloaded stage tarball, use > <c>md5sum</c> and compare the output with the MD5 checksum provided on the > mirror. For instance, to check the validity of the x86 stage tarball: >@@ -346,16 +351,11 @@ > <title>CHOST</title> > <body> > >-<warn> >-Although it might be tempting for non-stage1 users, they should <e>not</e> >-change the <c>CHOST</c> setting in <path>make.conf</path>. Doing so might render >-their system unusable. Again: only change this variable if you use a >-<e>stage1</e> installation. >-</warn> >- > <p> >-The networkless installation approach only supports stage3 installations. Do not >-touch the <e>CHOST</e> variable! >+The <c>CHOST</c> variable declares the target build host for your system. This >+variable should already be set to the correct value. <brite>Do not edit >+it</brite> as that might break your system. If the <c>CHOST</c> variable does >+not look correct to you, you might be using the wrong stage3 tarball. > </p> > > </body> >Index: handbook/2005.1/hb-install-x86-medium.xml >=================================================================== >RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml,v >retrieving revision 1.3 >diff -u -t -r1.3 hb-install-x86-medium.xml >--- handbook/2005.1/hb-install-x86-medium.xml 25 Aug 2005 19:53:25 -0000 1.3 >+++ handbook/2005.1/hb-install-x86-medium.xml 5 Nov 2005 23:05:27 -0000 >@@ -60,35 +60,15 @@ > <body> > > <p> >-Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A >-stage file is a tarball (compressed archive) that contains a minimal >-environment. >+Gentoo Linux can be installed using a <e>stage3</e> tarball file. >+Such a tarball is an archive that contains a minimal environment from >+which you can succesfully install Gentoo Linux onto your system. > </p> > >-<ul> >- <li> >- A stage1 file contains nothing more than a compiler, Portage (Gentoo's >- software management system) and a couple of packages on which the >- compiler or Portage depends. >- </li> >- <li> >- A stage2 file contains a so-called bootstrapped system, a minimal >- environment from which one can start building all other necessary >- applications that make a Gentoo environment complete. >- </li> >- <li> >- A stage3 file contains a prebuilt minimal system which is almost fully >- deployable. It only lacks a few applications where you, the Gentoo user, >- needs to choose which one you want to install. >- </li> >-</ul> >- > <p> >-We will opt for a stage3 installation throughout this document. If you want to >-perform a Gentoo installation using the stage1 or stage2 files, please use the >-installation instructions in the <uri >-link="/doc/en/handbook/handbook-x86.xml">Gentoo Handbook</uri>. They do >-require a working Internet connection though. >+Installations using a stage1 or stage2 tarball file are not documented in the >+Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo >+FAQ</uri> on these matters. > </p> > > </body>
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Diff
View Attachment As Raw
Actions:
View
|
Diff
Attachments on
bug 105809
: 72245