aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorH. Peter Anvin <hpa@zytor.com>2008-12-11 14:59:36 -0800
committerH. Peter Anvin <hpa@zytor.com>2008-12-14 13:53:58 -0800
commite21e66137b454fb3afd50a113de68599dd28de09 (patch)
tree807860047ee9e406888e49590aa5f13ce03b2a1c /doc
parent36390f9712ac56be1dce7a635322bd96e15620c1 (diff)
downloadsyslinux-elf-e21e66137b454fb3afd50a113de68599dd28de09.tar.gz
syslinux-elf-e21e66137b454fb3afd50a113de68599dd28de09.tar.xz
syslinux-elf-e21e66137b454fb3afd50a113de68599dd28de09.zip
Add new "UI" directive instead of abusing the DEFAULT directive
Add a new "UI" directive to specify a user interface module, instead of abusing the DEFAULT directive. This allows the DEFAULT directive to be used for setting the default, even when the menu system is enabled. Signed-off-by: H. Peter Anvin <hpa@zytor.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/menu.txt37
-rw-r--r--doc/syslinux.txt5
2 files changed, 34 insertions, 8 deletions
diff --git a/doc/menu.txt b/doc/menu.txt
index a03c72a1..fd5a44da 100644
--- a/doc/menu.txt
+++ b/doc/menu.txt
@@ -28,28 +28,31 @@ configuration file for SYSLINUX, EXTLINUX and ISOLINUX, and the same
directory as pxelinux.0 for PXELINUX), and put the following options
in your configuration file:
-DEFAULT menu.c32
-PROMPT 0
+UI menu.c32
-There are a few menu additions to the command line, all starting with
-the keywords MENU or TEXT; like the rest of the Syslinux config file
-language, it is case insensitive:
+There are a few menu additions to the configuration file, all starting
+with the keywords MENU or TEXT; like the rest of the Syslinux config
+file language, it is case insensitive:
+
MENU TITLE title
Give the menu a title. The title is presented at the top of
the menu.
+
MENU HIDDEN
Do not display the actual menu unless the user presses a key.
All that is displayed is a timeout message.
+
MENU SEPARATOR
Insert an empty line in the menu.
+
MENU LABEL label
(Only valid after a LABEL statement.)
@@ -85,6 +88,7 @@ MENU INDENT count
(Only valid after a LABEL statement.)
Will add "count" spaces in front of the displayed menu entry.
+
MENU DISABLE
(Only valid after a LABEL statement.)
@@ -142,8 +146,9 @@ MENU HIDE
MENU DEFAULT
(Only valid after a LABEL statement.)
- Indicates that this entry should be the default. If no
- default is specified, use the first one.
+
+ Indicates that this entry should be the default for this
+ particular submenu. See also the DEFAULT directive below.
TEXT HELP
@@ -239,7 +244,23 @@ MENU START
(Only valid inside MENU BEGIN ... MENU END)
Indicates that the menu system should start at the menu being
- defined instead of at the top-level menu.
+ defined instead of at the top-level menu. See also the
+ DEFAULT directive below.
+
+
+DEFAULT label
+
+ Set the global default. If "label" points into a submenu,
+ that menu becomes the start menu; in other words, this
+ directive has the same effect as both MENU DEFAULT and MENU
+ START.
+
+ For backwards compatibility with earlier versions of Syslinux,
+ this directive is ignored unless the configuration file also
+ contains a UI directive.
+
+ Note: the CLI accepts options after the label, or even a
+ non-label. The menu system does not support that.
INCLUDE filename [tagname]
diff --git a/doc/syslinux.txt b/doc/syslinux.txt
index 285be8b8..2d64e4bf 100644
--- a/doc/syslinux.txt
+++ b/doc/syslinux.txt
@@ -145,6 +145,11 @@ DEFAULT kernel options...
true, as it caused problems when using a shell as a substitute
for "init." You may want to include this option manually.
+UI module options...
+ Selects a specific user interface module (typically menu.c32
+ or vesamenu.c32). The command-line interface treats this as a
+ directive that overrides the DEFAULT and PROMPT directives.
+
APPEND options...
Add one or more options to the kernel command line. These are
added both for automatic and manual boots. The options are