Minor El Torito documentation edits

[Christian Jones]

I've written just a few extra notes in the manual on making a bootable 
CD-ROM, mostly a few extra words about compatibility and some 
clarifications on what's optional.

The only real change is using -boot-load-size 4 instead of 
-boot-load-size 1.  For me, it doesn't break anything (although it 
doesn't really fix anything either ;-) ), but there is anecdotal 
evidence (see 
http://www.zytor.com/pipermail/syslinux/2003-September/002551.html
) that there are some BIOSes that don't work unless it's set to 4.

Since the size is technically (something like) 156 sectors, it really 
shouldn't matter if it's 1 or 4---though note that if -boot-load-size is 
left off (implying a value of 156), grub won't boot (at all) on one of 
my older machines;  I'm sticking with 4.

I've attached a quick patch.  (And, per policy, an addition to the 
ChangeLog, though I really don't think including my name is warranted 
for such minor edits.  Feel free to strip that part out or tell me to ;-) )
--
Christian Jones
address@hidden
http://www.aleph0.com/~chjones

diff -ur grub/ChangeLog grub.new/ChangeLog
--- grub/ChangeLog      2004-04-23 06:39:01.000000000 -0700
+++ grub.new/ChangeLog  2004-04-26 10:32:46.650153600 -0700
@@ -1,3 +1,9 @@
+2004-04-26  Christian Jones  <address@hidden>
+
+       * docs/grub.texi (Making a GRUB bootable CD-ROM): minor edits,
+       including a few compatibility notes and a change to 
+       -boot-load-size 4 for the mkisofs command.
+
 2004-04-22  Jeroen Dekkers  <address@hidden>
 
        * Makefile.am (AUTOMAKE_OPTIONS): Add "gnu".
diff -ur grub/docs/grub.texi grub.new/docs/grub.texi
--- grub/docs/grub.texi 2004-04-18 05:39:39.000000000 -0700
+++ grub.new/docs/grub.texi     2004-04-26 10:21:05.712254400 -0700
@@ -672,11 +672,12 @@
 GRUB supports the @dfn{no emulation mode} in the El Torito
 address@hidden Torito is a specification for bootable CD
 using BIOS functions.}. This means that you can use the whole CD-ROM
-from GRUB and you don't have to make a floppy or hard disk image file.
+from GRUB and you don't have to make a floppy or hard disk image file,
+which can cause compatibility problems.
 
 For booting from a CD-ROM, GRUB uses a special Stage 2 called
address@hidden All you need to have in your bootable CD-ROM
-are this @file{stage2_eltorito} and optionally a config file
address@hidden The only GRUB files you need to have in your 
+bootable CD-ROM are this @file{stage2_eltorito} and optionally a config file
 @file{menu.lst}. You don't need to use @file{stage1} or @file{stage2},
 because El Torito is quite different from the standard boot process.
 
@@ -700,25 +701,27 @@
 $ @kbd{cp /usr/share/grub/i386-pc/stage2_eltorito iso/boot/grub}
 @end example
 
-Then, make the config file @file{menu.lst} under @file{iso/boot/grub}
-(@pxref{Configuration}), and copy files and directories to the
-directory @file{iso} as you wish.
+If desired, make the config file @file{menu.lst} under @file{iso/boot/grub}
+(@pxref{Configuration}), and copy any files and directories for the disc to the
+directory @file{iso/}.
 
 Finally, make a ISO9660 image file like this:
 
 @example
 $ @kbd{mkisofs -R -b boot/grub/stage2_eltorito -no-emul-boot \
-    -boot-load-size 1 -boot-info-table -o grub.iso iso}
+    -boot-load-size 4 -boot-info-table -o grub.iso iso}
 @end example
 
 This produces a file named @file{grub.iso}, which then can be burned
-into a CD (or a DVD).
-
-Note that you can use the device @samp{(cd)} to access a CD-ROM in your
-config file. But you won't have to use this feature, because GRUB
-automatically sets the root device to @samp{(cd)} when booted from a
-CD-ROM. So it is not necessary to specify the device name explicitly,
-unless you want to access other drives as well.
+into a CD (or a DVD).  @kbd{mkisofs} has already set up the disc to boot
+from the @kbd{boot/grub/stage2_eltorito} file, so there is no need to 
+setup GRUB on the disc.  (Note that the @kbd{-boot-load-size 4} bit is
+required for compatibility with the BIOS on many older machines.)
+
+You can use the device @samp{(cd)} to access a CD-ROM in your
+config file. This is not required; GRUB automatically sets the root device 
+to @samp{(cd)} when booted from a CD-ROM. It is only necessary to refer to 
address@hidden(cd)} if you want to access other drives as well.
 
 
 @node Booting