Gentoo Linux Alpha Handbook

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- 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. -
- 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. -
- 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. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-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. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

- - - - - - - - - - Allows you to have total control over the installation routine, bootstrap - sequence, etc. - - - - - Suitable for powerusers and developers who know what they are doing - - - - - Takes a long time to finish the installation (it is the lengthiest approach) - - - - - - If you don't intend to tweak the settings, it is a waste of time - - - - - - Requires a working Internet connection during the installation - - -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

-When you perform a stage2 installation approach, you will build all system -packages (core packages, including toolchain) using your specific USE, -CFLAGS and CXXFLAGS settings. Any package build will therefore be -optimized to your preference. -

- -

-However, this installation takes some time and if you do not intend to change -the CFLAGS and CXXFLAGS settings that we have defined as a "good -default", using this approach only makes sense if your USE variable is -sufficiently different from the default USE we provide. -

- - - - - - - - - You don't need to bootstrap - - - - Faster than starting with stage1 - - - - You can still tweak your settings - - - - It's still not the fastest way to install Gentoo - - - - - Requires a working Internet connection during the installation - - -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

-A stage3 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. -

- -

-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. 1.39 +24 -215 xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml?rev=1.39&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml?rev=1.39&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml.diff?r1=1.38&r2=1.39&cvsroot=gentoo Index: 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 retrieving revision 1.39 diff -u -r1.38 -r1.39 --- hb-install-amd64-medium.xml 31 Oct 2005 13:31:33 -0000 1.38 +++ hb-install-amd64-medium.xml 11 Nov 2005 17:27:15 -0000 1.39 @@ -4,12 +4,12 @@ - + -2.9 -2005-10-31 +2.10 +2005-11-11

Hardware Requirements @@ -58,206 +58,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- 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. -
- 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. -
- 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. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - 1.35 +24 -215 xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?rev=1.35&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?rev=1.35&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml.diff?r1=1.34&r2=1.35&cvsroot=gentoo Index: 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 retrieving revision 1.35 diff -u -r1.34 -r1.35 --- hb-install-hppa-medium.xml 25 Oct 2005 17:27:35 -0000 1.34 +++ hb-install-hppa-medium.xml 11 Nov 2005 17:27:15 -0000 1.35 @@ -4,12 +4,12 @@ - + -1.27 -2005-10-09 +1.28 +2005-11-11

Hardware Requirements @@ -56,206 +56,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- 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. -
- 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. -
- 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. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

- -

- - - - - - - - Allows you to have total control over the installation routine, bootstrap - sequence, etc. - - - - - Suitable for powerusers and developers who know what they are doing - - - - - Takes a long time to finish the installation (it is the lengthiest approach) - - - - - - If you don't intend to tweak the settings, it is a waste of time - - - - - - Requires a working Internet connection during the installation - - -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - 1.16 +21 -204 xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml?rev=1.16&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml?rev=1.16&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml.diff?r1=1.15&r2=1.16&cvsroot=gentoo Index: 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 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- hb-install-mips-medium.xml 9 Oct 2005 16:33:54 -0000 1.15 +++ hb-install-mips-medium.xml 11 Nov 2005 17:27:15 -0000 1.16 @@ -4,12 +4,12 @@ - + -1.10 -2005-10-09 +1.11 +2005-11-11

Hardware Requirements @@ -51,208 +51,9 @@

- - -

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- 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. -
- 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. -
- 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. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

- -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

-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 1.49 +24 -215 xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml?rev=1.49&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml?rev=1.49&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml.diff?r1=1.48&r2=1.49&cvsroot=gentoo Index: 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 retrieving revision 1.49 diff -u -r1.48 -r1.49 --- hb-install-ppc-medium.xml 9 Oct 2005 16:33:54 -0000 1.48 +++ hb-install-ppc-medium.xml 11 Nov 2005 17:27:15 -0000 1.49 @@ -4,12 +4,12 @@ - + -2.6 -2005-10-09 +2.7 +2005-11-11

Hardware Requirements @@ -81,206 +81,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- 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. -
- 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. -
- 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. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - 1.25 +21 -211 xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?rev=1.25&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?rev=1.25&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml.diff?r1=1.24&r2=1.25&cvsroot=gentoo Index: 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 retrieving revision 1.25 diff -u -r1.24 -r1.25 --- hb-install-ppc64-medium.xml 9 Oct 2005 16:33:54 -0000 1.24 +++ hb-install-ppc64-medium.xml 11 Nov 2005 17:27:15 -0000 1.25 @@ -4,12 +4,12 @@ - + -2.7 -2005-10-09 +2.8 +2005-11-11

Hardware Requirements @@ -64,206 +64,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- 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. -
- 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. -
- 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. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

- -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - 1.36 +24 -215 xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?rev=1.36&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml?rev=1.36&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml.diff?r1=1.35&r2=1.36&cvsroot=gentoo Index: 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 retrieving revision 1.36 diff -u -r1.35 -r1.36 --- hb-install-sparc-medium.xml 9 Oct 2005 16:33:54 -0000 1.35 +++ hb-install-sparc-medium.xml 11 Nov 2005 17:27:15 -0000 1.36 @@ -4,12 +4,12 @@ - + -2.5 -2005-10-09 +2.6 +2005-11-11

Hardware Requirements @@ -63,206 +63,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- 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. -
- 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. -
- 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. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

- -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - 1.90 +17 -106 xml/htdocs/doc/en/handbook/hb-install-stage.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.90&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml?rev=1.90&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-stage.xml.diff?r1=1.89&r2=1.90&cvsroot=gentoo Index: hb-install-stage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v retrieving revision 1.89 retrieving revision 1.90 diff -u -r1.89 -r1.90 --- hb-install-stage.xml 13 Aug 2005 21:21:30 -0000 1.89 +++ hb-install-stage.xml 11 Nov 2005 17:27:15 -0000 1.90 @@ -4,12 +4,12 @@ - + -2.5 -2005-08-13 +2.6 +2005-11-11

Installing a Stage Tarball @@ -49,8 +49,8 @@

-The next step you need to perform is to install the stage 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 stage3 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 @@

+Make sure you download a stage3 tarball - installations using a stage1 or stage2 +tarball are not supported anymore. +

+ +

If you want to check the integrity of the downloaded stage tarball, use md5sum and compare the output with the MD5 checksum provided on the mirror. For instance, to check the validity of the x86 stage tarball:

-# md5sum -c stage1-x86-2005.1.tar.bz2.md5
-stage1-x86-2005.1.tar.bz2: OK
+# md5sum -c stage3-x86-2005.1.tar.bz2.md5
+stage3-x86-2005.1.tar.bz2: OK

@@ -146,7 +151,7 @@

-# tar -xvjpf stage?-*.tar.bz2
+# tar -xvjpf stage3-*.tar.bz2

@@ -340,105 +345,11 @@ CHOST - -Although it might be tempting for non-stage1 users, they should not -change the CHOST setting in make.conf. Doing so might render -their system unusable. Again: only change this variable if you use a -stage1 installation. - - -

-The CHOST variable defines what architecture gcc has to -compile programs for. The possibilities are: -

- -

- - - - - - - x86 - i386 - i386-pc-linux-gnu - - - x86 - i486 - i486-pc-linux-gnu - - - x86 - i586 - i586-pc-linux-gnu - - - x86 - i686 and above (incl. athlon) - i686-pc-linux-gnu - - - alpha - - alpha-unknown-linux-gnu - - - ppc - - powerpc-unknown-linux-gnu - - - ppc64 - - powerpc64-unknown-linux-gnu - - - sparc - - sparc-unknown-linux-gnu - - - sparc64 - - sparc-unknown-linux-gnu - - - hppa - (generic) - hppa-unknown-linux-gnu - - - hppa - pa7000 - hppa1.1-unknown-linux-gnu - - - hppa - pa8000 and above - hppa2.0-unknown-linux-gnu - - - mips - - mips-unknown-linux-gnu - - - amd64 - - x86_64-pc-linux-gnu - -

Architecture	Subarchitecture	CHOST Setting

- -

-Please, make sure that you use the correct CHOST setting. For instance, -the CHOST setting for sparc64 still is sparc-unknown-linux-gnu and -not sparc64-unknown-linux-gnu! -

-Users interested in bootstrapping their entire system with NPTL support on an -x86 system need to set their CHOST to i586-pc-linux-gnu or higher. +The CHOST variable declares the target build host for your system. This +variable should already be set to the correct value. Do not edit +it as that might break your system. If the CHOST variable does +not look correct to you, you might be using the wrong stage3 tarball.

1.85 +9 -203 xml/htdocs/doc/en/handbook/hb-install-system.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.85&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.85&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml.diff?r1=1.84&r2=1.85&cvsroot=gentoo Index: hb-install-system.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v retrieving revision 1.84 retrieving revision 1.85 diff -u -r1.84 -r1.85 --- hb-install-system.xml 16 Aug 2005 22:14:44 -0000 1.84 +++ hb-install-system.xml 11 Nov 2005 17:27:15 -0000 1.85 @@ -4,12 +4,12 @@ - + -2.11 -2005-08-17 +2.12 +2005-11-11

Chrooting @@ -124,6 +124,10 @@ +

+ +

+Configuring Portage Updating the Portage tree @@ -341,8 +345,7 @@ after compiling glibc a full set of all available locales will be created. As of now you can activate the userlocales USE flag and specify only the locales you will need in /etc/locales.build. 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.

@@ -370,208 +373,11 @@
 de_DE@euro/ISO-8859-15

- - -

-Differences between Stage1, Stage2 and Stage3 - - -

-Now take a seat and think of your previous steps. We asked you to -select a stage1, stage2 or stage3 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. -

- -

- If you chose stage1, then you have to follow both steps in - this chapter (starting with Progressing from Stage1 - to Stage2) -
- If you chose stage2 you only can skip the first step - and immediately start with the second one (Progressing - from Stage2 to Stage3) -
- If you chose stage3 then you can skip both - steps and continue with Configuring the - Kernel -

- - -

-Progressing from Stage1 to Stage2 - -Introduction to Bootstrapping - - -

-So, you want to compile everything from scratch? Okay then :-) -

- -

-In this step, we will bootstrap 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. -

- -

-Bootstrapping means building the GNU C Library, GNU Compiler -Collection and several other key system programs. -

- -

-Before starting the bootstrap, you might want to download all necessary -sourcecode first. If you do not want to do this, continue -with Bootstrapping the System. -

- - - - -Optional: Downloading the Sources First - - -

-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 -f option of the bootstrap script, which will -fetch (hence the letter f) all source code for you. -

- -

-# cd /usr/portage
-# scripts/bootstrap.sh -f
-

- - - - -Bootstrapping the System - - -

-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. -

- -

-# cd /usr/portage
-# scripts/bootstrap.sh
-

- -

-Now continue with the next step, Progressing from Stage2 -to Stage3. -

- - - -

-Progressing from Stage2 to Stage3 - -Introduction - - -

-If you are reading this section, then you have a bootstrapped system -(either because you bootstrapped it previously, or you are using a -stage2). Then it is now time to build all system packages. -

- -

-All 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. -

- - - - -Optional: Viewing what will be done - - -

-If you want to know what packages will be installed, execute emerge ---pretend --emptytree system. This will list all packages that will be -built. As this list is pretty big, you should also use a pager like -less or more to go up and down the list. -

- -

-# emerge --pretend --emptytree system | less
-

- -

-Note that, if you haven't touched the default CFLAGS/CXXFLAGS setting, using -emerge --pretend --newuse system 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? -

- 1.41 +24 -214 xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml?rev=1.41&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml?rev=1.41&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml.diff?r1=1.40&r2=1.41&cvsroot=gentoo Index: 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 retrieving revision 1.41 diff -u -r1.40 -r1.41 --- hb-install-x86-medium.xml 9 Oct 2005 16:33:54 -0000 1.40 +++ hb-install-x86-medium.xml 11 Nov 2005 17:27:15 -0000 1.41 @@ -4,12 +4,12 @@ - + -2.5 -2005-10-09 +2.6 +2005-11-11

Hardware Requirements @@ -53,205 +53,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- 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. -
- 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. -
- 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. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - 1.55 +7 -14 xml/htdocs/doc/en/handbook/index.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml?rev=1.55&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml?rev=1.55&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/index.xml.diff?r1=1.54&r2=1.55&cvsroot=gentoo Index: index.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v retrieving revision 1.54 retrieving revision 1.55 diff -u -r1.54 -r1.55 --- index.xml 8 Aug 2005 13:48:40 -0000 1.54 +++ index.xml 11 Nov 2005 17:27:15 -0000 1.55 @@ -1,7 +1,7 @@ - + Gentoo Handbook @@ -19,8 +19,8 @@ -0.29 -2005-08-08 +0.30 +2005-11-11 The Gentoo Handbook Effort @@ -290,9 +290,7 @@

By not separating the instructions for each possible option, the user can view the results of the other choices easily. This provides a better view on the -installation instructions 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 for the user.

@@ -302,14 +300,9 @@

-You are reading the wrong Gentoo Handbook. -

- -

-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 Gentoo FAQ. A stage3 installation is the +only supported installation as of now.

-- gentoo-doc-cvs@gentoo.org mailing list