* [gentoo-doc-cvs] cvs commit: handbook-amd64.xml handbook-x86.xml hb-install-amd64-medium.xml hb-install-gli-medium.xml hb-install-x86-medium.xml
@ 2006-08-12 22:15 Xavier Neys
0 siblings, 0 replies; only message in thread
From: Xavier Neys @ 2006-08-12 22:15 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 06/08/12 22:15:11
Modified: handbook-amd64.xml handbook-x86.xml
Added: hb-install-gli-medium.xml
Removed: hb-install-amd64-medium.xml
hb-install-x86-medium.xml
Log:
No point keeping two ~identical files
Revision Changes Path
1.3 xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml?r1=1.2&r2=1.3
Index: handbook-amd64.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-amd64.xml 12 Aug 2006 21:17:06 -0000 1.2
+++ handbook-amd64.xml 12 Aug 2006 22:15:11 -0000 1.3
@@ -1,10 +1,16 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml,v 1.2 2006/08/12 21:17:06 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml,v 1.3 2006/08/12 22:15:11 neysx Exp $ -->
-<book link="/doc/en/handbook/2006.1/handbook-x86.xml">
-<title>Gentoo Linux 2006.1 x86 Handbook</title>
+<book link="/doc/en/handbook/2006.1/handbook-amd64.xml">
+<title>Gentoo Linux 2006.1 AMD64 Handbook</title>
+
+<values>
+ <key id="arch">AMD64</key>
+ <key id="release-dir">releases/amd64/2006.1/</key>
+ <key id="online-book">2006.1/handbook-amd64.xml</key>
+</values>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
@@ -142,7 +148,7 @@
<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.
+Gentoo is all about.
</abstract>
<include href="hb-installer-about.xml"/>
</chapter>
@@ -153,7 +159,7 @@
Using our Installer LiveCD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
- <include href="hb-install-amd64-medium.xml"/>
+ <include href="hb-install-gli-medium.xml"/>
</chapter>
<chapter>
@@ -179,7 +185,7 @@
<chapter>
<title>Where to go from here?</title>
<abstract>
-Now you have your Gentoo system, but what's next?
+Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
@@ -188,8 +194,8 @@
<part>
<title>Working with Gentoo</title>
<abstract>
-Learn how to work with Gentoo: installing software, altering variables, changing
-Portage behaviour etc.
+Learn how to work with Gentoo: installing software, altering variables,
+changing Portage behaviour etc.
</abstract>
<chapter>
1.3 xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml?r1=1.2&r2=1.3
Index: handbook-x86.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- handbook-x86.xml 12 Aug 2006 21:18:03 -0000 1.2
+++ handbook-x86.xml 12 Aug 2006 22:15:11 -0000 1.3
@@ -1,11 +1,17 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml,v 1.2 2006/08/12 21:18:03 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml,v 1.3 2006/08/12 22:15:11 neysx Exp $ -->
<book link="/doc/en/handbook/2006.1/handbook-x86.xml">
<title>Gentoo Linux 2006.1 x86 Handbook</title>
+<values>
+ <key id="arch">x86</key>
+ <key id="release-dir">releases/x86/2006.1/</key>
+ <key id="online-book">2006.1/handbook-x86.xml</key>
+</values>
+
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
@@ -140,7 +146,7 @@
<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.
+Gentoo is all about.
</abstract>
<include href="hb-installer-about.xml"/>
</chapter>
@@ -151,7 +157,7 @@
Using our Installer LiveCD you can boot up your system into a running
environment that allows you to install Gentoo.
</abstract>
- <include href="hb-install-x86-medium.xml"/>
+ <include href="hb-install-gli-medium.xml"/>
</chapter>
<chapter>
@@ -177,7 +183,7 @@
<chapter>
<title>Where to go from here?</title>
<abstract>
-Now you have your Gentoo system, but what's next?
+Now you have your Gentoo system, but what's next?
</abstract>
<include href="hb-install-next.xml"/>
</chapter>
@@ -186,8 +192,8 @@
<part>
<title>Working with Gentoo</title>
<abstract>
-Learn how to work with Gentoo: installing software, altering variables, changing
-Portage behaviour etc.
+Learn how to work with Gentoo: installing software, altering variables,
+changing Portage behaviour etc.
</abstract>
<chapter>
1.1 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-medium.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-medium.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-medium.xml?rev=1.1&content-type=text/plain
Index: hb-install-gli-medium.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-medium.xml,v 1.1 2006/08/12 22:15:11 neysx Exp $ -->
<sections>
<version>6.0</version>
<date>2006-08-12</date>
<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box using the Installer LiveCD.
</p>
</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>
<table>
<tr test="func:keyval('arch')='x86'">
<th>CPU</th>
<ti>i686 or later</ti>
</tr>
<tr test="func:keyval('arch')='AMD64'">
<th>CPU</th>
<ti>Any AMD64 or EM64T CPU</ti>
</tr>
<tr>
<th>Memory</th>
<ti>128 MB</ti>
</tr>
<tr>
<th>Diskspace</th>
<ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
<th>Swap space</th>
<ti>At least 256 MB</ti>
</tr>
</table>
</body>
</subsection>
</section>
<!-- General description, propagated to other architectures as well -->
<!-- START -->
<section>
<title>The Gentoo Linux Installer LiveCD</title>
<subsection>
<title>Introduction</title>
<body>
<p>
Gentoo Linux can be installed using a <e>stage3</e> tarball file.
Such a tarball is an archive that contains a minimal environment from
which you can successfully install Gentoo Linux onto your system.
</p>
<p>
Installations using a stage1 or stage2 tarball file are not documented in the
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
FAQ</uri> on these matters.
</p>
</body>
</subsection>
<subsection>
<title>Gentoo Linux Installer LiveCD</title>
<body>
<p>
A LiveCD is a bootable medium which contains a self-sustained Gentoo
environment. It allows you to boot Linux from the CD. During the boot process
your hardware is detected and the appropriate drivers are loaded. The Gentoo
Installation CDs are maintained by Gentoo developers.
</p>
<p>
There currently are two Installation CDs available:
</p>
<ul>
<li>
The Installer LiveCD contains everything you need to install Gentoo. It
provides a graphical environment, a graphical as well as console based
installer which automatically carries out the installation for you, and of
course, the installation instructions for your architecture.
</li>
<li>
The Minimal Installation CD contains only a minimal environment that allows
you to boot up and configure your network so you can connect to the
Internet. It does not contain any additional files and cannot be used
during the current installation approach.
</li>
</ul>
</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot the Gentoo Linux Installer LiveCD</title>
<subsection>
<title>Downloading and Burning the Installer LiveCD</title>
<body>
<p>
You can download the Installer LiveCDs from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. They are located in the
<path><keyval id="release-dir"/>/livecd</path> directory.
</p>
<p>
Inside that directory you'll find an ISO-file. That is a full CD image which
you can write on a CD-R.
</p>
<p>
After downloading the file, you can verify its integrity to see if it is
corrupted or not:
</p>
<ul>
<li>
You can check its MD5 checksum and compare it with the MD5 checksum we
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or <uri
link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
</li>
<li>
You can verify the cryptographic signature that we provide. You need to
obtain the public key we use (17072058) before you proceed though.
</li>
</ul>
<p>
To fetch our public key using the GnuPG application, run the following command:
</p>
<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
</pre>
<p>
Now verify the signature:
</p>
<pre caption="Verify the cryptographic signature">
$ <i>gpg --verify <signature file> <downloaded iso></i>
</pre>
<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you do this
is highly program-dependent. We will discuss <c>cdrecord</c> and <c>K3B</c>
here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>
<ul>
<li>
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
path).
</li>
<li>
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
you can locate your ISO file within the 'Image to Burn' area. Finally click
<c>Start</c>.
</li>
</ul>
</body>
</subsection>
<subsection>
<title>Booting the Installer LiveCD</title>
<body>
<impo>
Read this whole subsection before continuing, as you will probably not have the
opportunity to read it before doing things later.
</impo>
<p>
Once you have burned your LiveCD, it is time to boot it. Remove all CDs from
your CD drives, reboot your system and enter the BIOS. This is usually done by
hitting DEL, F1 or ESC, depending on your BIOS. Inside the BIOS, change the
boot order so that the CD-ROM is tried before the hard disk. This is often
found under "CMOS Setup". If you don't do this, your system will just reboot
from the hard disk, ignoring the CD-ROM.
</p>
<p>
Now place the LiveCD in the CD-ROM drive and reboot. You should see a boot
prompt. At this screen, you can hit Enter to begin the boot process with the
default boot options, or boot the LiveCD with custom boot options by specifying
a kernel followed by boot options and then hitting Enter.
</p>
<p>
Specifying a kernel? Yes, we provide several kernels on our LiveCD. The default
one is <c>gentoo</c>. Other kernels are for specific hardware needs and the
<c>-nofb</c> variants which disable framebuffer.
</p>
<p>
Below you'll find a short overview on the available kernels:
</p>
<table>
<tr>
<th>Kernel</th>
<th>Description</th>
</tr>
<tr test="func:keyval('arch')='x86'">
<ti>gentoo</ti>
<ti>Default 2.6 kernel with support for multiple CPUs</ti>
</tr>
<tr test="func:keyval('arch')='x86'">
<ti>gentoo-nofb</ti>
<ti>Same as <c>gentoo</c> but without framebuffer support</ti>
</tr>
<tr test="func:keyval('arch')='AMD64'">
<ti>gentoo</ti>
<ti>
Default kernel with support for K8 CPUS (including NUMA support) and EM64T
CPUs
</ti>
</tr>
<tr>
<ti>memtest86</ti>
<ti>Test your local RAM for errors</ti>
</tr>
</table>
<p>
You can also provide kernel options. They represent optional settings you can
(de)activate at will. The following list is the same as the one you receive
when you press F2 through F7 at the bootscreen.
</p>
<pre caption="Options available to pass to your kernel of choice">
<comment>Hardware options:</comment>
acpi=on This loads support for ACPI and also causes the acpid daemon to
be started by the CD on boot. This is only needed if your
system requires ACPI to function properly. This is not
required for Hyperthreading support.
acpi=off Completely disables ACPI. This is useful on some older
systems, and is also a requirement for using APM. This will
disable any Hyperthreading support of your processor.
console=X This sets up serial console access for the CD. The first
option is the device, usually ttyS0 on x86, followed by any
connection options, which are comma separated. The default
options are 9600,8,n,1.
dmraid=X This allows for passing options to the device-mapper RAID
subsystem. Options should be encapsulated in quotes.
doapm This loads APM driver support. This requires you to also use
acpi=off.
dobladecenter This adds some extra pauses into the boot process for the slow
USB CDROM of the IBM BladeCenter.
dopcmcia This loads support for PCMCIA and Cardbus hardware and also
causes the pcmcia cardmgr to be started by the CD on boot.
This is only required when booting from a PCMCIA/Cardbus device.
doscsi This loads support for most SCSI controllers. This is also a
requirement for booting most USB devices, as they use the SCSI
subsystem of the kernel.
hda=stroke This allows you to partition the whole hard disk even when your
BIOS is unable to handle large disks. This option is only used
on machines with an older BIOS. Replace hda with the device
that is requiring this option.
ide=nodma This forces the disabling of DMA in the kernel and is required
by some IDE chipsets and also by some CDROM drives. If your
system is having trouble reading from your IDE CDROM, try this
option. This also disables the default hdparm settings from
being executed.
noapic This disables the Advanced Programmable Interrupt Controller
that is present on newer motherboards. It has been known to
cause some problems on older hardware.
nodetect This disables all of the autodetection done by the CD,
including device autodetection and DHCP probing. This is
useful for doing debugging of a failing CD or driver.
nodhcp This disables DHCP probing on detected network cards. This is
useful on networks with only static addresses.
nodmraid Disables support for device-mapper RAID, such as that used for
on-board IDE/SATA RAID controllers.
nofirewire This disables the loading of Firewire modules. This should only
be necessary if your Firewire hardware is causing a problem
with booting the CD.
nogpm This disables gpm console mouse support.
nohotplug This disables the loading of the hotplug and coldplug init
scripts at boot. This is useful for doing debugging of a
failing CD or driver.
nokeymap This disables the keymap selection used to select non-US
keyboard layouts.
nolapic This disables the local APIC on Uniprocessor kernels.
nosata This disables the loading of Serial ATA modules. This is
useful if your system is having problems with the SATA subsystem.
nosmp This disables SMP, or Symmetric Multiprocessing, on SMP-enabled
kernels. This is useful for debugging SMP-related issues with
certain drivers and motherboards.
nosound This disables sound support and volume setting. This is useful
for systems where sound support causes problems.
nousb This disables the autoloading of USB modules. This is useful
for debugging USB issues.
<comment>Volume/Device Management:</comment>
dodevfs This enables the deprecated device filesystem on 2.6 systems.
You will also need to use noudev for this to take effect.
Since devfs is the only option with a 2.4 kernel, this option
has no effect if booting a 2.4 kernel.
doevms2 This enables support for IBM's pluggable EVMS, or Enterprise
Volume Management System. This is not safe to use with lvm2.
dolvm2 This enables support for Linux's Logical Volume Management.
This is not safe to use with evms2.
noudev This disables udev support on 2.6 kernels. This option
requires that dodevfs is used. Since udev is not an option for
2.4 kernels, this options has no effect if booting a 2.4
kernel.
unionfs Enables support for Unionfs on supported CD images. This will
create a writable Unionfs overlay in a tmpfs, allowing you to
change any file on the CD.
unionfs=X Enables support for Unionfs on supported CD images. This will
create a writable Unionfs overlay on the device you specify.
The device must be formatted with a filesystem recognized and
writable by the kernel.
<comment>Other options:</comment>
debug Enables debugging code. This might get messy, as it displays
a lot of data to the screen.
docache This caches the entire runtime portion of the CD into RAM,
which allows you to umount /mnt/cdrom and mount another CDROM.
This option requires that you have at least twice as much
available RAM as the size of the CD.
doload=X This causes the initial ramdisk to load any module listed, as
well as dependencies. Replace X with the module name. Multiple
modules can be specified by a comma-separated list.
noload=X This causes the initial ramdisk to skip the loading of a
specific module that may be causing a problem. Syntax matches
that of doload.
nox This causes an X-enabled LiveCD to not automatically start X,
but rather, to drop to the command line instead.
scandelay This causes the CD to pause for 10 seconds during certain
portions the boot process to allow for devices that are slow to
initialize to be ready for use.
scandelay=X This allows you to specify a given delay, in seconds, to be
added to certain portions of the boot process to allow for
devices that are slow to initialize to be ready for use.
Replace X with the number of seconds to pause.
</pre>
<p>
Now boot your CD, select a kernel (if you are not happy with the default
<c>gentoo</c> kernel) and boot options. As an example, we show you how
to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
parameters:
</p>
<pre caption="Booting an Installation CD">
boot: <i>gentoo dopcmcia</i>
</pre>
<p>
You will then be greeted with a boot screen and progress bar. If you are
installing Gentoo on a system with a non-US keyboard, make sure you
immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
selection is made in 10 seconds the default (US keyboard) will be accepted and
the boot process will continue. Once the boot process completes, Gnome will
start up and you will be automatically logged in to the "Live" Gentoo Linux
system as "gentoo" in graphical mode. You will be logged in as "root", the
superuser on the other consoles and should have a root ("#") prompt there. You
can switch to those consoles by pressing Alt-F2, Alt-F3, Alt-F4 Alt-F5, Alt-F6.
Get back to the graphical desktop you started on by pressing Alt-F7. To switch
to other consoles from within X, you must prefix the above with Ctrl. You are
able to run commands as root from any terminal within the graphical environment
by using the <c>sudo</c> application. You can even become root within a
terminal to perform multiple tasks.
</p>
<pre caption="Using sudo to run applications">
<comment>(Example only)</comment>
<comment>(Editing the group file)</comment>
# <i>sudo vi /etc/group</i>
<comment>(Becoming root for a session)</comment>
# <i>sudo su -</i>
</pre>
</body>
</subsection>
<subsection id="hardware">
<title>Extra Hardware Configuration</title>
<body>
<p>
When the LiveCD boots, it tries to detect all your hardware devices and loads
the appropriate kernel modules to support your hardware. In the vast majority
of cases, it does a very good job. However, in some cases, it may not auto-load
the kernel modules you need. If the PCI auto-detection missed some of your
system's hardware, you will have to load the appropriate kernel modules
manually. These tasks require root access.
</p>
<p>
In the next example we try to load the <c>8139too</c> module (support for
certain kinds of network interfaces):
</p>
<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>
<p>
If you need PCMCIA support, you should start the <c>pcmcia</c> init script:
</p>
<pre caption="Starting the PCMCIA init script">
# <i>/etc/init.d/pcmcia start</i>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>
<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. You will need root access to use <c>hdparm</c>.
With the <c>-tT</c> options you can test the performance of your disk (execute
it several times to get a more precise impression):
</p>
<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>
<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>
<pre caption="Tweaking hard disk performance">
<comment>(Activate DMA:)</comment>
# <i>hdparm -d 1 /dev/hda</i>
<comment>(Or with Safe Performance Options:)</comment>
# <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>
</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>
<p>
If you plan on giving other people access to your installation environment or
you want to chat using <c>irssi</c> without root privileges (for security
reasons), you need to create the necessary user accounts and change the root
password. You need root access to change the root password and add new users.
</p>
<p>
To change the root password, use the <c>passwd</c> utility:
</p>
<pre caption="Changing the root password">
$ <i>sudo su -</i>
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
<p>
To create a user account, we first enter their credentials, followed by its
password. We use <c>useradd</c> and <c>passwd</c> for these tasks. In the next
example, we create a user called "john".
</p>
<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>
<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>
<pre caption="Changing user id">
# <i>su - john</i>
</pre>
<p>
You can also change the password for the "gentoo" user in the graphical
environment. This account is already suitable for use on the Internet.
</p>
<pre caption="Changing the gentoo password">
$ <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>
</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>
<p>
If you want to view the Gentoo Handbook (either from-CD or online) during the
installation, you can view it with Mozilla Firefox (from the graphical
environment) or with <c>links</c> (from a terminal environment).
</p>
<pre caption="Viewing the on-CD documentation with Firefox">
# <i>firefox /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
If you would prefer to use <c>links</c> to see a text-only version of the
handbook, make sure you have created a user account (see <uri
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c>
to go to a new terminal and log in.
</p>
<pre caption="Viewing the on-CD documentation with links">
# <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>
<p>
You can go back to your original window by pressing <c>Alt-F7</c>.
</p>
<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD. You can view it using Firefox or
<c>links</c> as well, but only after having completed the <e>Configuring your
Network</e> chapter (otherwise you won't be able to go on the Internet to view
the document):
</p>
<pre caption="Viewing the online documentation with Firefox">
# <i>firefox http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
</pre>
<pre caption="Viewing the online documentation with links">
# <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
</pre>
<p>
You can now choose to proceed by using the <uri link="?part=1&chap=3">GTK+
based installer</uri> (which needs X) or the <uri
link="?part=1&chap=4">Dialog based installer</uri> that can be run on a
console.
</p>
</body>
</subsection>
</section>
</sections>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2006-08-12 22:15 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-08-12 22:15 [gentoo-doc-cvs] cvs commit: handbook-amd64.xml handbook-x86.xml hb-install-amd64-medium.xml hb-install-gli-medium.xml hb-install-x86-medium.xml Xavier Neys
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox