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?