[syslinux] patch, man/extlinux.1

[Regid Ichira]

--- On Mon, 11/28/11, Jeffrey Hutzelman wrote:

> On Sun, 2011-11-27 at 08:06 -0800,
> Regid Ichira wrote:
> > --- On Sun, 11/27/11, Jeffrey Hutzelman <jhutz at cmu.edu>
> wrote:
> > 
> > > Essentially, -M behaves similarly to (but
> overrides) the DEFAULT
> > > directive, but only with respect to the menu
> system (it does not
> > > affect the command line) and only if 'MENU SAVE'
> is in effect.
> > 
> >   With /boot/extlinux/extlinux.conf
> containing:
> > 
> >     default 1
> >     timeout 50
> > 
> >     label 0
> >         Whatever
> chaining is required for MS
> >     label 1
> >         kernel old
> >     label 2
> >         kernel new
> > 
> > Will
> >     extlinux -M 2 /boot/extlinux
> > make the system boot new kernel once, after which old
> kernel will
> > be used?
> 
> No.  Your configuration does not invoke the menu
> system, which is the
> only thing affected by 'extlinux -M'.  It also does
> not use the 'menu
> save' command, without which the menu system does not look
> at the saved
> default.  See doc/menu.txt for more information on how
> to use the simple
> menu system.
> 

--- a/man/extlinux.1   2011-04-19 00:24:17.000000000 +
0300
+++ b/man/extlinux.1  2011-11-28 22:32:36.000000000 +0200
@@ -5,7 +5,7 @@ extlinux \- install the \s-1SYSLINUX\s+1
 .B extlinux
 [\fIoptions\fP] \fIdirectory\fP
 .SH DESCRIPTION
-\fBEXTLINUX\fP is a new syslinux derivative, which boots from a Linux
ext2/ext3
+\fBEXTLINUX\fP is a syslinux derivative, which boots from a Linux ext2
/ext3
 filesystem.  It works the same way as \fBSYSLINUX\fP, with a few sligh
t modifications.
 It is intended to simplify first-time installation of Linux, and for c
reation of
 rescue and other special-purpose boot disks.
@@ -26,10 +26,13 @@ Install over the current bootsector.
 Clear the boot-once command.
 .TP
 \fB\-o\fR, \fB\-\-once\fR=\fIcommand\fR
-Execute a command once upon boot.
+Execute a command once upon boot. 'command' is any command you could e
nter at the \fBSyslinux\fP command line.  It will be executed on the ne
xt boot and then erased.
 .TP
 \fB\-M\fR, \fB\-\-menu\-save\fR=\fIlabel\fR
-Set the label to select as default on the next boot
+Set the label to select as default on the next boot. Only affects the
+menu system of the configuration. Requires the 'menu save' command,
+without which the menu system does not look at the saved default. Note
+that label refers to the plain LABEL directive, not the MENU LABEL.
 .TP
 \fB\-r\fR, \fB\-\-raid\fR
 Fall back to the next device on boot failure.
@@ -41,12 +44,17 @@ Reset auxiliary data.
 Force the number of sectors per track.
 .TP
 \fB\-U\fR, \fB\-\-update\fR
-Updates a previous \fBEXTLINUX\fP installation.
+Install if, and only if, a version of \fBEXTLINUX\fP is already instal
led, while trying to preserve some of the user specific data of the cur
rent installation.
 .TP
 \fB\-z\fR, \fB\-\-zip\fR
 Force zipdrive geometry (-H 64 -S 32).
+.SH EXIT CODE
+0 is returned on success. This does not necessarily imply that the
+behavior when booting is what you anticipated. For example, using
+-M 'there is no such label' is likely to return 0, even though there
+will be no effect at boot.
 .SH FILES
-The extlinux configuration file needs to be named extlinux.conf and ne
eds to be stored in the extlinux installation directory. For more infor
mation about the contents of extlinux.conf, see syslinux(1) manpage, se
ction files.
+The extlinux configuration file needs to be named extlinux.conf. sysli
nux.cfg is also tried if extlinux.conf is not found. They are looked fo
r in the extlinux installation directory. For more information about th
eir contents, see syslinux(1) manpage, section files.
 .SH BUGS
 I would appreciate hearing of any problems you have with \s-1SYSLINUX\
s+1.  I
 would also like to hear from you if you have successfully used \s-1SYS
LINUX\s+1,
@@ -58,7 +66,7 @@ reported turn out to be BIOS or hardware
 information as possible in order to diagnose the problems.
 .PP
 There is a mailing list for discussion among \s-1SYSLINUX\s+1 users an
d for
-announcements of new and test versions. To join, send a message to
-majordomo at linux.kernel.org with the line:
+announcements of new and test versions. To join, see http://www.zytor.
com/mailman/listinfo/syslinux.
 .SH SEE ALSO
-.BR syslinux (1)
+.BR syslinux (1),
+http://syslinux.zytor.com