Patched-up documentation. Leave the real overhaul for 1.40.

diff --git a/README b/README
index 80901a6..e57ea78 100644 (file)
--- a/README
+++ b/README
@@ -4,3 +4,9 @@ SYSLINUX.
 SYSLINUX now builds in a Linux environment, using nasm.  You need nasm
 version 0.97 or later to build SYSLINUX from source.  See
 http://www.cryogen.com/Nasm for information about nasm.
+
+WARNING: There seems to be a bug in some recent experimental Linux
+kernels that causes floppy disk corruption when using the Linux
+syslinux installer.  This bug was introduced in 2.1.79 or 2.1.80; as
+of 2.1.85 the bug is still there.
+

diff --git a/TODO b/TODO
index 3eac035..a296aa3 100644 (file)
--- a/TODO
+++ b/TODO
@@ -3,3 +3,4 @@ Currently scheduled for inclusion in 1.40:
 - FAT16 support (for LS120 floppies mainly).
 - "Comboot" style boot files.
 - Booting DOS for a DOS/Linux dual rescue disk.
+- Cleaned up documentation, with a real man page.

diff --git a/syslinux.doc b/syslinux.doc
index 869c010..012249e 100644 (file)
--- a/syslinux.doc
+++ b/syslinux.doc
@@ -33,11 +33,24 @@ In order to create a bootable Linux floppy using SYSLINUX, prepare a
 normal MS-DOS formatted floppy.  Copy one or more Linux kernel files to
 it, then execute the DOS command:
 
-        SYSLINUX drive:
+        SYSLINUX a:
+
+(or whichever drive letter is appropriate) 
+
+or the Linux command:
+
+       syslinux /dev/fd0
+
+(or, again, whichever device is the correct one.)
 
 This will alter the boot sector on the disk and copy a file named
 LDLINUX.SYS into its root directory.
 
+WARNING: There seems to be a bug in some recent experimental Linux
+        kernels that causes floppy disk corruption when using the
+        Linux syslinux installer.  This bug was introduced in 2.1.79
+        or 2.1.80; as of 2.1.85 the bug is still there.
+
 On boot time, by default, the kernel will be loaded from the image named
 LINUX on the boot floppy.  This default can be changed, see the section
 on the SYSLINUX config file.