Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
View | Details | Raw Unified | Return to bug 105809
Collapse All | Expand All

(-)faq.xml (-2 / +49 lines)
Lines 120-125 Link Here
120
    <uri link="#dualboot">I want to boot Windows from GRUB or LILO but it shows
120
    <uri link="#dualboot">I want to boot Windows from GRUB or LILO but it shows
121
    only black screen. What should I do?</uri>
121
    only black screen. What should I do?</uri>
122
  </li>
122
  </li>
123
  <li>
124
    <uri link="#stage12">How do I Install Gentoo Using a Stage1 or Stage2
125
    Tarball?</uri>
126
  </li>
123
</ul>
127
</ul>
124
128
125
</body>
129
</body>
Lines 533-540 Link Here
533
</p>
537
</p>
534
538
535
<p>
539
<p>
536
If you are building from a Stage 1, please note that many more options exist
540
Please note that many more options exist than those for which Gentoo builds 
537
than those for which Gentoo builds binary stages. Please see the <uri
541
binary stages. Please see the <uri
538
link="http://gcc.gnu.org/onlinedocs/gcc-3.4.4/gcc/i386-and-x86_002d64-Options.html#i386-and-x86_002d64-Options">gcc
542
link="http://gcc.gnu.org/onlinedocs/gcc-3.4.4/gcc/i386-and-x86_002d64-Options.html#i386-and-x86_002d64-Options">gcc
539
guide</uri> for setting <c>-march</c>.
543
guide</uri> for setting <c>-march</c>.
540
</p>
544
</p>
Lines 618-623 Link Here
618
622
619
</body>
623
</body>
620
</section>
624
</section>
625
<section id="stage12">
626
<title>How do I Install Gentoo Using a Stage1 or Stage2 Tarball?</title>
627
<body>
628
629
<p>
630
The Gentoo Handbook only describes a Gentoo installation using a stage3 tarball.
631
However, Gentoo still provides stage1 and stage2 tarballs. This is for
632
development purposes (the Release Engineering team starts from a stage1 tarball
633
to obtain a stage3) but shouldn't be used by users: a stage3 tarball can very
634
well be used to bootstrap the system. You do need a working Internet connection.
635
</p>
636
637
<p>
638
Bootstrapping means building the toolchain (the C library and compiler) for 
639
your system after which you install all core system packages. To bootstrap the
640
system, perform a stage3 installation. Before you start the chapter on 
641
<e>Configuring the Kernel</e>, modify the <path>bootstrap.sh</path> script to
642
suit your needs and then run it:
643
</p>
644
645
<pre caption="Bootstrapping the system">
646
# <i>cd /usr/portage/scripts</i>
647
# <i>vi bootstrap.sh</i>
648
649
# <i>./bootstrap.sh</i>
650
</pre>
651
652
<p>
653
Next, rebuild all core system packages with the newly built toolchain. We need
654
to rebuild them since the stage3 tarball already offers them:
655
</p>
656
657
<pre caption="Rebuilding the core system packages">
658
# <i>emerge -e system</i>
659
</pre>
660
661
<p>
662
Now you can continue with <e>Configuring the Kernel</e>. You can not use the
663
prebuilt GRP packages anymore though.
664
</p>
665
666
</body>
667
</section>
621
</chapter>
668
</chapter>
622
669
623
<chapter>
670
<chapter>
(-)handbook/handbook-alpha.xml (-2 / +2 lines)
Lines 170-177 Link Here
170
<chapter>
170
<chapter>
171
<title>Installing the Gentoo Installation Files</title>
171
<title>Installing the Gentoo Installation Files</title>
172
<abstract>
172
<abstract>
173
Gentoo installs work through so-called stage-files. In this chapter we
173
Gentoo installs work through a stage3 archive. In this chapter we
174
describe how you extract a stage-file and configure Portage.
174
describe how you extract the stage3 archive and configure Portage.
175
</abstract>
175
</abstract>
176
  <include href="hb-install-stage.xml"/>
176
  <include href="hb-install-stage.xml"/>
177
</chapter>
177
</chapter>
(-)handbook/handbook-amd64.xml (-2 / +2 lines)
Lines 170-177 Link Here
170
<chapter>
170
<chapter>
171
<title>Installing the Gentoo Installation Files</title>
171
<title>Installing the Gentoo Installation Files</title>
172
<abstract>
172
<abstract>
173
Gentoo installs work through so-called stage-files. In this chapter we
173
Gentoo installs work through a stage3 archive. In this chapter we
174
describe how you extract a stage-file and configure Portage.
174
describe how you extract the stage3 archive and configure Portage.
175
</abstract>
175
</abstract>
176
  <include href="hb-install-stage.xml"/>
176
  <include href="hb-install-stage.xml"/>
177
</chapter>
177
</chapter>
(-)handbook/handbook-hppa.xml (-2 / +2 lines)
Lines 170-177 Link Here
170
<chapter>
170
<chapter>
171
<title>Installing the Gentoo Installation Files</title>
171
<title>Installing the Gentoo Installation Files</title>
172
<abstract>
172
<abstract>
173
Gentoo installs work through so-called stage-files. In this chapter we
173
Gentoo installs work through a stage3 archive. In this chapter we
174
describe how you extract a stage-file and configure Portage.
174
describe how you extract the stage3 archive and configure Portage.
175
</abstract>
175
</abstract>
176
  <include href="hb-install-stage.xml"/>
176
  <include href="hb-install-stage.xml"/>
177
</chapter>
177
</chapter>
(-)handbook/handbook-mips.xml (-2 / +2 lines)
Lines 172-179 Link Here
172
<chapter>
172
<chapter>
173
<title>Installing the Gentoo Installation Files</title>
173
<title>Installing the Gentoo Installation Files</title>
174
<abstract>
174
<abstract>
175
Gentoo installs work through so-called stage-files. In this chapter we
175
Gentoo installs work through a stage3 archive. In this chapter we
176
describe how you extract a stage-file and configure Portage.
176
describe how you extract the stage3 archive and configure Portage.
177
</abstract>
177
</abstract>
178
  <include href="hb-install-stage.xml"/>
178
  <include href="hb-install-stage.xml"/>
179
</chapter>
179
</chapter>
(-)handbook/handbook-ppc.xml (-2 / +2 lines)
Lines 173-180 Link Here
173
<chapter>
173
<chapter>
174
<title>Installing the Gentoo Installation Files</title>
174
<title>Installing the Gentoo Installation Files</title>
175
<abstract>
175
<abstract>
176
Gentoo installs work through so-called stage-files. In this chapter we describe
176
Gentoo installs work through a stage3 archive. In this chapter we describe
177
how you extract a stage-file and configure Portage.
177
how you extract a stage3 archive and configure Portage.
178
</abstract>
178
</abstract>
179
  <include href="hb-install-stage.xml"/>
179
  <include href="hb-install-stage.xml"/>
180
</chapter>
180
</chapter>
(-)handbook/handbook-ppc64.xml (-2 / +2 lines)
Lines 170-177 Link Here
170
<chapter>
170
<chapter>
171
<title>Installing the Gentoo Installation Files</title>
171
<title>Installing the Gentoo Installation Files</title>
172
<abstract>
172
<abstract>
173
Gentoo installs work through so-called stage-files. In this chapter we describe
173
Gentoo installs work through a stage3 archive. In this chapter we describe
174
how you extract a stage-file and configure Portage.
174
how you extract a stage3 archive and configure Portage.
175
</abstract>
175
</abstract>
176
  <include href="hb-install-stage.xml"/>
176
  <include href="hb-install-stage.xml"/>
177
</chapter>
177
</chapter>
(-)handbook/handbook-sparc.xml (-2 / +2 lines)
Lines 170-177 Link Here
170
<chapter>
170
<chapter>
171
<title>Installing the Gentoo Installation Files</title>
171
<title>Installing the Gentoo Installation Files</title>
172
<abstract>
172
<abstract>
173
Gentoo installs work through so-called stage-files. In this chapter we
173
Gentoo installs work through a stage3 archive. In this chapter we
174
describe how you extract a stage-file and configure Portage.
174
describe how you extract the stage3 archive and configure Portage.
175
</abstract>
175
</abstract>
176
  <include href="hb-install-stage.xml"/>
176
  <include href="hb-install-stage.xml"/>
177
</chapter>
177
</chapter>
(-)handbook/handbook-x86.xml (-2 / +2 lines)
Lines 170-177 Link Here
170
<chapter>
170
<chapter>
171
<title>Installing the Gentoo Installation Files</title>
171
<title>Installing the Gentoo Installation Files</title>
172
<abstract>
172
<abstract>
173
Gentoo installs work through so-called stage-files. In this chapter we
173
Gentoo installs work through a stage3 archive. In this chapter we
174
describe how you extract a stage-file and configure Portage.
174
describe how you extract the stage3 archive and configure Portage.
175
</abstract>
175
</abstract>
176
  <include href="hb-install-stage.xml"/>
176
  <include href="hb-install-stage.xml"/>
177
</chapter>
177
</chapter>
(-)handbook/hb-install-alpha-medium.xml (-212 / +23 lines)
Lines 53-260 Link Here
53
</body>
53
</body>
54
</subsection>
54
</subsection>
55
</section>
55
</section>
56
<!-- Copy/paste from the hb-install-x86-medium.xml file.  -->
57
<!-- START -->
58
<section>
59
<title>The Gentoo Installation Approaches</title>
60
<subsection>
61
<title>Introduction</title>
62
<body>
63
64
<p>
65
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
66
A stage file is a tarball (compressed archive) that contains a minimal
67
environment.
68
</p>
69
70
<ul>
71
  <li>
72
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
73
     software management system) and a couple of packages on which the compiler
74
     or Portage depends.
75
   </li>
76
   <li>
77
     A stage2 file contains a so-called bootstrapped system, a minimal
78
     environment from which one can start building all other necessary
79
     applications that make a Gentoo environment complete.
80
   </li>
81
   <li>
82
     A stage3 file contains a prebuilt minimal system which is almost fully
83
     deployable. It only lacks a few applications where you, the Gentoo user,
84
     needs to choose which one you want to install.
85
   </li>
86
</ul>
87
88
<p>
89
To help you decide what stage file you want to use, we have written down the
90
major advantages and disadvantages of each stage file.
91
</p>
92
93
</body>
94
</subsection>
95
<subsection>
96
<title>A Stage1 Approach</title>
97
<body>
98
99
<p>
100
A <e>stage1</e> is used when you want to bootstrap and build the entire system 
101
from scratch.
102
</p>
103
104
<p>
105
This approach builds core system packages that are vital to your system and is
106
used by Gentoo developers to prepare the Gentoo release media. It is a great
107
installation method for those who would like to learn more about the inner
108
workings of bootstrapping, toolchains and the like.
109
</p>
110
111
<p>
112
However, if you do not plan to tweak the bootstrapping instructions in the
113
<path>bootstrap.sh</path> script written by the Gentoo developers, then a 
114
stage1 approach has no benefits for you. 
115
</p>
116
117
<table>
118
<tr>
119
  <th>Stage1</th>
120
  <th>Pros and Cons</th>
121
</tr>
122
<tr>
123
  <th>+</th>
124
  <ti>
125
    Allows you to have total control over the installation routine, bootstrap
126
    sequence, etc.
127
  </ti>
128
</tr>
129
<tr>
130
  <th>+</th>
131
  <ti>Suitable for powerusers and developers who know what they are doing</ti>
132
</tr>
133
<tr>
134
  <th>-</th>
135
  <ti>
136
    Takes a long time to finish the installation (it is the lengthiest approach)
137
  </ti>
138
</tr>
139
<tr>
140
  <th>-</th>
141
  <ti>
142
    If you don't intend to tweak the settings, it is a waste of time
143
  </ti>
144
</tr>
145
<tr>
146
  <th>-</th>
147
  <ti>
148
    Requires a working Internet connection during the installation
149
  </ti>
150
</tr>
151
</table>
152
153
</body>
154
</subsection>
155
<subsection>
156
<title>A Stage2 Approach</title>
157
<body>
158
159
<p>
160
A <e>stage2</e> is used for building the entire system from a bootstrapped
161
"semi-compiled" state.
162
</p>
163
164
<p>
165
When you perform a stage2 installation approach, you will build all system
166
packages (core packages, including toolchain) using your specific <c>USE</c>, 
167
<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
168
optimized to your preference.
169
</p>
170
171
<p>
172
However, this installation takes some time and if you do not intend to change
173
the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
174
default", using this approach only makes sense if your <c>USE</c> variable is
175
sufficiently different from the default <c>USE</c> we provide.
176
</p>
177
178
<table>
179
<tr>
180
  <th>Stage2</th>
181
  <th>Pros and Cons</th>
182
</tr>
183
<tr>
184
  <th>+</th>
185
  <ti>You don't need to bootstrap</ti>
186
</tr>
187
<tr>
188
  <th>+</th>
189
  <ti>Faster than starting with stage1</ti>
190
</tr>
191
<tr>
192
  <th>+</th>
193
  <ti>You can still tweak your settings</ti>
194
</tr>
195
<tr>
196
  <th>-</th>
197
  <ti>It's still not the fastest way to install Gentoo</ti>
198
</tr>
199
<tr>
200
  <th>-</th>
201
  <ti>
202
    Requires a working Internet connection during the installation
203
  </ti>
204
</tr>
205
</table>
206
207
</body>
208
</subsection>
209
<subsection>
210
<title>A Stage3 Approach</title>
211
<body>
212
213
<p>
214
A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
215
built for you. You will only need to build a few packages (such as system
216
logger, networking tools, ...) before you can boot into a base Gentoo
217
installation.
218
</p>
219
220
<p>
221
Choosing to go with a stage3 allows for the fastest install of Gentoo
222
Linux, but also means that your base system will have the optimization
223
settings that we chose for you (which to be honest, are good settings
224
and were carefully chosen to enhance performance while maintaining
225
stability). Stage3 is also required if you want to install Gentoo using
226
prebuilt packages or without a network connection.
227
</p>
228
229
<table>
230
<tr>
231
  <th>Stage3</th>
232
  <th>Pros and Cons</th>
233
</tr>
234
<tr>
235
  <th>+</th>
236
  <ti>Fastest way to get a Gentoo base system</ti>
237
</tr>
238
<tr>
239
  <th>+</th>
240
  <ti>
241
    You can still tweak your system
242
  </ti>
243
</tr>
244
</table>
245
246
<p>
247
You might be interested to know that, if you decide to use different 
248
optimization settings after having installed Gentoo, you will be able to 
249
recompile your entire system with the new optimization settings. The same goes
250
for any <c>USE</c> flag changes: Portage is intelligent enough to know what
251
packages need to be rebuild.
252
</p>
253
254
</body>
255
</subsection>
256
</section>
257
56
57
<!-- Copy/paste from hb-install-x86-medium.xml -->
58
<!-- START -->
258
<section>
59
<section>
259
<title>The Gentoo Installation CDs</title>
60
<title>The Gentoo Installation CDs</title>
260
<subsection>
61
<subsection>
Lines 294-301 Link Here
294
  </li>
95
  </li>
295
  <li>
96
  <li>
296
    The Gentoo Universal Installation CD, a bootable CD with the same abilities
97
    The Gentoo Universal Installation CD, a bootable CD with the same abilities
297
    as the Minimal Installation CD. Additionally, it contains a stage1 and
98
    as the Minimal Installation CD. Additionally, it contains several stage3 
298
    several stage3 tarballs (optimized for the individual subarchitectures).
99
    tarballs (optimized for the individual subarchitectures).
299
  </li>
100
  </li>
300
</ul>
101
</ul>
301
102
Lines 326-341 Link Here
326
  <ti>Smallest download</ti>
127
  <ti>Smallest download</ti>
327
</tr>
128
</tr>
328
<tr>
129
<tr>
329
  <th>+</th>
330
  <ti>
331
    You can do a stage1, stage2 or stage3 by getting the stage tarball off the
332
    net
333
  </ti>
334
</tr>
335
<tr>
336
  <th>-</th>
130
  <th>-</th>
337
  <ti>
131
  <ti>
338
    Contains no stages, no Portage snapshot, no prebuilt packages and is
132
    Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
339
    therefore not suitable for networkless installation
133
    therefore not suitable for networkless installation
340
  </ti>
134
  </ti>
341
</tr>
135
</tr>
Lines 392-398 Link Here
392
186
393
<p>
187
<p>
394
If you intend to use the Packages CD to quickly install additional software,
188
If you intend to use the Packages CD to quickly install additional software,
395
make sure that you use the same subarchitecture as the stage-3 tarball you use.
189
make sure that you use the same subarchitecture as the stage3 tarball you use.
190
</p>
191
192
</body>
193
</subsection>
194
<subsection>
195
<title>The Stage3 Tarball</title>
196
<body>
197
198
<p>
199
A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
200
to continue the Gentoo installation using the instructions in this manual.
201
Previously, the Gentoo Handbook described the installation using one of three 
202
stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 
203
official installation method uses the stage3 tarball. If you are interested in
204
performing a Gentoo installation using a stage1 or stage2 tarball, please read
205
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
206
Using a Stage1 or Stage2 Tarball?</uri>
396
</p>
207
</p>
397
208
398
</body>
209
</body>
(-)handbook/hb-install-amd64-medium.xml (-212 / +21 lines)
Lines 58-263 Link Here
58
<!-- Copy/paste from hb-install-x86-medium.xml -->
58
<!-- Copy/paste from hb-install-x86-medium.xml -->
59
<!-- START -->
59
<!-- START -->
60
<section>
60
<section>
61
<title>The Gentoo Installation Approaches</title>
62
<subsection>
63
<title>Introduction</title>
64
<body>
65
66
<p>
67
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
68
A stage file is a tarball (compressed archive) that contains a minimal
69
environment.
70
</p>
71
72
<ul>
73
  <li>
74
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
75
     software management system) and a couple of packages on which the compiler
76
     or Portage depends.
77
   </li>
78
   <li>
79
     A stage2 file contains a so-called bootstrapped system, a minimal
80
     environment from which one can start building all other necessary
81
     applications that make a Gentoo environment complete.
82
   </li>
83
   <li>
84
     A stage3 file contains a prebuilt minimal system which is almost fully
85
     deployable. It only lacks a few applications where you, the Gentoo user,
86
     needs to choose which one you want to install.
87
   </li>
88
</ul>
89
90
<p>
91
To help you decide what stage file you want to use, we have written down the
92
major advantages and disadvantages of each stage file.
93
</p>
94
95
</body>
96
</subsection>
97
<subsection>
98
<title>A Stage1 Approach</title>
99
<body>
100
101
<p>
102
A <e>stage1</e> is used when you want to bootstrap and build the entire system 
103
from scratch.
104
</p>
105
106
<p>
107
This approach builds core system packages that are vital to your system and is
108
used by Gentoo developers to prepare the Gentoo release media. It is a great
109
installation method for those who would like to learn more about the inner
110
workings of bootstrapping, toolchains and the like.
111
</p>
112
113
<p>
114
However, if you do not plan to tweak the bootstrapping instructions in the
115
<path>bootstrap.sh</path> script written by the Gentoo developers, then a 
116
stage1 approach has no benefits for you. 
117
</p>
118
119
<table>
120
<tr>
121
  <th>Stage1</th>
122
  <th>Pros and Cons</th>
123
</tr>
124
<tr>
125
  <th>+</th>
126
  <ti>
127
    Allows you to have total control over the installation routine, bootstrap
128
    sequence, etc.
129
  </ti>
130
</tr>
131
<tr>
132
  <th>+</th>
133
  <ti>Suitable for powerusers and developers who know what they are doing</ti>
134
</tr>
135
<tr>
136
  <th>-</th>
137
  <ti>
138
    Takes a long time to finish the installation (it is the lengthiest approach)
139
  </ti>
140
</tr>
141
<tr>
142
  <th>-</th>
143
  <ti>
144
    If you don't intend to tweak the settings, it is a waste of time
145
  </ti>
146
</tr>
147
<tr>
148
  <th>-</th>
149
  <ti>
150
    Requires a working Internet connection during the installation
151
  </ti>
152
</tr>
153
</table>
154
155
</body>
156
</subsection>
157
<subsection>
158
<title>A Stage2 Approach</title>
159
<body>
160
161
<p>
162
A <e>stage2</e> is used for building the entire system from a bootstrapped
163
"semi-compiled" state.
164
</p>
165
166
<p>
167
When you perform a stage2 installation approach, you will build all system
168
packages (core packages, including toolchain) using your specific <c>USE</c>, 
169
<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
170
optimized to your preference.
171
</p>
172
173
<p>
174
However, this installation takes some time and if you do not intend to change
175
the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
176
default", using this approach only makes sense if your <c>USE</c> variable is
177
sufficiently different from the default <c>USE</c> we provide.
178
</p>
179
180
<table>
181
<tr>
182
  <th>Stage2</th>
183
  <th>Pros and Cons</th>
184
</tr>
185
<tr>
186
  <th>+</th>
187
  <ti>You don't need to bootstrap</ti>
188
</tr>
189
<tr>
190
  <th>+</th>
191
  <ti>Faster than starting with stage1</ti>
192
</tr>
193
<tr>
194
  <th>+</th>
195
  <ti>You can still tweak your settings</ti>
196
</tr>
197
<tr>
198
  <th>-</th>
199
  <ti>It's still not the fastest way to install Gentoo</ti>
200
</tr>
201
<tr>
202
  <th>-</th>
203
  <ti>
204
    Requires a working Internet connection during the installation
205
  </ti>
206
</tr>
207
</table>
208
209
</body>
210
</subsection>
211
<subsection>
212
<title>A Stage3 Approach</title>
213
<body>
214
215
<p>
216
A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
217
built for you. You will only need to build a few packages (such as system
218
logger, networking tools, ...) before you can boot into a base Gentoo
219
installation.
220
</p>
221
222
<p>
223
Choosing to go with a stage3 allows for the fastest install of Gentoo
224
Linux, but also means that your base system will have the optimization
225
settings that we chose for you (which to be honest, are good settings
226
and were carefully chosen to enhance performance while maintaining
227
stability). Stage3 is also required if you want to install Gentoo using
228
prebuilt packages or without a network connection.
229
</p>
230
231
<table>
232
<tr>
233
  <th>Stage3</th>
234
  <th>Pros and Cons</th>
235
</tr>
236
<tr>
237
  <th>+</th>
238
  <ti>Fastest way to get a Gentoo base system</ti>
239
</tr>
240
<tr>
241
  <th>+</th>
242
  <ti>
243
    You can still tweak your system
244
  </ti>
245
</tr>
246
</table>
247
248
<p>
249
You might be interested to know that, if you decide to use different 
250
optimization settings after having installed Gentoo, you will be able to 
251
recompile your entire system with the new optimization settings. The same goes
252
for any <c>USE</c> flag changes: Portage is intelligent enough to know what
253
packages need to be rebuild.
254
</p>
255
256
</body>
257
</subsection>
258
</section>
259
260
<section>
261
<title>The Gentoo Installation CDs</title>
61
<title>The Gentoo Installation CDs</title>
262
<subsection>
62
<subsection>
263
<title>Introduction</title>
63
<title>Introduction</title>
Lines 296-304 Link Here
296
  </li>
96
  </li>
297
  <li>
97
  <li>
298
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 
98
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 
299
    abilities as the Minimal Installation CD. Additionally, it contains a 
99
    abilities as the Minimal Installation CD. Additionally, it contains 
300
    stage1 and several stage3 tarballs (optimized for the individual 
100
    several stage3 tarballs (optimized for the individual subarchitectures). 
301
    subarchitectures). 
302
  </li>
101
  </li>
303
</ul>
102
</ul>
304
103
Lines 330-345 Link Here
330
  <ti>Smallest download</ti>
129
  <ti>Smallest download</ti>
331
</tr>
130
</tr>
332
<tr>
131
<tr>
333
  <th>+</th>
334
  <ti>
335
    You can do a stage1, stage2 or stage3 by getting the stage tarball off the
336
    net
337
  </ti>
338
</tr>
339
<tr>
340
  <th>-</th>
132
  <th>-</th>
341
  <ti>
133
  <ti>
342
    Contains no stages, no Portage snapshot, no prebuilt packages and is
134
    Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
343
    therefore not suitable for networkless installation
135
    therefore not suitable for networkless installation
344
  </ti>
136
  </ti>
345
</tr>
137
</tr>
Lines 395-401 Link Here
395
187
396
<p>
188
<p>
397
If you intend to use the Packages CD to quickly install additional software,
189
If you intend to use the Packages CD to quickly install additional software,
398
make sure that you use the same subarchitecture as the stage-3 tarball you use.
190
make sure that you use the same subarchitecture as the stage3 tarball you use.
191
</p>
192
193
</body>
194
</subsection>
195
<subsection>
196
<title>The Stage3 Tarball</title>
197
<body>
198
199
<p>
200
A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
201
to continue the Gentoo installation using the instructions in this manual.
202
Previously, the Gentoo Handbook described the installation using one of three 
203
stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 
204
official installation method uses the stage3 tarball. If you are interested in
205
performing a Gentoo installation using a stage1 or stage2 tarball, please read
206
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
207
Using a Stage1 or Stage2 Tarball?</uri>
399
</p>
208
</p>
400
209
401
</body>
210
</body>
(-)handbook/hb-install-hppa-medium.xml (-212 / +21 lines)
Lines 56-261 Link Here
56
<!-- Copy/paste from hb-install-x86-medium.xml -->
56
<!-- Copy/paste from hb-install-x86-medium.xml -->
57
<!-- START -->
57
<!-- START -->
58
<section>
58
<section>
59
<title>The Gentoo Installation Approaches</title>
60
<subsection>
61
<title>Introduction</title>
62
<body>
63
64
<p>
65
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
66
A stage file is a tarball (compressed archive) that contains a minimal
67
environment.
68
</p>
69
70
<ul>
71
  <li>
72
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
73
     software management system) and a couple of packages on which the compiler
74
     or Portage depends.
75
   </li>
76
   <li>
77
     A stage2 file contains a so-called bootstrapped system, a minimal
78
     environment from which one can start building all other necessary
79
     applications that make a Gentoo environment complete.
80
   </li>
81
   <li>
82
     A stage3 file contains a prebuilt minimal system which is almost fully
83
     deployable. It only lacks a few applications where you, the Gentoo user,
84
     needs to choose which one you want to install.
85
   </li>
86
</ul>
87
88
<p>
89
To help you decide what stage file you want to use, we have written down the
90
major advantages and disadvantages of each stage file.
91
</p>
92
93
</body>
94
</subsection>
95
<subsection>
96
<title>A Stage1 Approach</title>
97
<body>
98
99
<p>
100
A <e>stage1</e> is used when you want to bootstrap and build the entire system 
101
from scratch.
102
</p>
103
104
<p>
105
This approach builds core system packages that are vital to your system and is
106
used by Gentoo developers to prepare the Gentoo release media. It is a great
107
installation method for those who would like to learn more about the inner
108
workings of bootstrapping, toolchains and the like.
109
</p>
110
111
<p>
112
However, if you do not plan to tweak the bootstrapping instructions in the
113
<path>bootstrap.sh</path> script written by the Gentoo developers, then a 
114
stage1 approach has no benefits for you. 
115
</p>
116
117
<table>
118
<tr>
119
  <th>Stage1</th>
120
  <th>Pros and Cons</th>
121
</tr>
122
<tr>
123
  <th>+</th>
124
  <ti>
125
    Allows you to have total control over the installation routine, bootstrap
126
    sequence, etc.
127
  </ti>
128
</tr>
129
<tr>
130
  <th>+</th>
131
  <ti>Suitable for powerusers and developers who know what they are doing</ti>
132
</tr>
133
<tr>
134
  <th>-</th>
135
  <ti>
136
    Takes a long time to finish the installation (it is the lengthiest approach)
137
  </ti>
138
</tr>
139
<tr>
140
  <th>-</th>
141
  <ti>
142
    If you don't intend to tweak the settings, it is a waste of time
143
  </ti>
144
</tr>
145
<tr>
146
  <th>-</th>
147
  <ti>
148
    Requires a working Internet connection during the installation
149
  </ti>
150
</tr>
151
</table>
152
153
</body>
154
</subsection>
155
<subsection>
156
<title>A Stage2 Approach</title>
157
<body>
158
159
<p>
160
A <e>stage2</e> is used for building the entire system from a bootstrapped
161
"semi-compiled" state.
162
</p>
163
164
<p>
165
When you perform a stage2 installation approach, you will build all system
166
packages (core packages, including toolchain) using your specific <c>USE</c>, 
167
<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
168
optimized to your preference.
169
</p>
170
171
<p>
172
However, this installation takes some time and if you do not intend to change
173
the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
174
default", using this approach only makes sense if your <c>USE</c> variable is
175
sufficiently different from the default <c>USE</c> we provide.
176
</p>
177
178
<table>
179
<tr>
180
  <th>Stage2</th>
181
  <th>Pros and Cons</th>
182
</tr>
183
<tr>
184
  <th>+</th>
185
  <ti>You don't need to bootstrap</ti>
186
</tr>
187
<tr>
188
  <th>+</th>
189
  <ti>Faster than starting with stage1</ti>
190
</tr>
191
<tr>
192
  <th>+</th>
193
  <ti>You can still tweak your settings</ti>
194
</tr>
195
<tr>
196
  <th>-</th>
197
  <ti>It's still not the fastest way to install Gentoo</ti>
198
</tr>
199
<tr>
200
  <th>-</th>
201
  <ti>
202
    Requires a working Internet connection during the installation
203
  </ti>
204
</tr>
205
</table>
206
207
</body>
208
</subsection>
209
<subsection>
210
<title>A Stage3 Approach</title>
211
<body>
212
213
<p>
214
A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
215
built for you. You will only need to build a few packages (such as system
216
logger, networking tools, ...) before you can boot into a base Gentoo
217
installation.
218
</p>
219
220
<p>
221
Choosing to go with a stage3 allows for the fastest install of Gentoo
222
Linux, but also means that your base system will have the optimization
223
settings that we chose for you (which to be honest, are good settings
224
and were carefully chosen to enhance performance while maintaining
225
stability). Stage3 is also required if you want to install Gentoo using
226
prebuilt packages or without a network connection.
227
</p>
228
229
<table>
230
<tr>
231
  <th>Stage3</th>
232
  <th>Pros and Cons</th>
233
</tr>
234
<tr>
235
  <th>+</th>
236
  <ti>Fastest way to get a Gentoo base system</ti>
237
</tr>
238
<tr>
239
  <th>+</th>
240
  <ti>
241
    You can still tweak your system
242
  </ti>
243
</tr>
244
</table>
245
246
<p>
247
You might be interested to know that, if you decide to use different 
248
optimization settings after having installed Gentoo, you will be able to 
249
recompile your entire system with the new optimization settings. The same goes
250
for any <c>USE</c> flag changes: Portage is intelligent enough to know what
251
packages need to be rebuild.
252
</p>
253
254
</body>
255
</subsection>
256
</section>
257
258
<section>
259
<title>The Gentoo Installation CDs</title>
59
<title>The Gentoo Installation CDs</title>
260
<subsection>
60
<subsection>
261
<title>Introduction</title>
61
<title>Introduction</title>
Lines 294-302 Link Here
294
  </li>
94
  </li>
295
  <li>
95
  <li>
296
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 
96
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 
297
    abilities as the Minimal Installation CD. Additionally, it contains a 
97
    abilities as the Minimal Installation CD. Additionally, it contains 
298
    stage1 and several stage3 tarballs (optimized for the individual 
98
    several stage3 tarballs (optimized for the individual subarchitectures). 
299
    subarchitectures). 
300
  </li>
99
  </li>
301
</ul>
100
</ul>
302
101
Lines 327-342 Link Here
327
  <ti>Smallest download</ti>
126
  <ti>Smallest download</ti>
328
</tr>
127
</tr>
329
<tr>
128
<tr>
330
  <th>+</th>
331
  <ti>
332
    You can do a stage1, stage2 or stage3 by getting the stage tarball off the
333
    net
334
  </ti>
335
</tr>
336
<tr>
337
  <th>-</th>
129
  <th>-</th>
338
  <ti>
130
  <ti>
339
    Contains no stages, no Portage snapshot, no prebuilt packages and is
131
    Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
340
    therefore not suitable for networkless installation
132
    therefore not suitable for networkless installation
341
  </ti>
133
  </ti>
342
</tr>
134
</tr>
Lines 390-396 Link Here
390
182
391
<p>
183
<p>
392
If you intend to use the Packages CD to quickly install additional software,
184
If you intend to use the Packages CD to quickly install additional software,
393
make sure that you use the same subarchitecture as the stage-3 tarball you use.
185
make sure that you use the same subarchitecture as the stage3 tarball you use.
186
</p>
187
188
</body>
189
</subsection>
190
<subsection>
191
<title>The Stage3 Tarball</title>
192
<body>
193
194
<p>
195
A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
196
to continue the Gentoo installation using the instructions in this manual.
197
Previously, the Gentoo Handbook described the installation using one of three 
198
stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 
199
official installation method uses the stage3 tarball. If you are interested in
200
performing a Gentoo installation using a stage1 or stage2 tarball, please read
201
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
202
Using a Stage1 or Stage2 Tarball?</uri>
394
</p>
203
</p>
395
204
396
</body>
205
</body>
(-)handbook/hb-install-mips-medium.xml (-201 / +18 lines)
Lines 51-258 Link Here
51
</body>
51
</body>
52
</subsection>
52
</subsection>
53
</section>
53
</section>
54
<!-- Only the stuff about the stages is replicated from the
55
     hb-install-x86-medium.xml file since MIPS uses netbooting 
56
     -->
57
<!-- START -->
58
<section>
59
<title>The Gentoo Installation Approaches</title>
60
<subsection>
61
<title>Introduction</title>
62
<body>
63
64
<p>
65
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
66
A stage file is a tarball (compressed archive) that contains a minimal
67
environment.
68
</p>
69
70
<ul>
71
  <li>
72
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
73
     software management system) and a couple of packages on which the compiler
74
     or Portage depends.
75
   </li>
76
   <li>
77
     A stage2 file contains a so-called bootstrapped system, a minimal
78
     environment from which one can start building all other necessary
79
     applications that make a Gentoo environment complete.
80
   </li>
81
   <li>
82
     A stage3 file contains a prebuilt minimal system which is almost fully
83
     deployable. It only lacks a few applications where you, the Gentoo user,
84
     needs to choose which one you want to install.
85
   </li>
86
</ul>
87
88
<p>
89
To help you decide what stage file you want to use, we have written down the
90
major advantages and disadvantages of each stage file.
91
</p>
92
93
</body>
94
</subsection>
95
<subsection>
96
<title>A Stage1 Approach</title>
97
<body>
98
99
<p>
100
A <e>stage1</e> is used when you want to bootstrap and build the entire system 
101
from scratch.
102
</p>
103
104
<p>
105
This approach builds core system packages that are vital to your system and is
106
used by Gentoo developers to prepare the Gentoo release media. It is a great
107
installation method for those who would like to learn more about the inner
108
workings of bootstrapping, toolchains and the like.
109
</p>
110
111
<p>
112
However, if you do not plan to tweak the bootstrapping instructions in the
113
<path>bootstrap.sh</path> script written by the Gentoo developers, then a 
114
stage1 approach has no benefits for you. 
115
</p>
116
117
<table>
118
<tr>
119
  <th>Stage1</th>
120
  <th>Pros and Cons</th>
121
</tr>
122
<tr>
123
  <th>+</th>
124
  <ti>
125
    Allows you to have total control over the installation routine, bootstrap
126
    sequence, etc.
127
  </ti>
128
</tr>
129
<tr>
130
  <th>+</th>
131
  <ti>Suitable for powerusers and developers who know what they are doing</ti>
132
</tr>
133
<tr>
134
  <th>-</th>
135
  <ti>
136
    Takes a long time to finish the installation (it is the lengthiest approach)
137
  </ti>
138
</tr>
139
<tr>
140
  <th>-</th>
141
  <ti>
142
    If you don't intend to tweak the settings, it is a waste of time
143
  </ti>
144
</tr>
145
<tr>
146
  <th>-</th>
147
  <ti>
148
    Requires a working Internet connection during the installation
149
  </ti>
150
</tr>
151
</table>
152
153
</body>
154
</subsection>
155
<subsection>
156
<title>A Stage2 Approach</title>
157
<body>
158
159
<p>
160
A <e>stage2</e> is used for building the entire system from a bootstrapped
161
"semi-compiled" state.
162
</p>
163
164
<p>
165
When you perform a stage2 installation approach, you will build all system
166
packages (core packages, including toolchain) using your specific <c>USE</c>, 
167
<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
168
optimized to your preference.
169
</p>
170
171
<p>
172
However, this installation takes some time and if you do not intend to change
173
the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
174
default", using this approach only makes sense if your <c>USE</c> variable is
175
sufficiently different from the default <c>USE</c> we provide.
176
</p>
177
178
<table>
179
<tr>
180
  <th>Stage2</th>
181
  <th>Pros and Cons</th>
182
</tr>
183
<tr>
184
  <th>+</th>
185
  <ti>You don't need to bootstrap</ti>
186
</tr>
187
<tr>
188
  <th>+</th>
189
  <ti>Faster than starting with stage1</ti>
190
</tr>
191
<tr>
192
  <th>+</th>
193
  <ti>You can still tweak your settings</ti>
194
</tr>
195
<tr>
196
  <th>-</th>
197
  <ti>It's still not the fastest way to install Gentoo</ti>
198
</tr>
199
<tr>
200
  <th>-</th>
201
  <ti>
202
    Requires a working Internet connection during the installation
203
  </ti>
204
</tr>
205
</table>
206
54
207
</body>
55
<section>
208
</subsection>
56
<title>Installation Notes</title>
209
<subsection>
210
<title>A Stage3 Approach</title>
211
<body>
212
213
<p>
214
A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
215
built for you. You will only need to build a few packages (such as system
216
logger, networking tools, ...) before you can boot into a base Gentoo
217
installation.
218
</p>
219
220
<p>
221
Choosing to go with a stage3 allows for the fastest install of Gentoo
222
Linux, but also means that your base system will have the optimization
223
settings that we chose for you (which to be honest, are good settings
224
and were carefully chosen to enhance performance while maintaining
225
stability). Stage3 is also required if you want to install Gentoo using
226
prebuilt packages or without a network connection.
227
</p>
228
229
<table>
230
<tr>
231
  <th>Stage3</th>
232
  <th>Pros and Cons</th>
233
</tr>
234
<tr>
235
  <th>+</th>
236
  <ti>Fastest way to get a Gentoo base system</ti>
237
</tr>
238
<tr>
239
  <th>+</th>
240
  <ti>
241
    You can still tweak your system
242
  </ti>
243
</tr>
244
</table>
245
246
<p>
247
You might be interested to know that, if you decide to use different 
248
optimization settings after having installed Gentoo, you will be able to 
249
recompile your entire system with the new optimization settings. The same goes
250
for any <c>USE</c> flag changes: Portage is intelligent enough to know what
251
packages need to be rebuild.
252
</p>
253
254
</body>
255
</subsection>
256
<subsection>
57
<subsection>
257
<title>A note about Processor Architectures</title>
58
<title>A note about Processor Architectures</title>
258
<body>
59
<body>
Lines 394-400 Link Here
394
195
395
</body>
196
</body>
396
</subsection>
197
</subsection>
198
<subsection>
199
<title>The Stage3 Tarball</title>
200
<body>
397
201
202
<p>
203
A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
204
to continue the Gentoo installation using the instructions in this manual.
205
Previously, the Gentoo Handbook described the installation using one of three 
206
stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 
207
official installation method uses the stage3 tarball. If you are interested in
208
performing a Gentoo installation using a stage1 or stage2 tarball, please read
209
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
210
Using a Stage1 or Stage2 Tarball?</uri>
211
</p>
212
213
</body>
214
</subsection>
398
</section>
215
</section>
399
216
400
<section>
217
<section>
(-)handbook/hb-install-ppc-medium.xml (-212 / +21 lines)
Lines 81-286 Link Here
81
<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) -->
81
<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) -->
82
<!-- START -->
82
<!-- START -->
83
<section>
83
<section>
84
<title>The Gentoo Installation Approaches</title>
85
<subsection>
86
<title>Introduction</title>
87
<body>
88
89
<p>
90
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
91
A stage file is a tarball (compressed archive) that contains a minimal
92
environment.
93
</p>
94
95
<ul>
96
  <li>
97
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
98
     software management system) and a couple of packages on which the compiler
99
     or Portage depends.
100
   </li>
101
   <li>
102
     A stage2 file contains a so-called bootstrapped system, a minimal
103
     environment from which one can start building all other necessary
104
     applications that make a Gentoo environment complete.
105
   </li>
106
   <li>
107
     A stage3 file contains a prebuilt minimal system which is almost fully
108
     deployable. It only lacks a few applications where you, the Gentoo user,
109
     needs to choose which one you want to install.
110
   </li>
111
</ul>
112
113
<p>
114
To help you decide what stage file you want to use, we have written down the
115
major advantages and disadvantages of each stage file.
116
</p>
117
118
</body>
119
</subsection>
120
<subsection>
121
<title>A Stage1 Approach</title>
122
<body>
123
124
<p>
125
A <e>stage1</e> is used when you want to bootstrap and build the entire system 
126
from scratch.
127
</p>
128
129
<p>
130
This approach builds core system packages that are vital to your system and is
131
used by Gentoo developers to prepare the Gentoo release media. It is a great
132
installation method for those who would like to learn more about the inner
133
workings of bootstrapping, toolchains and the like.
134
</p>
135
136
<p>
137
However, if you do not plan to tweak the bootstrapping instructions in the
138
<path>bootstrap.sh</path> script written by the Gentoo developers, then a 
139
stage1 approach has no benefits for you. 
140
</p>
141
142
<table>
143
<tr>
144
  <th>Stage1</th>
145
  <th>Pros and Cons</th>
146
</tr>
147
<tr>
148
  <th>+</th>
149
  <ti>
150
    Allows you to have total control over the installation routine, bootstrap
151
    sequence, etc.
152
  </ti>
153
</tr>
154
<tr>
155
  <th>+</th>
156
  <ti>Suitable for powerusers and developers who know what they are doing</ti>
157
</tr>
158
<tr>
159
  <th>-</th>
160
  <ti>
161
    Takes a long time to finish the installation (it is the lengthiest approach)
162
  </ti>
163
</tr>
164
<tr>
165
  <th>-</th>
166
  <ti>
167
    If you don't intend to tweak the settings, it is a waste of time
168
  </ti>
169
</tr>
170
<tr>
171
  <th>-</th>
172
  <ti>
173
    Requires a working Internet connection during the installation
174
  </ti>
175
</tr>
176
</table>
177
178
</body>
179
</subsection>
180
<subsection>
181
<title>A Stage2 Approach</title>
182
<body>
183
184
<p>
185
A <e>stage2</e> is used for building the entire system from a bootstrapped
186
"semi-compiled" state.
187
</p>
188
189
<p>
190
When you perform a stage2 installation approach, you will build all system
191
packages (core packages, including toolchain) using your specific <c>USE</c>, 
192
<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
193
optimized to your preference.
194
</p>
195
196
<p>
197
However, this installation takes some time and if you do not intend to change
198
the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
199
default", using this approach only makes sense if your <c>USE</c> variable is
200
sufficiently different from the default <c>USE</c> we provide.
201
</p>
202
203
<table>
204
<tr>
205
  <th>Stage2</th>
206
  <th>Pros and Cons</th>
207
</tr>
208
<tr>
209
  <th>+</th>
210
  <ti>You don't need to bootstrap</ti>
211
</tr>
212
<tr>
213
  <th>+</th>
214
  <ti>Faster than starting with stage1</ti>
215
</tr>
216
<tr>
217
  <th>+</th>
218
  <ti>You can still tweak your settings</ti>
219
</tr>
220
<tr>
221
  <th>-</th>
222
  <ti>It's still not the fastest way to install Gentoo</ti>
223
</tr>
224
<tr>
225
  <th>-</th>
226
  <ti>
227
    Requires a working Internet connection during the installation
228
  </ti>
229
</tr>
230
</table>
231
232
</body>
233
</subsection>
234
<subsection>
235
<title>A Stage3 Approach</title>
236
<body>
237
238
<p>
239
A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
240
built for you. You will only need to build a few packages (such as system
241
logger, networking tools, ...) before you can boot into a base Gentoo
242
installation.
243
</p>
244
245
<p>
246
Choosing to go with a stage3 allows for the fastest install of Gentoo
247
Linux, but also means that your base system will have the optimization
248
settings that we chose for you (which to be honest, are good settings
249
and were carefully chosen to enhance performance while maintaining
250
stability). Stage3 is also required if you want to install Gentoo using
251
prebuilt packages or without a network connection.
252
</p>
253
254
<table>
255
<tr>
256
  <th>Stage3</th>
257
  <th>Pros and Cons</th>
258
</tr>
259
<tr>
260
  <th>+</th>
261
  <ti>Fastest way to get a Gentoo base system</ti>
262
</tr>
263
<tr>
264
  <th>+</th>
265
  <ti>
266
    You can still tweak your system
267
  </ti>
268
</tr>
269
</table>
270
271
<p>
272
You might be interested to know that, if you decide to use different 
273
optimization settings after having installed Gentoo, you will be able to 
274
recompile your entire system with the new optimization settings. The same goes
275
for any <c>USE</c> flag changes: Portage is intelligent enough to know what
276
packages need to be rebuild.
277
</p>
278
279
</body>
280
</subsection>
281
</section>
282
283
<section>
284
<title>The Gentoo Installation CDs</title>
84
<title>The Gentoo Installation CDs</title>
285
<subsection>
85
<subsection>
286
<title>Introduction</title>
86
<title>Introduction</title>
Lines 319-327 Link Here
319
  </li>
119
  </li>
320
  <li>
120
  <li>
321
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 
121
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 
322
    abilities as the Minimal Installation CD. Additionally, it contains a 
122
    abilities as the Minimal Installation CD. Additionally, it contains
323
    stage1 and several stage3 tarballs (optimized for the individual 
123
    several stage3 tarballs (optimized for the individual subarchitectures). 
324
    subarchitectures). 
325
  </li>
124
  </li>
326
</ul>
125
</ul>
327
126
Lines 352-367 Link Here
352
  <ti>Smallest download</ti>
151
  <ti>Smallest download</ti>
353
</tr>
152
</tr>
354
<tr>
153
<tr>
355
  <th>+</th>
356
  <ti>
357
    You can do a stage1, stage2 or stage3 by getting the stage tarball off the
358
    net
359
  </ti>
360
</tr>
361
<tr>
362
  <th>-</th>
154
  <th>-</th>
363
  <ti>
155
  <ti>
364
    Contains no stages, no Portage snapshot, no prebuilt packages and is
156
    Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
365
    therefore not suitable for networkless installation
157
    therefore not suitable for networkless installation
366
  </ti>
158
  </ti>
367
</tr>
159
</tr>
Lines 416-422 Link Here
416
208
417
<p>
209
<p>
418
If you intend to use the Packages CD to quickly install additional software,
210
If you intend to use the Packages CD to quickly install additional software,
419
make sure that you use the same subarchitecture as the stage-3 tarball you use.
211
make sure that you use the same subarchitecture as the stage3 tarball you use.
212
</p>
213
214
</body>
215
</subsection>
216
<subsection>
217
<title>The Stage3 Tarball</title>
218
<body>
219
220
<p>
221
A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
222
to continue the Gentoo installation using the instructions in this manual.
223
Previously, the Gentoo Handbook described the installation using one of three 
224
stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 
225
official installation method uses the stage3 tarball. If you are interested in
226
performing a Gentoo installation using a stage1 or stage2 tarball, please read
227
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
228
Using a Stage1 or Stage2 Tarball?</uri>
420
</p>
229
</p>
421
230
422
</body>
231
</body>
(-)handbook/hb-install-ppc64-medium.xml (-208 / +18 lines)
Lines 64-269 Link Here
64
<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
64
<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
65
<!-- START -->
65
<!-- START -->
66
<section>
66
<section>
67
<title>The Gentoo Installation Approaches</title>
68
<subsection>
69
<title>Introduction</title>
70
<body>
71
72
<p>
73
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
74
A stage file is a tarball (compressed archive) that contains a minimal
75
environment.
76
</p>
77
78
<ul>
79
  <li>
80
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
81
     software management system) and a couple of packages on which the compiler
82
     or Portage depends.
83
   </li>
84
   <li>
85
     A stage2 file contains a so-called bootstrapped system, a minimal
86
     environment from which one can start building all other necessary
87
     applications that make a Gentoo environment complete.
88
   </li>
89
   <li>
90
     A stage3 file contains a prebuilt minimal system which is almost fully
91
     deployable. It only lacks a few applications where you, the Gentoo user,
92
     needs to choose which one you want to install.
93
   </li>
94
</ul>
95
96
<p>
97
To help you decide what stage file you want to use, we have written down the
98
major advantages and disadvantages of each stage file.
99
</p>
100
101
</body>
102
</subsection>
103
<subsection>
104
<title>A Stage1 Approach</title>
105
<body>
106
107
<p>
108
A <e>stage1</e> is used when you want to bootstrap and build the entire system 
109
from scratch.
110
</p>
111
112
<p>
113
This approach builds core system packages that are vital to your system and is
114
used by Gentoo developers to prepare the Gentoo release media. It is a great
115
installation method for those who would like to learn more about the inner
116
workings of bootstrapping, toolchains and the like.
117
</p>
118
119
<p>
120
However, if you do not plan to tweak the bootstrapping instructions in the
121
<path>bootstrap.sh</path> script written by the Gentoo developers, then a 
122
stage1 approach has no benefits for you. 
123
</p>
124
125
<table>
126
<tr>
127
  <th>Stage1</th>
128
  <th>Pros and Cons</th>
129
</tr>
130
<tr>
131
  <th>+</th>
132
  <ti>
133
    Allows you to have total control over the installation routine, bootstrap
134
    sequence, etc.
135
  </ti>
136
</tr>
137
<tr>
138
  <th>+</th>
139
  <ti>Suitable for powerusers and developers who know what they are doing</ti>
140
</tr>
141
<tr>
142
  <th>-</th>
143
  <ti>
144
    Takes a long time to finish the installation (it is the lengthiest approach)
145
  </ti>
146
</tr>
147
<tr>
148
  <th>-</th>
149
  <ti>
150
    If you don't intend to tweak the settings, it is a waste of time
151
  </ti>
152
</tr>
153
<tr>
154
  <th>-</th>
155
  <ti>
156
    Requires a working Internet connection during the installation
157
  </ti>
158
</tr>
159
</table>
160
161
</body>
162
</subsection>
163
<subsection>
164
<title>A Stage2 Approach</title>
165
<body>
166
167
<p>
168
A <e>stage2</e> is used for building the entire system from a bootstrapped
169
"semi-compiled" state.
170
</p>
171
172
<p>
173
When you perform a stage2 installation approach, you will build all system
174
packages (core packages, including toolchain) using your specific <c>USE</c>, 
175
<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
176
optimized to your preference.
177
</p>
178
179
<p>
180
However, this installation takes some time and if you do not intend to change
181
the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
182
default", using this approach only makes sense if your <c>USE</c> variable is
183
sufficiently different from the default <c>USE</c> we provide.
184
</p>
185
186
<table>
187
<tr>
188
  <th>Stage2</th>
189
  <th>Pros and Cons</th>
190
</tr>
191
<tr>
192
  <th>+</th>
193
  <ti>You don't need to bootstrap</ti>
194
</tr>
195
<tr>
196
  <th>+</th>
197
  <ti>Faster than starting with stage1</ti>
198
</tr>
199
<tr>
200
  <th>+</th>
201
  <ti>You can still tweak your settings</ti>
202
</tr>
203
<tr>
204
  <th>-</th>
205
  <ti>It's still not the fastest way to install Gentoo</ti>
206
</tr>
207
<tr>
208
  <th>-</th>
209
  <ti>
210
    Requires a working Internet connection during the installation
211
  </ti>
212
</tr>
213
</table>
214
215
</body>
216
</subsection>
217
<subsection>
218
<title>A Stage3 Approach</title>
219
<body>
220
221
<p>
222
A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
223
built for you. You will only need to build a few packages (such as system
224
logger, networking tools, ...) before you can boot into a base Gentoo
225
installation.
226
</p>
227
228
<p>
229
Choosing to go with a stage3 allows for the fastest install of Gentoo
230
Linux, but also means that your base system will have the optimization
231
settings that we chose for you (which to be honest, are good settings
232
and were carefully chosen to enhance performance while maintaining
233
stability). Stage3 is also required if you want to install Gentoo using
234
prebuilt packages or without a network connection.
235
</p>
236
237
<table>
238
<tr>
239
  <th>Stage3</th>
240
  <th>Pros and Cons</th>
241
</tr>
242
<tr>
243
  <th>+</th>
244
  <ti>Fastest way to get a Gentoo base system</ti>
245
</tr>
246
<tr>
247
  <th>+</th>
248
  <ti>
249
    You can still tweak your system
250
  </ti>
251
</tr>
252
</table>
253
254
<p>
255
You might be interested to know that, if you decide to use different 
256
optimization settings after having installed Gentoo, you will be able to 
257
recompile your entire system with the new optimization settings. The same goes
258
for any <c>USE</c> flag changes: Portage is intelligent enough to know what
259
packages need to be rebuild.
260
</p>
261
262
</body>
263
</subsection>
264
</section>
265
266
<section>
267
<title>The Gentoo Installation CDs</title>
67
<title>The Gentoo Installation CDs</title>
268
<subsection>
68
<subsection>
269
<title>Introduction</title>
69
<title>Introduction</title>
Lines 321-336 Link Here
321
  <ti>Smallest download</ti>
121
  <ti>Smallest download</ti>
322
</tr>
122
</tr>
323
<tr>
123
<tr>
324
  <th>+</th>
325
  <ti>
326
    You can do a stage1, stage2 or stage3 by getting the stage tarball off the
327
    net
328
  </ti>
329
</tr>
330
<tr>
331
  <th>-</th>
124
  <th>-</th>
332
  <ti>
125
  <ti>
333
    Contains no stages, no Portage snapshot, no prebuilt packages and is
126
    Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
334
    therefore not suitable for networkless installation
127
    therefore not suitable for networkless installation
335
  </ti>
128
  </ti>
336
</tr>
129
</tr>
Lines 338-343 Link Here
338
131
339
</body>
132
</body>
340
</subsection>
133
</subsection>
134
<subsection>
135
<title>The Stage3 Tarball</title>
136
<body>
137
138
<p>
139
A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
140
to continue the Gentoo installation using the instructions in this manual.
141
Previously, the Gentoo Handbook described the installation using one of three 
142
stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 
143
official installation method uses the stage3 tarball. If you are interested in
144
performing a Gentoo installation using a stage1 or stage2 tarball, please read
145
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
146
Using a Stage1 or Stage2 Tarball?</uri>
147
</p>
148
149
</body>
150
</subsection>
341
</section>
151
</section>
342
<!-- STOP -->
152
<!-- STOP -->
343
<section>
153
<section>
(-)handbook/hb-install-sparc-medium.xml (-212 / +21 lines)
Lines 63-268 Link Here
63
<!-- Warning: The part originally contains "x86" -->
63
<!-- Warning: The part originally contains "x86" -->
64
<!-- START -->
64
<!-- START -->
65
<section>
65
<section>
66
<title>The Gentoo Installation Approaches</title>
67
<subsection>
68
<title>Introduction</title>
69
<body>
70
71
<p>
72
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
73
A stage file is a tarball (compressed archive) that contains a minimal
74
environment.
75
</p>
76
77
<ul>
78
  <li>
79
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
80
     software management system) and a couple of packages on which the compiler
81
     or Portage depends.
82
   </li>
83
   <li>
84
     A stage2 file contains a so-called bootstrapped system, a minimal
85
     environment from which one can start building all other necessary
86
     applications that make a Gentoo environment complete.
87
   </li>
88
   <li>
89
     A stage3 file contains a prebuilt minimal system which is almost fully
90
     deployable. It only lacks a few applications where you, the Gentoo user,
91
     needs to choose which one you want to install.
92
   </li>
93
</ul>
94
95
<p>
96
To help you decide what stage file you want to use, we have written down the
97
major advantages and disadvantages of each stage file.
98
</p>
99
100
</body>
101
</subsection>
102
<subsection>
103
<title>A Stage1 Approach</title>
104
<body>
105
106
<p>
107
A <e>stage1</e> is used when you want to bootstrap and build the entire system 
108
from scratch.
109
</p>
110
111
<p>
112
This approach builds core system packages that are vital to your system and is
113
used by Gentoo developers to prepare the Gentoo release media. It is a great
114
installation method for those who would like to learn more about the inner
115
workings of bootstrapping, toolchains and the like.
116
</p>
117
118
<p>
119
However, if you do not plan to tweak the bootstrapping instructions in the
120
<path>bootstrap.sh</path> script written by the Gentoo developers, then a 
121
stage1 approach has no benefits for you. 
122
</p>
123
124
<table>
125
<tr>
126
  <th>Stage1</th>
127
  <th>Pros and Cons</th>
128
</tr>
129
<tr>
130
  <th>+</th>
131
  <ti>
132
    Allows you to have total control over the installation routine, bootstrap
133
    sequence, etc.
134
  </ti>
135
</tr>
136
<tr>
137
  <th>+</th>
138
  <ti>Suitable for powerusers and developers who know what they are doing</ti>
139
</tr>
140
<tr>
141
  <th>-</th>
142
  <ti>
143
    Takes a long time to finish the installation (it is the lengthiest approach)
144
  </ti>
145
</tr>
146
<tr>
147
  <th>-</th>
148
  <ti>
149
    If you don't intend to tweak the settings, it is a waste of time
150
  </ti>
151
</tr>
152
<tr>
153
  <th>-</th>
154
  <ti>
155
    Requires a working Internet connection during the installation
156
  </ti>
157
</tr>
158
</table>
159
160
</body>
161
</subsection>
162
<subsection>
163
<title>A Stage2 Approach</title>
164
<body>
165
166
<p>
167
A <e>stage2</e> is used for building the entire system from a bootstrapped
168
"semi-compiled" state.
169
</p>
170
171
<p>
172
When you perform a stage2 installation approach, you will build all system
173
packages (core packages, including toolchain) using your specific <c>USE</c>, 
174
<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
175
optimized to your preference.
176
</p>
177
178
<p>
179
However, this installation takes some time and if you do not intend to change
180
the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
181
default", using this approach only makes sense if your <c>USE</c> variable is
182
sufficiently different from the default <c>USE</c> we provide.
183
</p>
184
185
<table>
186
<tr>
187
  <th>Stage2</th>
188
  <th>Pros and Cons</th>
189
</tr>
190
<tr>
191
  <th>+</th>
192
  <ti>You don't need to bootstrap</ti>
193
</tr>
194
<tr>
195
  <th>+</th>
196
  <ti>Faster than starting with stage1</ti>
197
</tr>
198
<tr>
199
  <th>+</th>
200
  <ti>You can still tweak your settings</ti>
201
</tr>
202
<tr>
203
  <th>-</th>
204
  <ti>It's still not the fastest way to install Gentoo</ti>
205
</tr>
206
<tr>
207
  <th>-</th>
208
  <ti>
209
    Requires a working Internet connection during the installation
210
  </ti>
211
</tr>
212
</table>
213
214
</body>
215
</subsection>
216
<subsection>
217
<title>A Stage3 Approach</title>
218
<body>
219
220
<p>
221
A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
222
built for you. You will only need to build a few packages (such as system
223
logger, networking tools, ...) before you can boot into a base Gentoo
224
installation.
225
</p>
226
227
<p>
228
Choosing to go with a stage3 allows for the fastest install of Gentoo
229
Linux, but also means that your base system will have the optimization
230
settings that we chose for you (which to be honest, are good settings
231
and were carefully chosen to enhance performance while maintaining
232
stability). Stage3 is also required if you want to install Gentoo using
233
prebuilt packages or without a network connection.
234
</p>
235
236
<table>
237
<tr>
238
  <th>Stage3</th>
239
  <th>Pros and Cons</th>
240
</tr>
241
<tr>
242
  <th>+</th>
243
  <ti>Fastest way to get a Gentoo base system</ti>
244
</tr>
245
<tr>
246
  <th>+</th>
247
  <ti>
248
    You can still tweak your system
249
  </ti>
250
</tr>
251
</table>
252
253
<p>
254
You might be interested to know that, if you decide to use different 
255
optimization settings after having installed Gentoo, you will be able to 
256
recompile your entire system with the new optimization settings. The same goes
257
for any <c>USE</c> flag changes: Portage is intelligent enough to know what
258
packages need to be rebuild.
259
</p>
260
261
</body>
262
</subsection>
263
</section>
264
265
<section>
266
<title>The Gentoo Installation CDs</title>
66
<title>The Gentoo Installation CDs</title>
267
<subsection>
67
<subsection>
268
<title>Introduction</title>
68
<title>Introduction</title>
Lines 301-309 Link Here
301
  </li>
101
  </li>
302
  <li>
102
  <li>
303
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 
103
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 
304
    abilities as the Minimal Installation CD. Additionally, it contains a 
104
    abilities as the Minimal Installation CD. Additionally, it contains 
305
    stage1 and several stage3 tarballs (optimized for the individual 
105
    several stage3 tarballs (optimized for the individual subarchitectures). 
306
    subarchitectures). 
307
  </li>
106
  </li>
308
</ul>
107
</ul>
309
108
Lines 342-357 Link Here
342
  <ti>Smallest download</ti>
141
  <ti>Smallest download</ti>
343
</tr>
142
</tr>
344
<tr>
143
<tr>
345
  <th>+</th>
346
  <ti>
347
    You can do a stage1, stage2 or stage3 by getting the stage tarball off the
348
    net
349
  </ti>
350
</tr>
351
<tr>
352
  <th>-</th>
144
  <th>-</th>
353
  <ti>
145
  <ti>
354
    Contains no stages, no Portage snapshot, no prebuilt packages and is
146
    Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
355
    therefore not suitable for networkless installation
147
    therefore not suitable for networkless installation
356
  </ti>
148
  </ti>
357
</tr>
149
</tr>
Lines 407-413 Link Here
407
199
408
<p>
200
<p>
409
If you intend to use the Packages CD to quickly install additional software,
201
If you intend to use the Packages CD to quickly install additional software,
410
make sure that you use the same subarchitecture as the stage-3 tarball you use.
202
make sure that you use the same subarchitecture as the stage3 tarball you use.
203
</p>
204
205
</body>
206
</subsection>
207
<subsection>
208
<title>The Stage3 Tarball</title>
209
<body>
210
211
<p>
212
A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
213
to continue the Gentoo installation using the instructions in this manual.
214
Previously, the Gentoo Handbook described the installation using one of three 
215
stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 
216
official installation method uses the stage3 tarball. If you are interested in
217
performing a Gentoo installation using a stage1 or stage2 tarball, please read
218
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
219
Using a Stage1 or Stage2 Tarball?</uri>
411
</p>
220
</p>
412
221
413
</body>
222
</body>
(-)handbook/hb-install-stage.xml (-103 / +14 lines)
Lines 49-56 Link Here
49
<body>
49
<body>
50
50
51
<p>
51
<p>
52
The next step you need to perform is to install the <e>stage</e> tarball of
52
The next step you need to perform is to install the <e>stage3</e> tarball 
53
your choice onto your system. You have the option of downloading the required
53
onto your system. You have the option of downloading the required
54
tarball from the Internet or, if you are booted from one of the Gentoo
54
tarball from the Internet or, if you are booted from one of the Gentoo
55
Universal Installation CDs, copy it over from the CD itself. If you have a 
55
Universal Installation CDs, copy it over from the CD itself. If you have a 
56
Universal CD and the stage you want to use is on the CD, downloading it from 
56
Universal CD and the stage you want to use is on the CD, downloading it from 
Lines 124-137 Link Here
124
</pre>
124
</pre>
125
125
126
<p>
126
<p>
127
Make sure you download a stage3 tarball - installations using a stage1 or stage2
128
tarball are not supported anymore.
129
</p>
130
131
<p>
127
If you want to check the integrity of the downloaded stage tarball, use
132
If you want to check the integrity of the downloaded stage tarball, use
128
<c>md5sum</c> and compare the output with the MD5 checksum provided on the
133
<c>md5sum</c> and compare the output with the MD5 checksum provided on the
129
mirror. For instance, to check the validity of the x86 stage tarball:
134
mirror. For instance, to check the validity of the x86 stage tarball:
130
</p>
135
</p>
131
136
132
<pre caption="Example checking integrity of a stage tarball">
137
<pre caption="Example checking integrity of a stage tarball">
133
# <i>md5sum -c stage1-x86-2005.1.tar.bz2.md5</i>
138
# <i>md5sum -c stage3-x86-2005.1.tar.bz2.md5</i>
134
stage1-x86-2005.1.tar.bz2: OK
139
stage3-x86-2005.1.tar.bz2: OK
135
</pre>
140
</pre>
136
141
137
</body>
142
</body>
Lines 146-152 Link Here
146
</p>
151
</p>
147
152
148
<pre caption="Unpacking the stage">
153
<pre caption="Unpacking the stage">
149
# <i>tar -xvjpf stage?-*.tar.bz2</i>
154
# <i>tar -xvjpf stage3-*.tar.bz2</i>
150
</pre>
155
</pre>
151
156
152
<p>
157
<p>
Lines 340-444 Link Here
340
<title>CHOST</title>
345
<title>CHOST</title>
341
<body>
346
<body>
342
347
343
<warn>
344
Although it might be tempting for non-stage1 users, they should <e>not</e>
345
change the <c>CHOST</c> setting in <path>make.conf</path>. Doing so might render
346
their system unusable. Again: only change this variable if you use a
347
<e>stage1</e> installation.
348
</warn>
349
350
<p>
351
The <c>CHOST</c> variable defines what architecture <c>gcc</c> has to
352
compile programs for. The possibilities are:
353
</p>
354
355
<table>
356
<tr>
357
  <th>Architecture</th>
358
  <th>Subarchitecture</th>
359
  <th>CHOST Setting</th>
360
</tr>
361
<tr>
362
  <ti>x86</ti>
363
  <ti>i386</ti>
364
  <ti>i386-pc-linux-gnu</ti>
365
</tr>
366
<tr>
367
  <ti>x86</ti>
368
  <ti>i486</ti>
369
  <ti>i486-pc-linux-gnu</ti>
370
</tr>
371
<tr>
372
  <ti>x86</ti>
373
  <ti>i586</ti>
374
  <ti>i586-pc-linux-gnu</ti>
375
</tr>
376
<tr>
377
  <ti>x86</ti>
378
  <ti>i686 and above (incl. athlon)</ti>
379
  <ti>i686-pc-linux-gnu</ti>
380
</tr>
381
<tr>
382
  <ti>alpha</ti>
383
  <ti></ti>
384
  <ti>alpha-unknown-linux-gnu</ti>
385
</tr>
386
<tr>
387
  <ti>ppc</ti>
388
  <ti></ti>
389
  <ti>powerpc-unknown-linux-gnu</ti>
390
</tr>
391
<tr>
392
  <ti>ppc64</ti>
393
  <ti></ti>
394
  <ti>powerpc64-unknown-linux-gnu</ti>
395
</tr>
396
<tr>
397
  <ti>sparc</ti>
398
  <ti></ti>
399
  <ti>sparc-unknown-linux-gnu</ti>
400
</tr>
401
<tr>
402
  <ti>sparc64</ti>
403
  <ti></ti>
404
  <ti>sparc-unknown-linux-gnu</ti>
405
</tr>
406
<tr>
407
  <ti>hppa</ti>
408
  <ti>(generic)</ti>
409
  <ti>hppa-unknown-linux-gnu</ti>
410
</tr>
411
<tr>
412
  <ti>hppa</ti>
413
  <ti>pa7000</ti>
414
  <ti>hppa1.1-unknown-linux-gnu</ti>
415
</tr>
416
<tr>
417
  <ti>hppa</ti>
418
  <ti>pa8000 and above</ti>
419
  <ti>hppa2.0-unknown-linux-gnu</ti>
420
</tr>
421
<tr>
422
  <ti>mips</ti>
423
  <ti></ti>
424
  <ti>mips-unknown-linux-gnu</ti>
425
</tr>
426
<tr>
427
  <ti>amd64</ti>
428
  <ti></ti>
429
  <ti>x86_64-pc-linux-gnu</ti>
430
</tr>
431
</table>
432
433
<p>
434
Please, make sure that you use the <e>correct</e> CHOST setting. For instance,
435
the CHOST setting for sparc64 still is <c>sparc-unknown-linux-gnu</c> and
436
<e>not</e> <c>sparc64-unknown-linux-gnu</c>!
437
</p>
438
439
<p>
348
<p>
440
Users interested in bootstrapping their entire system with NPTL support on an
349
The <c>CHOST</c> variable declares the target build host for your system. This
441
x86 system need to set their CHOST to <c>i586-pc-linux-gnu</c> or higher.
350
variable should already be set to the correct value. <brite>Do not edit
351
it</brite> as that might break your system. If the <c>CHOST</c> variable does
352
not look correct to you, you might be using the wrong stage3 tarball.
442
</p>
353
</p>
443
354
444
</body>
355
</body>
(-)handbook/hb-install-system.xml (-200 / +6 lines)
Lines 124-129 Link Here
124
124
125
</body>
125
</body>
126
</subsection>
126
</subsection>
127
</section>
128
129
<section>
130
<title>Configuring Portage</title>
127
<subsection>
131
<subsection>
128
<title>Updating the Portage tree</title>
132
<title>Updating the Portage tree</title>
129
<body>
133
<body>
Lines 341-348 Link Here
341
after compiling <c>glibc</c> a full set of all available locales will be
345
after compiling <c>glibc</c> a full set of all available locales will be
342
created. As of now you can activate the <c>userlocales</c> USE flag and specify
346
created. As of now you can activate the <c>userlocales</c> USE flag and specify
343
only the locales you will need in <path>/etc/locales.build</path>. Only do this
347
only the locales you will need in <path>/etc/locales.build</path>. Only do this
344
if you know what locales to choose. This will not work for the bootstrapping,
348
if you know what locales to choose. 
345
but when you recompile glibc afterwards it will.
346
</p>
349
</p>
347
350
348
<pre caption="Activate the userlocales USE flag especially for glibc">
351
<pre caption="Activate the userlocales USE flag especially for glibc">
Lines 370-577 Link Here
370
de_DE@euro/ISO-8859-15
373
de_DE@euro/ISO-8859-15
371
</pre>
374
</pre>
372
375
373
</body>
374
</subsection>
375
</section>
376
<section>
377
<title>Differences between Stage1, Stage2 and Stage3</title>
378
<body>
379
380
<p>
381
Now take a seat and think of your previous steps. We asked you to
382
select a <e>stage1</e>, <e>stage2</e> or <e>stage3</e> and warned you
383
that your choice is important for further installation steps. Well, this
384
is the first place where your choice defines the subsequent steps.
385
</p>
386
387
<ul>
388
<li>
389
  If you chose <e>stage1</e>, then you have to follow <e>both</e> steps in
390
  this chapter (starting with <uri link="#doc_chap3">Progressing from Stage1 
391
  to Stage2</uri>)
392
</li>
393
<li>
394
  If you chose <e>stage2</e> you only can skip the first step
395
  and immediately start with the second one (<uri link="#doc_chap4">Progressing
396
  from Stage2 to Stage3</uri>)
397
</li>
398
<li>
399
  If you chose <e>stage3</e> then you can skip both
400
  steps and continue with <uri link="?part=1&amp;chap=7">Configuring the 
401
  Kernel</uri>
402
</li>
403
</ul>
404
405
</body>
406
</section>
407
<section>
408
<title>Progressing from Stage1 to Stage2</title>
409
<subsection>
410
<title>Introduction to Bootstrapping</title>
411
<body>
412
413
<p>
414
So, you want to compile everything from scratch? Okay then :-)
415
</p>
416
417
<p>
418
In this step, we will <e>bootstrap</e> your Gentoo system. This takes a
419
long time, but the result is a system that has been optimized from the
420
ground up for your specific machine and needs.
421
</p>
422
423
<p>
424
<e>Bootstrapping</e> means building the GNU C Library, GNU Compiler
425
Collection and several other key system programs. 
426
</p>
427
428
<p>
429
Before starting the bootstrap, you might want to download all necessary
430
sourcecode first. If you do not want to do this, continue 
431
with <uri link="#bootstrap">Bootstrapping the System</uri>.
432
</p>
433
434
</body>
435
</subsection>
436
<subsection>
437
<title>Optional: Downloading the Sources First</title>
438
<body>
439
440
<p>
441
If you haven't copied over all source code before, then the bootstrap
442
script will download all necessary files. If you want to 
443
download the source code first and later bootstrap the system (for instance 
444
because you don't want to have your internet connection open during the 
445
compilation) use the <e>-f</e> option of the bootstrap script, which will 
446
fetch (hence the letter <e>f</e>) all source code for you.
447
</p>
448
449
<pre caption = "Downloading the necessary sources">
450
# <i>cd /usr/portage</i>
451
# <i>scripts/bootstrap.sh -f</i>
452
</pre>
453
454
</body>
455
</subsection>
456
<subsection id="bootstrap">
457
<title>Bootstrapping the System</title>
458
<body>
459
460
<p>
461
Okay then, take your keyboard and punch in the next commands to start
462
the bootstrap. Then go amuse yourself with something else because this step 
463
takes quite some time to finish.
464
</p>
465
466
<pre caption = "Bootstrapping the system">
467
# <i>cd /usr/portage</i>
468
# <i>scripts/bootstrap.sh</i>
469
</pre>
470
471
<p>
472
Now continue with the next step, <uri link="#doc_chap4">Progressing from Stage2
473
to Stage3</uri>.
474
</p>
475
476
</body>
477
</subsection>
478
</section>
479
<section>
480
<title>Progressing from Stage2 to Stage3</title>
481
<subsection>
482
<title>Introduction</title>
483
<body>
484
485
<p>
486
If you are reading this section, then you have a bootstrapped system
487
(either because you bootstrapped it previously, or you are using a
488
<e>stage2</e>). Then it is now time to build all system packages.
489
</p>
490
491
<p>
492
<e>All</e> system packages? No, not really. In this step, you will build
493
the system packages of which there are no alternatives to use.
494
Some system packages have several alternatives (such as system loggers)
495
and as Gentoo is all about choices, we don't want to force one upon you.
496
</p>
497
498
</body>
499
</subsection>
500
<subsection>
501
<title>Optional: Viewing what will be done</title>
502
<body>
503
504
<p>
505
If you want to know what packages will be installed, execute <c>emerge
506
--pretend --emptytree system</c>. This will list all packages that will be 
507
built. As this list is pretty big, you should also use a pager like 
508
<c>less</c> or <c>more</c> to go up and down the list.
509
</p>
510
511
<pre caption = "View what 'emerge system' will do">
512
# <i>emerge --pretend --emptytree system | less</i>
513
</pre>
514
515
<p>
516
Note that, if you haven't touched the default CFLAGS/CXXFLAGS setting, using 
517
<c>emerge --pretend --newuse system</c> is sufficient: it will rebuild the
518
applications that are affected by a change in USE flags (compared to the USE 
519
flag we used while building the stage2). If you didn't touch 
520
the USE flag either, why are you running a stage2 installation then?
521
</p>
522
523
</body>
524
</subsection>
525
<subsection>
526
<title>Optional: Downloading the Sources</title>
527
<body>
528
529
<p>
530
If you want <c>emerge</c> to download the sources before you continue
531
(for instance because you don't want the internet connection to be left
532
open while you are building all packages) you can use the <e>--fetchonly</e>
533
option of <c>emerge</c> which will fetch all sources for you. 
534
</p>
535
536
<pre caption = "Fetching the sources">
537
# <i>emerge --fetchonly --emptytree system</i>
538
</pre>
539
540
</body>
541
</subsection>
542
<subsection>
543
<title>Building the System</title>
544
<body>
545
546
<p>
547
To start building the system, execute <c>emerge --emptytree system</c>. Then 
548
go do something to keep your mind busy, because this step takes a long time to 
549
complete.
550
</p>
551
552
<pre caption = "Building the System">
553
# <i>emerge --emptytree system</i>
554
</pre>
555
556
<p>
376
<p>
557
Again, if you haven't touched the default CFLAGS and CXXFLAGS setting, using
377
Now continue with <uri link="?part=1&amp;chap=7">Configuring the Kernel</uri>.
558
<c>--newuse</c> is sufficient.
559
</p>
560
561
<p>
562
You can for now safely ignore any warnings about updated configuration files
563
(and running <c>etc-update</c>). When your Gentoo system is fully installed and
564
booted, do read our documentation on <uri
565
link="?part=3&amp;chap=2#doc_chap3">Configuration File Protection</uri>.
566
</p>
567
568
<p>
569
When the build process has completed, continue with <uri
570
link="?part=1&amp;chap=7">Configuring the Kernel</uri>.
571
</p>
378
</p>
572
379
573
</body>
380
</body>
574
</subsection>
381
</subsection>
575
</section>
382
</section>
576
577
</sections>
383
</sections>
(-)handbook/hb-install-x86-medium.xml (-211 / +21 lines)
Lines 53-257 Link Here
53
<!-- This part can be propagated to the other architectures as well. -->
53
<!-- This part can be propagated to the other architectures as well. -->
54
<!-- START -->
54
<!-- START -->
55
<section>
55
<section>
56
<title>The Gentoo Installation Approaches</title>
57
<subsection>
58
<title>Introduction</title>
59
<body>
60
61
<p>
62
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
63
A stage file is a tarball (compressed archive) that contains a minimal
64
environment.
65
</p>
66
67
<ul>
68
  <li>
69
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
70
     software management system) and a couple of packages on which the compiler
71
     or Portage depends.
72
   </li>
73
   <li>
74
     A stage2 file contains a so-called bootstrapped system, a minimal
75
     environment from which one can start building all other necessary
76
     applications that make a Gentoo environment complete.
77
   </li>
78
   <li>
79
     A stage3 file contains a prebuilt minimal system which is almost fully
80
     deployable. It only lacks a few applications where you, the Gentoo user,
81
     needs to choose which one you want to install.
82
   </li>
83
</ul>
84
85
<p>
86
To help you decide what stage file you want to use, we have written down the
87
major advantages and disadvantages of each stage file.
88
</p>
89
90
</body>
91
</subsection>
92
<subsection>
93
<title>A Stage1 Approach</title>
94
<body>
95
96
<p>
97
A <e>stage1</e> is used when you want to bootstrap and build the entire system 
98
from scratch.
99
</p>
100
101
<p>
102
This approach builds core system packages that are vital to your system and is
103
used by Gentoo developers to prepare the Gentoo release media. It is a great
104
installation method for those who would like to learn more about the inner
105
workings of bootstrapping, toolchains and the like.
106
</p>
107
108
<p>
109
However, if you do not plan to tweak the bootstrapping instructions in the
110
<path>bootstrap.sh</path> script written by the Gentoo developers, then a 
111
stage1 approach has no benefits for you. 
112
</p>
113
114
<table>
115
<tr>
116
  <th>Stage1</th>
117
  <th>Pros and Cons</th>
118
</tr>
119
<tr>
120
  <th>+</th>
121
  <ti>
122
    Allows you to have total control over the installation routine, bootstrap
123
    sequence, etc.
124
  </ti>
125
</tr>
126
<tr>
127
  <th>+</th>
128
  <ti>Suitable for powerusers and developers who know what they are doing</ti>
129
</tr>
130
<tr>
131
  <th>-</th>
132
  <ti>
133
    Takes a long time to finish the installation (it is the lengthiest approach)
134
  </ti>
135
</tr>
136
<tr>
137
  <th>-</th>
138
  <ti>
139
    If you don't intend to tweak the settings, it is a waste of time
140
  </ti>
141
</tr>
142
<tr>
143
  <th>-</th>
144
  <ti>
145
    Requires a working Internet connection during the installation
146
  </ti>
147
</tr>
148
</table>
149
150
</body>
151
</subsection>
152
<subsection>
153
<title>A Stage2 Approach</title>
154
<body>
155
156
<p>
157
A <e>stage2</e> is used for building the entire system from a bootstrapped
158
"semi-compiled" state.
159
</p>
160
161
<p>
162
When you perform a stage2 installation approach, you will build all system
163
packages (core packages, including toolchain) using your specific <c>USE</c>, 
164
<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
165
optimized to your preference.
166
</p>
167
168
<p>
169
However, this installation takes some time and if you do not intend to change
170
the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
171
default", using this approach only makes sense if your <c>USE</c> variable is
172
sufficiently different from the default <c>USE</c> we provide.
173
</p>
174
175
<table>
176
<tr>
177
  <th>Stage2</th>
178
  <th>Pros and Cons</th>
179
</tr>
180
<tr>
181
  <th>+</th>
182
  <ti>You don't need to bootstrap</ti>
183
</tr>
184
<tr>
185
  <th>+</th>
186
  <ti>Faster than starting with stage1</ti>
187
</tr>
188
<tr>
189
  <th>+</th>
190
  <ti>You can still tweak your settings</ti>
191
</tr>
192
<tr>
193
  <th>-</th>
194
  <ti>It's still not the fastest way to install Gentoo</ti>
195
</tr>
196
<tr>
197
  <th>-</th>
198
  <ti>
199
    Requires a working Internet connection during the installation
200
  </ti>
201
</tr>
202
</table>
203
204
</body>
205
</subsection>
206
<subsection>
207
<title>A Stage3 Approach</title>
208
<body>
209
210
<p>
211
A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
212
built for you. You will only need to build a few packages (such as system
213
logger, networking tools, ...) before you can boot into a base Gentoo
214
installation.
215
</p>
216
217
<p>
218
Choosing to go with a stage3 allows for the fastest install of Gentoo
219
Linux, but also means that your base system will have the optimization
220
settings that we chose for you (which to be honest, are good settings
221
and were carefully chosen to enhance performance while maintaining
222
stability). Stage3 is also required if you want to install Gentoo using
223
prebuilt packages or without a network connection.
224
</p>
225
226
<table>
227
<tr>
228
  <th>Stage3</th>
229
  <th>Pros and Cons</th>
230
</tr>
231
<tr>
232
  <th>+</th>
233
  <ti>Fastest way to get a Gentoo base system</ti>
234
</tr>
235
<tr>
236
  <th>+</th>
237
  <ti>
238
    You can still tweak your system
239
  </ti>
240
</tr>
241
</table>
242
243
<p>
244
You might be interested to know that, if you decide to use different 
245
optimization settings after having installed Gentoo, you will be able to 
246
recompile your entire system with the new optimization settings. The same goes
247
for any <c>USE</c> flag changes: Portage is intelligent enough to know what
248
packages need to be rebuild.
249
</p>
250
251
</body>
252
</subsection>
253
</section>
254
<section>
255
<title>The Gentoo Installation CDs</title>
56
<title>The Gentoo Installation CDs</title>
256
<subsection>
57
<subsection>
257
<title>Introduction</title>
58
<title>Introduction</title>
Lines 290-298 Link Here
290
  </li>
91
  </li>
291
  <li>
92
  <li>
292
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
93
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
293
    abilities as the Minimal Installation CD. Additionally, it contains a 
94
    abilities as the Minimal Installation CD. Additionally, it contains 
294
    stage1 and several stage3 tarballs (optimized for the individual 
95
    several stage3 tarballs (optimized for the individual subarchitectures). 
295
    subarchitectures). 
296
  </li>
96
  </li>
297
</ul>
97
</ul>
298
98
Lines 323-338 Link Here
323
  <ti>Smallest download</ti>
123
  <ti>Smallest download</ti>
324
</tr>
124
</tr>
325
<tr>
125
<tr>
326
  <th>+</th>
327
  <ti>
328
    You can do a stage1, stage2 or stage3 by getting the stage tarball off the
329
    net
330
  </ti>
331
</tr>
332
<tr>
333
  <th>-</th>
126
  <th>-</th>
334
  <ti>
127
  <ti>
335
    Contains no stages, no Portage snapshot, no prebuilt packages and is
128
    Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
336
    therefore not suitable for networkless installation
129
    therefore not suitable for networkless installation
337
  </ti>
130
  </ti>
338
</tr>
131
</tr>
Lines 388-394 Link Here
388
181
389
<p>
182
<p>
390
If you intend to use the Packages CD to quickly install additional software,
183
If you intend to use the Packages CD to quickly install additional software,
391
make sure that you use the same subarchitecture as the stage-3 tarball you use.
184
make sure that you use the same subarchitecture as the stage3 tarball you use.
185
</p>
186
187
</body>
188
</subsection>
189
<subsection>
190
<title>The Stage3 Tarball</title>
191
<body>
192
193
<p>
194
A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
195
to continue the Gentoo installation using the instructions in this manual.
196
Previously, the Gentoo Handbook described the installation using one of three 
197
stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 
198
official installation method uses the stage3 tarball. If you are interested in
199
performing a Gentoo installation using a stage1 or stage2 tarball, please read
200
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
201
Using a Stage1 or Stage2 Tarball?</uri>
392
</p>
202
</p>
393
203
394
</body>
204
</body>
(-)handbook/index.xml (-11 / +4 lines)
Lines 290-298 Link Here
290
<p>
290
<p>
291
By not separating the instructions for each possible option, the user can view
291
By not separating the instructions for each possible option, the user can view
292
the results of the other choices easily. This provides a <b>better view on the
292
the results of the other choices easily. This provides a <b>better view on the
293
installation instructions</b> for the user: even though they chose - for 
293
installation instructions</b> for the user.
294
instance - stage3, they are easily informed about what stage2 or stage1 does. 
295
Not hiding these instructions is a good thing.
296
</p>
294
</p>
297
295
298
</body>
296
</body>
Lines 302-315 Link Here
302
<body>
300
<body>
303
301
304
<p>
302
<p>
305
You are reading the wrong Gentoo Handbook.
303
Instructions on using a stage1 or stage2 tarball are now available in the <uri
306
</p>
304
link="/doc/en/faq.xml#stage12">Gentoo FAQ</uri>. A stage3 installation is the
307
305
only supported installation as of now.
308
<p>
309
The release-specific Gentoo Handbooks (such as the 2005.0 one) are meant for
310
networkless installations only. Running a stage1 or stage2 installation requires
311
source code that isn't available on the universal installation CD, so you would
312
need a working Internet connection to do a stage1 or stage2 installation.
313
</p>
306
</p>
314
307
315
</body>
308
</body>
(-)handbook/2005.1/hb-install-alpha-medium.xml (-26 / +6 lines)
Lines 64-98 Link Here
64
<body>
64
<body>
65
65
66
<p>
66
<p>
67
Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
67
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
68
A stage file is a tarball (compressed archive) that contains a minimal
68
Such a tarball is an archive that contains a minimal environment from
69
environment.
69
which you can succesfully install Gentoo Linux onto your system.
70
</p>
70
</p>
71
71
72
<ul>
73
  <li>
74
     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
75
     software management system) and a couple of packages on which the compiler
76
     or Portage depends.
77
   </li>
78
   <li>
79
     A stage2 file contains a so-called bootstrapped system, a minimal
80
     environment from which one can start building all other necessary
81
     applications that make a Gentoo environment complete.
82
   </li>
83
   <li>
84
     A stage3 file contains a prebuilt minimal system which is almost fully
85
     deployable. It only lacks a few applications where you, the Gentoo user,
86
     needs to choose which one you want to install.
87
   </li>
88
</ul>
89
90
<p>
72
<p>
91
We will opt for a stage3 installation throughout this document. If you want to
73
Installations using a stage1 or stage2 tarball file are not documented in the
92
perform a Gentoo installation using the stage1 or stage2 files, please use the
74
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
93
installation instructions in the <uri
75
FAQ</uri> on these matters.
94
link="/doc/en/handbook/handbook-alpha.xml">Gentoo Handbook</uri>. They do
95
require a working Internet connection though.
96
</p>
76
</p>
97
77
98
</body>
78
</body>
(-)handbook/2005.1/hb-install-amd64-medium.xml (-26 / +6 lines)
Lines 64-98 Link Here
64
<body>
64
<body>
65
65
66
<p>
66
<p>
67
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
67
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
68
stage file is a tarball (compressed archive) that contains a minimal
68
Such a tarball is an archive that contains a minimal environment from
69
environment.
69
which you can succesfully install Gentoo Linux onto your system.
70
</p>
70
</p>
71
71
72
<ul>
73
  <li>
74
    A stage1 file contains nothing more than a compiler, Portage (Gentoo's
75
    software management system) and a couple of packages on which the 
76
    compiler or Portage depends. 
77
  </li>
78
  <li>
79
    A stage2 file contains a so-called bootstrapped system, a minimal
80
    environment from which one can start building all other necessary 
81
    applications that make a Gentoo environment complete.
82
  </li>
83
  <li>
84
    A stage3 file contains a prebuilt minimal system which is almost fully
85
    deployable. It only lacks a few applications where you, the Gentoo user, 
86
    needs to choose which one you want to install.
87
  </li>
88
</ul>
89
90
<p>
72
<p>
91
We will opt for a stage3 installation throughout this document. If you want to
73
Installations using a stage1 or stage2 tarball file are not documented in the
92
perform a Gentoo installation using the stage1 or stage2 files, please use the
74
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
93
installation instructions in the <uri
75
FAQ</uri> on these matters.
94
link="/doc/en/handbook/handbook-amd64.xml">Gentoo Handbook</uri>. They do
95
require a working Internet connection though.
96
</p>
76
</p>
97
77
98
</body>
78
</body>
(-)handbook/2005.1/hb-install-hppa-medium.xml (-26 / +6 lines)
Lines 62-96 Link Here
62
<body>
62
<body>
63
63
64
<p>
64
<p>
65
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
65
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
66
stage file is a tarball (compressed archive) that contains a minimal
66
Such a tarball is an archive that contains a minimal environment from
67
environment.
67
which you can succesfully install Gentoo Linux onto your system.
68
</p>
68
</p>
69
69
70
<ul>
71
  <li>
72
    A stage1 file contains nothing more than a compiler, Portage (Gentoo's
73
    software management system) and a couple of packages on which the 
74
    compiler or Portage depends. 
75
  </li>
76
  <li>
77
    A stage2 file contains a so-called bootstrapped system, a minimal
78
    environment from which one can start building all other necessary 
79
    applications that make a Gentoo environment complete.
80
  </li>
81
  <li>
82
    A stage3 file contains a prebuilt minimal system which is almost fully
83
    deployable. It only lacks a few applications where you, the Gentoo user, 
84
    needs to choose which one you want to install.
85
  </li>
86
</ul>
87
88
<p>
70
<p>
89
We will opt for a stage3 installation throughout this document. If you want to
71
Installations using a stage1 or stage2 tarball file are not documented in the
90
perform a Gentoo installation using the stage1 or stage2 files, please use the
72
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
91
installation instructions in the <uri
73
FAQ</uri> on these matters.
92
link="/doc/en/handbook/handbook-hppa.xml">Gentoo Handbook</uri>. They do
93
require a working Internet connection though.
94
</p>
74
</p>
95
75
96
</body>
76
</body>
(-)handbook/2005.1/hb-install-ppc-medium.xml (-26 / +6 lines)
Lines 87-121 Link Here
87
<body>
87
<body>
88
88
89
<p>
89
<p>
90
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
90
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
91
stage file is a tarball (compressed archive) that contains a minimal
91
Such a tarball is an archive that contains a minimal environment from
92
environment.
92
which you can succesfully install Gentoo Linux onto your system.
93
</p>
93
</p>
94
94
95
<ul>
96
  <li>
97
    A stage1 file contains nothing more than a compiler, Portage (Gentoo's
98
    software management system) and a couple of packages on which the 
99
    compiler or Portage depends. 
100
  </li>
101
  <li>
102
    A stage2 file contains a so-called bootstrapped system, a minimal
103
    environment from which one can start building all other necessary 
104
    applications that make a Gentoo environment complete.
105
  </li>
106
  <li>
107
    A stage3 file contains a prebuilt minimal system which is almost fully
108
    deployable. It only lacks a few applications where you, the Gentoo user, 
109
    needs to choose which one you want to install.
110
  </li>
111
</ul>
112
113
<p>
95
<p>
114
We will opt for a stage3 installation throughout this document. If you want to
96
Installations using a stage1 or stage2 tarball file are not documented in the
115
perform a Gentoo installation using the stage1 or stage2 files, please use the
97
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
116
installation instructions in the <uri
98
FAQ</uri> on these matters.
117
link="/doc/en/handbook/handbook-ppc.xml">Gentoo Handbook</uri>. They do
118
require a working Internet connection though.
119
</p>
99
</p>
120
100
121
</body>
101
</body>
(-)handbook/2005.1/hb-install-ppc64-medium.xml (-32 / +6 lines)
Lines 70-110 Link Here
70
<body>
70
<body>
71
71
72
<p>
72
<p>
73
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
73
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
74
stage file is a tarball (compressed archive) that contains a minimal
74
Such a tarball is an archive that contains a minimal environment from
75
environment.
75
which you can succesfully install Gentoo Linux onto your system.
76
</p>
76
</p>
77
77
78
<p>
78
<p>
79
The Gentoo/PPC64 team provides you with additional options at this point.
79
Installations using a stage1 or stage2 tarball file are not documented in the
80
You have the choice to use a 32bit or a 64bit userland; a full set of stages
80
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
81
is provided for both options.
81
FAQ</uri> on these matters.
82
</p>
83
84
<ul>
85
  <li>
86
    A stage1 file contains nothing more than a compiler, Portage (Gentoo's
87
    software management system) and a couple of packages on which the
88
    compiler or Portage depends.
89
  </li>
90
  <li>
91
    A stage2 file contains a so-called bootstrapped system, a minimal
92
    environment from which one can start building all other necessary
93
    applications that make a Gentoo environment complete.
94
  </li>
95
  <li>
96
    A stage3 file contains a prebuilt minimal system which is almost fully
97
    deployable. It only lacks a few applications where you, the Gentoo user,
98
    needs to choose which one you want to install.
99
  </li>
100
</ul>
101
102
<p>
103
We will opt for a stage3 installation throughout this document. If you want to
104
perform a Gentoo installation using the stage1 or stage2 files, please use the
105
installation instructions in the <uri
106
link="/doc/en/handbook/handbook-ppc64.xml">Gentoo Handbook</uri>. They do
107
require a working Internet connection though.
108
</p>
82
</p>
109
83
110
</body>
84
</body>
(-)handbook/2005.1/hb-install-sparc-medium.xml (-26 / +6 lines)
Lines 77-111 Link Here
77
<body>
77
<body>
78
78
79
<p>
79
<p>
80
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
80
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
81
stage file is a tarball (compressed archive) that contains a minimal
81
Such a tarball is an archive that contains a minimal environment from
82
environment.
82
which you can succesfully install Gentoo Linux onto your system.
83
</p>
83
</p>
84
84
85
<ul>
86
  <li>
87
    A stage1 file contains nothing more than a compiler, Portage (Gentoo's
88
    software management system) and a couple of packages on which the 
89
    compiler or Portage depends. 
90
  </li>
91
  <li>
92
    A stage2 file contains a so-called bootstrapped system, a minimal
93
    environment from which one can start building all other necessary 
94
    applications that make a Gentoo environment complete.
95
  </li>
96
  <li>
97
    A stage3 file contains a prebuilt minimal system which is almost fully
98
    deployable. It only lacks a few applications where you, the Gentoo user, 
99
    needs to choose which one you want to install.
100
  </li>
101
</ul>
102
103
<p>
85
<p>
104
We will opt for a stage3 installation throughout this document. If you want to
86
Installations using a stage1 or stage2 tarball file are not documented in the
105
perform a Gentoo installation using the stage1 or stage2 files, please use the
87
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
106
installation instructions in the <uri
88
FAQ</uri> on these matters.
107
link="/doc/en/handbook/handbook-sparc.xml">Gentoo Handbook</uri>. They do
108
require a working Internet connection though.
109
</p>
89
</p>
110
90
111
</body>
91
</body>
(-)handbook/2005.1/hb-install-stage.xml (-9 / +9 lines)
Lines 180-185 Link Here
180
</pre>
180
</pre>
181
181
182
<p>
182
<p>
183
Make sure you download a stage3 tarball - installations using a stage1 or stage2
184
tarball are not supported anymore.
185
</p>
186
187
<p>
183
If you want to check the integrity of the downloaded stage tarball, use
188
If you want to check the integrity of the downloaded stage tarball, use
184
<c>md5sum</c> and compare the output with the MD5 checksum provided on the
189
<c>md5sum</c> and compare the output with the MD5 checksum provided on the
185
mirror. For instance, to check the validity of the x86 stage tarball:
190
mirror. For instance, to check the validity of the x86 stage tarball:
Lines 346-361 Link Here
346
<title>CHOST</title>
351
<title>CHOST</title>
347
<body>
352
<body>
348
353
349
<warn>
350
Although it might be tempting for non-stage1 users, they should <e>not</e>
351
change the <c>CHOST</c> setting in <path>make.conf</path>. Doing so might render
352
their system unusable. Again: only change this variable if you use a
353
<e>stage1</e> installation.
354
</warn>
355
356
<p>
354
<p>
357
The networkless installation approach only supports stage3 installations. Do not
355
The <c>CHOST</c> variable declares the target build host for your system. This
358
touch the <e>CHOST</e> variable!
356
variable should already be set to the correct value. <brite>Do not edit
357
it</brite> as that might break your system. If the <c>CHOST</c> variable does
358
not look correct to you, you might be using the wrong stage3 tarball.
359
</p>
359
</p>
360
360
361
</body>
361
</body>
(-)handbook/2005.1/hb-install-x86-medium.xml (-26 / +6 lines)
Lines 60-94 Link Here
60
<body>
60
<body>
61
61
62
<p>
62
<p>
63
Gentoo Linux can be installed using one of three <e>stage</e> tarball files. A
63
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
64
stage file is a tarball (compressed archive) that contains a minimal
64
Such a tarball is an archive that contains a minimal environment from
65
environment.
65
which you can succesfully install Gentoo Linux onto your system.
66
</p>
66
</p>
67
67
68
<ul>
69
  <li>
70
    A stage1 file contains nothing more than a compiler, Portage (Gentoo's
71
    software management system) and a couple of packages on which the 
72
    compiler or Portage depends. 
73
  </li>
74
  <li>
75
    A stage2 file contains a so-called bootstrapped system, a minimal
76
    environment from which one can start building all other necessary 
77
    applications that make a Gentoo environment complete.
78
  </li>
79
  <li>
80
    A stage3 file contains a prebuilt minimal system which is almost fully
81
    deployable. It only lacks a few applications where you, the Gentoo user, 
82
    needs to choose which one you want to install.
83
  </li>
84
</ul>
85
86
<p>
68
<p>
87
We will opt for a stage3 installation throughout this document. If you want to
69
Installations using a stage1 or stage2 tarball file are not documented in the
88
perform a Gentoo installation using the stage1 or stage2 files, please use the
70
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
89
installation instructions in the <uri
71
FAQ</uri> on these matters.
90
link="/doc/en/handbook/handbook-x86.xml">Gentoo Handbook</uri>. They do
91
require a working Internet connection though.
92
</p>
72
</p>
93
73
94
</body>
74
</body>

Return to bug 105809