Re: Installation Guide
On Mon, 6 Nov 2000, neal@cs.uml.edu wrote:
> Hi Guys,
>
> Thanks to everyone for the feedback. Off the top of my head, I
> should name, Brent, John and Jim, especially Roland and everyone
> else who I forgot.
>
> The new guide is at:
> http://walfield.org/papers/hurd-installation-guide
I've fixed some typos etc:
--- hurd.texi.old Tue Nov 7 19:33:48 2000
+++ hurd.texi Wed Nov 8 02:43:10 2000
@@ -119,7 +119,7 @@
guide, most of the time will, hopefully, be spent downloading
the files. Before setting these scripts into action, one
must prepare the system. This includes creating a partition
-for the hurd and installing the boot loader, grub, the
+for the hurd and installing the boot loader, Grub, the
GRand Unified Boot loader.
This guide endeavors to make installing the hurd as
@@ -189,53 +189,53 @@
@node The Boot Loader, Debian Packages, Real Estate, Top
@chapter The Boot Loader
-Unlike GNU/Linux and the *BSDs, the hurd does not have
+Unlike GNU/Linux and the BSDs, the hurd does not have
its own boot loader; any boot loader that supports the
multiboot standard can boot the hurd. At the moment,
-the only boot loader that does this is grub, the GRand
+the only boot loader that does this is Grub, the GRand
Unified Boot loader. Therefore, it is assumed that this
is what you will be using.
-A word about grub. Grub, unlike traditional boot loaders
-on the x86, such as lilo, is very powerful. It has a
+A word about Grub. Grub, unlike traditional boot loaders
+on the x86, such as LILO, is very powerful. It has a
command line interface, bootp, dummy terminal support
-and a plethora of other features. In additional, it
+and a plethora of other features. In addition, it
can boot almost any operating system. If you have ever
-booted an alpha or sparc, you will understand what grub
-can do. Therefore, do not be scared: grub is better.
+booted an alpha or sparc, you will understand what Grub
+can do. Therefore, do not be scared: Grub is better.
You will like. You will not go back.
-Although grub is still is the ``alpha'' stage, it is
-throughly debugged and is being used as the primary boot
-loader by Mandrake (i.e. in place of lilo). To find
-grub, go to @uref{ftp://alpha.gnu.org/gnu/grub}. Here,
+Although Grub is still in the ``alpha'' stage, it is
+thoroughly debugged and is being used as the primary boot
+loader by Mandrake (i.e. in place of LILO.) To find
+Grub, go to @uref{ftp://alpha.gnu.org/gnu/grub}. Here,
there is a source tarball and a floppy image. If you
choose to download the tarball, it is a normal
@command{configure}, @command{make}, @command{make
install}. Included is a wonderful, complete manual
-on how grub works. If you choose to go this route,
+on how Grub works. If you choose to go this route,
read it. If, however, you choose to download an
image, data dumping it to a floppy disk is enough
-to get a working grub.
+to get a working Grub.
@example
# dd if=grub-boot-VERSION.image of=/dev/fd0
@end example
-Later, if you decide that you really like grub, you
-can read the manual and install in on the hard drive.
+Later, if you decide that you really like Grub, you
+can read the manual and install in on your hard drive.
@node Debian Packages, Cross Install, The Boot Loader, Top
@chapter Debian Packages
-As mentioned earlier, the Debian group has committed
+As mentioned earlier, the Debian project has committed
to creating a Debian GNU/Hurd distribution. As such,
the hurd revolves around, but is hardly bound to, the
Debian package system.
There are two ways to do the cross install of the
hurd. One can either extract a large tarball of the
-base system or ask cross-install to download the
+base system or have cross-install download the
packages. Both require a download. The former
does not require @command{dpkg} and is a slightly
shorter download. On the other hand, the packages
@@ -248,8 +248,8 @@
the Debian's package management tool, @command{dpkg}.
This tool runs on nearly all *nix operating systems.
Therefore, if you are not running Debian, you will
-need to download it. The latest version is always
-available at the Debian ftp site at:
+need to install it. The latest version is always
+available at the Debian ftp site:
@uref{ftp://ftp.debian.org/debian/project/dpkg} or
at any debian mirror. Compiling is a simple matter
of running @command{configure} followed by a
@@ -264,7 +264,7 @@
The first thing to do is to verify that the partition
is mounted. In this example, it is assumed that the
-partition is mounted on /gnu.
+partition is mounted on @file{/gnu}.
@section Using Debian Packages
@@ -312,9 +312,9 @@
@chapter Booting the Hurd
All is in readiness to boot the hurd for the first time.
-After verifying that the grub boot disk is in the drive,
-reboot. If all goes well, you will get a grub menu; hit
-@command{c} and the grub command line will come up.
+After verifying that the Grub boot disk is in the drive,
+reboot. If all goes well, you will get a Grub menu; hit
+@kbd{c} and the Grub command line will come up.
First the root partition needs to be set. Grub uses
a partition nomenclature that is a bit different from
@@ -322,17 +322,17 @@
are named @code{hdN} in the order that they are detected
by the BIOS. Note that @code{n} is a zero-based index.
The partitions are also indexed numerically from zero:
-@code{(hdN,M)}. If this sounds bad, relax: grub has
+@code{(hdN,M)}. If this sounds bad, relax: Grub has
tab completion: use it.
@example
-grub> root<tab>
+grub> root@key{TAB}
Possible commands are: root rootnoverify
-grub> root (<tab>
+grub> root (@key{TAB}
Possible disks are: fd0 hd0 hd1
-grub> root (hd0,<tab>
+grub> root (hd0,@key{TAB}
Possible partitions are:
Partition num: 0, Filesystem type is unknown, partition type 0x82
Partition num: 1, Filesystem type is ext2fs, partition type 0x83
@@ -352,13 +352,13 @@
nomenclature must be learned.
GNU Mach labels IDE disks starting at zero as @code{hdN}, and SCSI disks
-as @code{sdN}. However, like grub and unlike Linux, the drives are
+as @code{sdN}. However, like Grub but unlike Linux, the drives are
numbered in the order which they are found: i.e. not their position
on the bus. This is to say that if the only IDE disk on the system
-is the secondary master, it is @code{hd0}. Partitions use BSD's slice
+is the secondary master, it is @code{hd0}. Partitions use the BSD slice
convention, and append a @code{sM} to the drive name; @code{M} is
one, not zero, based. This slice number is simple to calculate, just
-add one to the number that grub calls it.
+add one to the number that Grub calls it.
If this sounds a bit confusing and guessing sounds undesirable, leave
this out the first time. GNU Mach will prompt for the root partition.
@@ -398,13 +398,13 @@
@section Problems
If the hurd fails to boot, it could be that there are devices using
-shared irqs. GNU Mach does not play well with these; try removing some
+shared IRQs. GNU Mach does not play well with these; try removing some
hardware and seeing if that helps. Also, as GNU Mach does not
support loadable kernel modules, many, but not all drivers are
compiled into the default kernel. If, for example, there is an
ne2000 network card installed, the kernel will crash trying to
initialize it as a different device. Building a new kernel will
-solve this. Download the source of GNU Mach and recompile under a
+solve this. Download the source of GNU Mach and recompile under your
favorite operating system. Using a cross compiler is not necessary,
as GNU Mach is statically linked.
@@ -414,9 +414,9 @@
@node Native Install, Final Words, Booting the Hurd, Top
@chapter Native Install
-Other than @command{native-install}, only several configuration
+Other than @command{native-install}, only a few configuration
details remain: the network, other file systems and a reboot
-to multiuser mode.
+to multiuser mode.
@section Native Install
@@ -430,7 +430,7 @@
@section The Network
To configure the network, the pfinet translator, which at the moment
-only supports ethernet@footnote{i.e. no ppp}, needs to be set up.
+only supports ethernet@footnote{i.e. no PPP}, needs to be set up.
This is done using the @command{settrans} command, which hooks
a translator onto a given file system node. Then when other
programs use it, the operating system transparently starts the
@@ -466,7 +466,7 @@
Next, edit @file{/etc/fstab} to add the home partition and swap space.
By default, @command{ae} is the only editor installed by the the base
distribution. Note that it is @emph{very important} that swap space be
-used: the hurd will be an order of magnitude more stable. Additionally,
+used: the hurd will be an order of magnitude more stable. Note that
the hurd can transparently share a swap partition with Linux.
@section The Reboot
@@ -476,10 +476,10 @@
@node Final Words, Works Cited, Native Install, Top
@chapter Final Words
-@section Grub's Menu
+@section The Grub Menu
Once booting the installed operating systems is second nature,
-mount the floppy and edit the /floppy/boot/grub/menu.lst to tailor
+mount the floppy and edit @file{/floppy/boot/grub/menu.lst} to tailor
it appropriately; booting will become much quicker and easier.
@section Adding Devices
@@ -509,8 +509,8 @@
that have hacks or patches that allow them to work under the hurd.
Generally, running @command{dselect} after the first install will
-pull in the rest of a ``standard'' system: very convenient. After
-that, it is all personal taste.
+pull in the rest of a ``standard'' system, which is very convenient. After
+that, it is all down to personal taste.
@section XFree86
@@ -638,8 +638,7 @@
@chapter Works Cited
``The Easy Guide to Installing Hurd on a Linux Box''
-Matthew Vernon. matthew@@debian.org.
-Copyright @copyright{} 1999
+Copyright @copyright{} 1999 Matthew Vernon @email{matthew@@debian.org}.
@uref{http://www.pick.ucam.org/~mcv21/hurd.html}
@contents
I'd also suggest that you change the name to something like
hurd-install.texi, since plain hurd clashes with e.g. the hurd manual...
--
Gaute Strokkenes http://www.srcf.ucam.org/~gs234/
NOT fucking!! Also not a PACKAGE of LOOSE-LEAF PAPER!!
Reply to: