en/handbook/handbook-hppa.xml

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.106 2004/11/02 11:44:39 swift Exp $ -->

<book link="handbook-hppa.xml">
<title>Gentoo Linux/HPPA Handbook</title>

<author title="Author">
  <mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
    <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
  <mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
  <mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
  <mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
  <mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author>
<author title="Gentoo Alpha Developer">
  <mail link="agriffis@gentoo.org">Aron Griffis</mail>
</author>
<author title="Gentoo AMD64 Developer">
  <mail link="jhuebel@gentoo.org">Jason Huebel</mail>
</author>
<author title="Gentoo HPPA developer">
  <mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
   <mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
  <mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
    <mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">Pierre-Henri Jondot</author>
<author title="Editor">
    <mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
    <mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
    <mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
    <mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
    <mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
    <mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
    <mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
    <mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
    <mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
     <mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
  <mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
  <mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
  <mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
  <mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Editor">
  <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
</author>
<author title="Reviewer">
    <mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
    <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
    <mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
    <mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
   <mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>

<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
information.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
<license/>

<version>3.6</version>
<date>November 06, 2004</date>

<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>

<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that choice is what
Gentoo is all about. 
</abstract>
  <include href="hb-install-about.xml"/>
</chapter>

<chapter>
<title>Choosing the Right Installation Medium</title>
<abstract>
You can install Gentoo in many ways. You can use our LiveCD, an existing
distribution etc. 
</abstract>
  <include href="hb-install-hppa-medium.xml"/>
</chapter>

<chapter>
<title>Configuring your Network</title>
<abstract>
If you want to install Gentoo using the Internet, you need to set up
networking.
</abstract>
  <include href="hb-install-network.xml"/>
</chapter>

<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
  <include href="hb-install-hppa-disk.xml"/>
</chapter>

<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
Gentoo installs work through so-called stage-files. In this chapter we
describe how you extract a stage-file and configure Portage.
</abstract>
  <include href="hb-install-stage.xml"/>
</chapter>

<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
Independent of what stage you chose, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
  <include href="hb-install-system.xml"/>
</chapter>

<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
  <include href="hb-install-hppa-kernel.xml"/>
</chapter>

<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
  <include href="hb-install-config.xml"/>
</chapter>

<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
  <include href="hb-install-tools.xml"/>
</chapter>

<chapter>
<title>Configuring the Bootloader</title>
<abstract>
In this chapter we'll describe the PALO bootloader
and step you through the process of configuring PALO to your
needs.
</abstract>
  <include href="hb-install-hppa-bootloader.xml"/>
</chapter>

<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and (optionally) install prebuilt packages.
</abstract>
  <include href="hb-install-finalise.xml"/>
</chapter>

<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next? 
</abstract>
  <include href="hb-install-next.xml"/>
</chapter>
</part>

<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
Portage behaviour etc. 
</abstract>

<chapter>
<title>A Portage Introduction</title>
<abstract>
This chapter explains the "simple" steps a user definitely needs to know to
maintain the software on his system.
</abstract>
  <include href="hb-working-portage.xml"/>
</chapter>

<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
  <include href="hb-working-use.xml"/>
</chapter>

<chapter>
<title>Portage Features</title>
<abstract>
Discover the features Portage has, such as support for distributed compiling,
ccache and more.
</abstract>
  <include href="hb-working-features.xml"/>
</chapter>

<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
  <include href="hb-working-rcscripts.xml"/>
</chapter>

<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
  <include href="hb-working-variables.xml"/>
</chapter>
</part>

<part>
<title>Working with Portage</title>
<abstract>
"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
Software Management Tool.
</abstract>

<chapter>
<title>Files and Directories</title>
<abstract>
Once you want to know Portage in-depth you need to know where it stores its
files and data.
</abstract>
  <include href="hb-portage-files.xml"/>
</chapter>

<chapter>
<title>Configuring through Variables</title>
<abstract>
Portage is completely configurable through various variables you can set in the
configuration file or as environment variable.
</abstract>
  <include href="hb-portage-configuration.xml"/>
</chapter>

<chapter>
<title>Mixing Software Branches</title>
<abstract>
Gentoo provides software separated in several branches, depending on stability
and architectural support. "Mixing Software Branches" inform you how these
branches can be configured and how you can override this separation
individually.
</abstract>
  <include href="hb-portage-branches.xml"/>
</chapter>

<chapter>
<title>Additional Portage Tools</title>
<abstract>
Portage comes with a few extra tools that might make your Gentoo experience even
better. Read on to discover how to use dispatch-conf and other tools.
</abstract>
  <include href="hb-portage-tools.xml"/>
</chapter>

<chapter>
<title>Diverting from the Official Tree</title>
<abstract>
"Diverting from the Official Tree" gives you some tips and tricks on how to use
your own Portage tree, how to synchronise only the categories you want, inject
packages and more.
</abstract>
  <include href="hb-portage-diverttree.xml"/>
</chapter>

<chapter>
<title>The Ebuild Application</title>
<abstract>
In "The Ebuild Application" you are informed about the steps Portage takes while
installing software and how you can do this yourself using the ebuild
application.
</abstract>
  <include href="hb-portage-ebuild.xml"/>
</chapter>
</part>

</book>
1	neysx	1.1	<?xml version='1.0' encoding='UTF-8'?>
2			<!DOCTYPE book SYSTEM "/dtd/book.dtd">
3
4	swift	1.107	<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.106 2004/11/02 11:44:39 swift Exp $ -->
5	neysx	1.1
6			<book link="handbook-hppa.xml">
7			<title>Gentoo Linux/HPPA Handbook</title>
8
9	swift	1.96	<author title="Author">
10	swift	1.102	<mail link="swift@gentoo.org">Sven Vermeulen</mail>
11	neysx	1.1	</author>
12			<author title="Author">
13	swift	1.102	<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
14	neysx	1.1	</author>
15			<author title="Author">
16			<mail link="chouser@gentoo.org">Chris Houser</mail>
17			</author>
18			<author title="Author">
19			<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
20			</author>
21			<author title="Gentoo x86 Developer">
22			<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
23			</author>
24			<author title="Gentoo Alpha Developer">
25			<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
26			</author>
27			<author title="Gentoo Alpha Developer">
28			<mail link="agriffis@gentoo.org">Aron Griffis</mail>
29			</author>
30			<author title="Gentoo AMD64 Developer">
31	dertobi123	1.44	<mail link="jhuebel@gentoo.org">Jason Huebel</mail>
32	neysx	1.1	</author>
33			<author title="Gentoo HPPA developer">
34			<mail link="gmsoft@gentoo.org">Guy Martin</mail>
35			</author>
36			<author title="Gentoo PPC developer">
37			<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
38			</author>
39			<author title="Gentoo SPARC developer">
40			<mail link="blademan@gentoo.org">Joe Kallar</mail>
41			</author>
42			<author title="Editor">
43			<mail link="zhen@gentoo.org">John P. Davis</mail>
44			</author>
45			<author title="Editor">Pierre-Henri Jondot</author>
46			<author title="Editor">
47			<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
48			</author>
49			<author title="Editor">
50			<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
51			</author>
52			<author title="Editor">
53			<mail link="seo@gentoo.org">Jungmin Seo</mail>
54			</author>
55			<author title="Editor">
56			<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
57			</author>
58			<author title="Editor">
59			<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
60			</author>
61			<author title="Editor">
62			<mail link="peitolm@gentoo.org">Colin Morey</mail>
63			</author>
64			<author title="Editor">
65			<mail link="peesh@gentoo.org">Jorge Paulo</mail>
66			</author>
67			<author title="Editor">
68			<mail link="carl@gentoo.org">Carl Anderson</mail>
69			</author>
70			<author title="Editor">
71			<mail link="avenj@gentoo.org">Jon Portnoy</mail>
72			</author>
73			<author title="Editor">
74			<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
75			</author>
76			<author title="Editor">
77			<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
78			</author>
79			<author title="Editor">
80			<mail link="bennyc@gentoo.org">Benny Chuang</mail>
81			</author>
82			<author title="Editor">
83			<mail link="erwin@gentoo.org">Erwin</mail>
84			</author>
85			<author title="Editor">
86			<mail link="kumba@gentoo.org">Joshua Kinard</mail>
87			</author>
88	dertobi123	1.44	<author title="Editor">
89			<mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail>
90			</author>
91	neysx	1.1	<author title="Reviewer">
92			<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
93			</author>
94			<author title="Reviewer">
95			<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
96			</author>
97			<author title="Reviewer">
98			<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
99			</author>
100			<author title="Reviewer">
101			<mail link="antifa@gentoo.org">Ken Nowack</mail>
102			</author>
103			<author title="Contributor">
104			<mail link="pylon@gentoo.org">Lars Weiler</mail>
105			</author>
106
107			<abstract>
108			This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
109			information.
110			</abstract>
111
112			<!-- The content of this document is licensed under the CC-BY-SA license -->
113	swift	1.100	<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
114	neysx	1.1	<license/>
115
116	swift	1.107	<version>3.6</version>
117			<date>November 06, 2004</date>
118	neysx	1.1
119			<part>
120			<title>Installing Gentoo</title>
121			<abstract>
122			In this part you learn how to install Gentoo on your system.
123			</abstract>
124
125			<chapter>
126			<title>About the Gentoo Linux Installation</title>
127			<abstract>
128			Users not familiar with Gentoo do not always know that choice is what
129			Gentoo is all about.
130			</abstract>
131			<include href="hb-install-about.xml"/>
132			</chapter>
133
134			<chapter>
135			<title>Choosing the Right Installation Medium</title>
136			<abstract>
137			You can install Gentoo in many ways. You can use our LiveCD, an existing
138			distribution etc.
139			</abstract>
140			<include href="hb-install-hppa-medium.xml"/>
141			</chapter>
142
143			<chapter>
144			<title>Configuring your Network</title>
145			<abstract>
146	swift	1.103	If you want to install Gentoo using the Internet, you need to set up
147	neysx	1.1	networking.
148			</abstract>
149			<include href="hb-install-network.xml"/>
150			</chapter>
151
152			<chapter>
153			<title>Preparing the Disks</title>
154			<abstract>
155			To be able to install Gentoo, you must create the necessary partitions.
156			This chapter describes how to partition a disk for future usage.
157			</abstract>
158			<include href="hb-install-hppa-disk.xml"/>
159			</chapter>
160
161			<chapter>
162			<title>Installing the Gentoo Installation Files</title>
163			<abstract>
164	neysx	1.41	Gentoo installs work through so-called stage-files. In this chapter we
165	neysx	1.1	describe how you extract a stage-file and configure Portage.
166			</abstract>
167			<include href="hb-install-stage.xml"/>
168			</chapter>
169
170			<chapter>
171			<title>Installing the Gentoo Base System</title>
172			<abstract>
173			Independent of what stage you chose, the eventual result is that you
174			have a Gentoo base system at your disposal. This chapter describes how
175			to progress to that stadium.
176			</abstract>
177			<include href="hb-install-system.xml"/>
178			</chapter>
179
180			<chapter>
181			<title>Configuring the Kernel</title>
182			<abstract>
183			The Linux kernel is the core of every distribution. This chapter
184			explains how to configure your kernel.
185			</abstract>
186			<include href="hb-install-hppa-kernel.xml"/>
187			</chapter>
188
189			<chapter>
190			<title>Configuring your System</title>
191			<abstract>
192			You need to edit some important configuration files. In this chapter
193			you receive an overview of these files and an explanation on how to
194			proceed.
195			</abstract>
196			<include href="hb-install-config.xml"/>
197			</chapter>
198
199			<chapter>
200	swift	1.65	<title>Installing Necessary System Tools</title>
201			<abstract>
202			As mentioned before, Gentoo is about choices. In this chapter we help you
203			choose and install some important tools.
204			</abstract>
205			<include href="hb-install-tools.xml"/>
206			</chapter>
207
208			<chapter>
209	neysx	1.1	<title>Configuring the Bootloader</title>
210			<abstract>
211	swift	1.3	In this chapter we'll describe the PALO bootloader
212			and step you through the process of configuring PALO to your
213	neysx	1.1	needs.
214			</abstract>
215			<include href="hb-install-hppa-bootloader.xml"/>
216			</chapter>
217
218			<chapter>
219			<title>Finalizing your Gentoo Installation</title>
220			<abstract>
221			You're almost done. We'll just create one (or more) users for your
222	swift	1.65	system and (optionally) install prebuilt packages.
223	neysx	1.1	</abstract>
224			<include href="hb-install-finalise.xml"/>
225			</chapter>
226
227			<chapter>
228			<title>Where to go from here?</title>
229			<abstract>
230			Now you have your Gentoo system, but what's next?
231			</abstract>
232			<include href="hb-install-next.xml"/>
233			</chapter>
234			</part>
235
236			<part>
237			<title>Working with Gentoo</title>
238			<abstract>
239			Learn how to work with Gentoo: installing software, altering variables, changing
240	swift	1.101	Portage behaviour etc.
241	neysx	1.1	</abstract>
242
243			<chapter>
244	swift	1.100	<title>A Portage Introduction</title>
245	neysx	1.1	<abstract>
246	swift	1.100	This chapter explains the "simple" steps a user definitely needs to know to
247			maintain the software on his system.
248	neysx	1.1	</abstract>
249	swift	1.100	<include href="hb-working-portage.xml"/>
250	neysx	1.1	</chapter>
251
252			<chapter>
253	swift	1.100	<title>USE flags</title>
254	neysx	1.1	<abstract>
255	swift	1.100	USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
256			work with USE-flags and understand how USE-flags interact with your system.
257	neysx	1.1	</abstract>
258	swift	1.100	<include href="hb-working-use.xml"/>
259	neysx	1.1	</chapter>
260
261			<chapter>
262			<title>Portage Features</title>
263			<abstract>
264	swift	1.100	Discover the features Portage has, such as support for distributed compiling,
265			ccache and more.
266	neysx	1.1	</abstract>
267			<include href="hb-working-features.xml"/>
268			</chapter>
269
270			<chapter>
271			<title>Initscripts</title>
272			<abstract>
273			Gentoo uses a special initscript format which, amongst other features, allows
274			dependency-driven decisions and virtual initscripts. This chapter explains all
275			these aspects and explains how to deal with these scripts.
276			</abstract>
277			<include href="hb-working-rcscripts.xml"/>
278			</chapter>
279
280			<chapter>
281			<title>Environment Variables</title>
282			<abstract>
283			With Gentoo you can easily manage the environment variables for your system.
284			This chapter explains how you do that, and also describes frequently used
285			variables.
286			</abstract>
287			<include href="hb-working-variables.xml"/>
288			</chapter>
289			</part>
290
291	swift	1.100	<part>
292			<title>Working with Portage</title>
293			<abstract>
294			"Working with Portage" provides an in-depth coverage of Portage, Gentoo's
295			Software Management Tool.
296			</abstract>
297
298			<chapter>
299			<title>Files and Directories</title>
300			<abstract>
301	swift	1.102	Once you want to know Portage in-depth you need to know where it stores its
302	swift	1.100	files and data.
303			</abstract>
304			<include href="hb-portage-files.xml"/>
305			</chapter>
306
307			<chapter>
308			<title>Configuring through Variables</title>
309			<abstract>
310			Portage is completely configurable through various variables you can set in the
311			configuration file or as environment variable.
312			</abstract>
313			<include href="hb-portage-configuration.xml"/>
314			</chapter>
315
316			<chapter>
317			<title>Mixing Software Branches</title>
318			<abstract>
319			Gentoo provides software separated in several branches, depending on stability
320			and architectural support. "Mixing Software Branches" inform you how these
321			branches can be configured and how you can override this separation
322			individually.
323			</abstract>
324			<include href="hb-portage-branches.xml"/>
325			</chapter>
326
327			<chapter>
328			<title>Additional Portage Tools</title>
329			<abstract>
330			Portage comes with a few extra tools that might make your Gentoo experience even
331			better. Read on to discover how to use dispatch-conf and other tools.
332			</abstract>
333			<include href="hb-portage-tools.xml"/>
334			</chapter>
335
336			<chapter>
337			<title>Diverting from the Official Tree</title>
338			<abstract>
339			"Diverting from the Official Tree" gives you some tips and tricks on how to use
340			your own Portage tree, how to synchronise only the categories you want, inject
341			packages and more.
342			</abstract>
343			<include href="hb-portage-diverttree.xml"/>
344			</chapter>
345
346			<chapter>
347			<title>The Ebuild Application</title>
348			<abstract>
349			In "The Ebuild Application" you are informed about the steps Portage takes while
350			installing software and how you can do this yourself using the ebuild
351			application.
352			</abstract>
353			<include href="hb-portage-ebuild.xml"/>
354			</chapter>
355			</part>
356
357	neysx	1.1	</book>