Another boot example for hurd.texi

[James A Morrison]

 Here is a patch for hurd.texi that adds some information on using boot.
It also fixes a typo.

 2002-01-23  James A. Morrison  <ja2morri@uwaterloo.ca>

        * hurd.texi (Boot Program): Added section for program 'boot'.
        (Recursive Bootstrap): Added a real partition example.
        Updated copyright dates.

Index: hurd.texi
===================================================================
RCS file: /cvsroot/hurd/hurd/doc/hurd.texi,v
retrieving revision 1.20
diff -u -r1.20 hurd.texi
--- hurd.texi   12 Mar 2001 00:43:50 -0000      1.20
+++ hurd.texi   24 Jan 2002 03:28:44 -0000
@@ -98,7 +98,7 @@
 @end direntry
 
 @ifinfo
-Copyright @copyright{} 1994-2000 Free Software Foundation, Inc.
+Copyright @copyright{} 1994-2002 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -131,7 +131,7 @@
 @page
 
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1994--2000 Free Software Foundation, Inc.
+Copyright @copyright{} 1994--2002 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -170,6 +170,7 @@
 * Terminal Handling::           Helping people interact with the Hurd.
 * Running Programs::            Program execution and process management.
 * Authentication::              Verifying user and server privileges.
+* Boot Program::                Options for the boot menu
 * Index::                       Guide to concepts, functions, and files.
 
 @detailmenu
@@ -337,6 +338,10 @@
 
 * Auth Protocol::               Bidirectional authentication.
 
+Boot Program
+
+* Boot Options::
+
 @end detailmenu
 @end menu
 
@@ -666,8 +671,8 @@
 @cindex GRUB
 @cindex GRand Unified Bootloader
 Currently, @dfn{GRUB}@footnote{The GRand Unified Bootloader, available
-from @uref{http://www.uruk.org/grub/}.} is the preferred GNU bootloader.
-GRUB provides advanced functionality, and is capable of loading several
+from @uref{http://www.gnu.org/software/grub/}.} is the GNU bootloader.
+GNU GRUB provides advanced functionality, and is capable of loading several
 different kernels (such as Linux, DOS, and the *BSD family).
 
 From the standpoint of the Hurd, the bootloader is just a mechanism to
@@ -810,7 +815,7 @@
 $ @kbd{cd my-root}
 $ @kbd{tar -zxpf /pub/debian/FIXME/gnu-20000929.tar.gz}
 $ @kbd{cd ..}
-$ @kbd{fsysopts ./my-root --read-only}
+$ @kbd{fsysopts ./my-root --readonly}
 $
 @end example
 
@@ -824,6 +829,19 @@
 $ @kbd{boot -D ./my-boot ./my-boot/boot/servers.boot ./my-partition}
 [...]
 @end example
+
+@item
+ Here is an example using a hard drive that already has GNU Hurd installed.
+Assuming that the Hurd is installed on and extended 2 filesystem on /dev/hd2s1.
+
+@example
+$ @kbd{settrans /mnt /hurd/ex2fs --readonly /dev/hd2s1}
+$ @kbd{boot -d -D /mnt -I /mnt/boot/servers.boot /dev/hd2s1}
+@end example
+
+@item
+ See @pxref{Boot Options} for help with boot.
+ 
 @end enumerate
 
 Note that it is impossible to share microkernel devices between the two
@@ -4606,6 +4624,63 @@
 
 FIXME: finish
 
+@node Boot Program
+@chapter Boot Program
+@menu
+* Boot Options::                Boot program command line options
+@end menu
+
+@node Boot Options
+@section Boot Options
+
+Usage: boot [OPTION...] @var{BOOT-SCRIPT} @var{DEVICE}...
+
+@table @code
+@item --kernel-command-line=@var{COMMAND LINE}
+@itemx -c
+Simulated multiboot command line to supply
+
+@item  --pause
+@itemx  -d
+Pause for user confirmation at various times during booting
+
+@item  --boot-root=@var{DIR}
+@itemx  -D
+Root of a directory tree in which to find files specified in @var{BOOT-SCRIPT}
+
+@item --interleave=@var{BLOCKS}    
+Interleave in runs of length @var{BLOCKS}
+
+@item --isig
+@itemx  -I
+Do not disable terminal signals, so you can suspend and interrupt boot.
+
+@item  --layer
+@itemx -L                
+ Layer multiple devices for redundancy
+
+@item  --single-user
+@itemx -s          
+ Boot in single user mode
+
+@item --store-type=@var{TYPE}
+@itemx -T
+Each @var{DEVICE} names a store of type @var{TYPE}
+
+@item --help
+@itemx -?
+Gives a help list
+
+@item --usage
+Give a short usage message
+@end table
+
+Mandatory or optional arguments to long options are also mandatory or optional
+for any corresponding short options.
+
+
+If neither @option{--interleave} or @option{--layer} is specified, multiple 
+@var{DEVICE}s are concatenated.
 
 @node Index
 @unnumbered Index