aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAdy <ady-sf@hotmail.com>2014-12-28 14:37:46 -0500
committerGene Cumm <gene.cumm@gmail.com>2015-01-05 20:43:13 -0500
commite0bbcd5f91ccb9b8981c000f4ecb9c16947ff03d (patch)
tree2f39dd1617e89626f1af57dddf7c77f1069234d2
parent8ca85bbbcd82ec14c388946ecda4e8d061d7bf39 (diff)
downloadsyslinux-e0bbcd5f91ccb9b8981c000f4ecb9c16947ff03d.tar.gz
syslinux-e0bbcd5f91ccb9b8981c000f4ecb9c16947ff03d.tar.xz
syslinux-e0bbcd5f91ccb9b8981c000f4ecb9c16947ff03d.zip
txt/syslinux.txt: updates
Correct typos. Improve format for asciidoc-to-manpage conversion. Wrap text. Correct info. Help phase-out deprecated and/or conflicting options. Signed-off-by: Gene Cumm <gene.cumm@gmail.com>
-rw-r--r--txt/syslinux.txt22
1 files changed, 12 insertions, 10 deletions
diff --git a/txt/syslinux.txt b/txt/syslinux.txt
index 59666635..358c50ea 100644
--- a/txt/syslinux.txt
+++ b/txt/syslinux.txt
@@ -30,9 +30,10 @@ the Linux installers syslinux and syslinux-mtools, 'DEVICE' should be an
unmounted file system. For the DOS/Win32/Win64 installers, 'DEVICE'
should be a drive like 'a:' (case insensitive).
-For versions ~4.00 and later, either -i/--install or -U/--update must be
-specified unless modifying the ADV of an existing install (options
-tagged with 'ADV') or requesting the help/usage or version info, .
+For versions ~4.00 and later, either *-i*/*--install* or *-U*/*--update*
+must be specified unless modifying the ADV of an existing install
+(options tagged with 'ADV') or requesting the help/usage or version
+info.
If, during boot, the Shift or Alt keys are held down, or the Caps or
Scroll locks are set, *Syslinux* will display a *lilo*(8) -style "boot:"
@@ -48,7 +49,8 @@ Please note, the ldlinux.sys boot loader file is flagged as immutable
boot-time integrity. File systems with a sufficiently large boot loader
reserved area, like btrfs, will have ldlinux.sys installed there rather
than as a normal file. Prior to version 4.00, extlinux would install a
-file extlinux.sys which versions 4.00 and later installers will replace with ldlinux.sys.
+file extlinux.sys which versions 4.00 and later installers will replace
+with ldlinux.sys.
== OPTIONS ==
@@ -83,8 +85,7 @@ active.
only).
*-f*, *--force*::
-Force install even if it appears unsafe. Before 4.00, -f was used for
---offset in the Linux installers.
+Force install even if it appears unsafe.
*-H*, *--heads* 'head-count'::
Override the detected number of heads for the geometry. See also
@@ -110,7 +111,7 @@ in the boot sequence (usually the next hard disk) instead of stopping
with an error message. This is useful for RAID-1 booting.
*--reset-adv*::
-(ADV) Reset auxilliary data vector.
+(ADV) Reset auxiliary data vector.
*-S*, *--sectors* 'sector-count'::
Override the detected number of sectors for the geometry. See also
@@ -119,13 +120,14 @@ Override the detected number of sectors for the geometry. See also
*-s*, *--stupid*::
Install a "safe, slow and stupid" version of *SYSLINUX*. This version
may work on some very buggy BIOSes on which *SYSLINUX* would otherwise
-fail. If you find a machine on which the -s option is required to make
+fail. If you find a machine on which the *-s* option is required to make
it boot reliably, please send as much info about your machine as you
can, and include the failure mode.
*-t*, *--offset* 'offset'::
(Linux syslinux/syslinux-mtools ONLY) Indicates that the filesystem is
-at an offset from the base of the device or file.
+at an offset from the base of the device or file. Some older versions
+did not accept the short format, *-t*.
*-z*, *--zipdrive*
Assume zipdrive geometry ('--heads 64 --sectors 32'). See also *--head*
@@ -195,7 +197,7 @@ the partion number is:
iflag=fullblock conv=notrunc of=/dev/sda
+
Note: using 'cat' for writing the MBR can under some circumstances cause
-data loss or overwritting. For this reason, using 'dd' is recommended
+data loss or overwriting. For this reason, using 'dd' is recommended
for all situations.
//[FIXME]: any clean way to handle the above long command for manpage?