[syslinux] [PATCH] txt/syslinux.txt
Ady
ady-sf at hotmail.com
Sat Dec 27 09:30:46 PST 2014
Correct typos.
Improve format for asciidoc-to-manpage conversion.
Wrap text.
Correct info.
Help phase-out deprecated and/or conflicting options.
diff U3 /syslinux-6.03/txt/syslinux.txt /wip/txt/syslinux.txt
--- /syslinux-6.03/txt/syslinux.txt Mon Oct 06 16:27:44 2014
+++ /wip/txt/syslinux.txt Sat Dec 27 18:20:27 2014
@@ -30,9 +30,10 @@
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 @@
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 @@
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
@@ -96,10 +97,8 @@
*-M*, *--menu-save*::
(4.00+; ADV) Set the label to select as default on the next boot.
-*-o*, *--once* 'command'::
-(ADV) Declare a boot command to be tried on the first boot only. The
-use of *-o* for the Linux installers syslinux or syslinux-mtools has
-been deprecated as of \~4.00 and is no longer valid as of ~4.02.
+* *, *--once* 'command'::
+(ADV) Declare a boot command to be tried on the first boot only.
*-O*, *--clear-once*::
Clear the boot-once command. See also *--once*.
@@ -110,7 +109,7 @@
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 +118,14 @@
*-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 +195,7 @@
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?
More information about the Syslinux
mailing list