* docs/grub.texi (Menu-specific commands): Remove some semantics
that were true in GRUB Legacy but not in GRUB 2. (submenu): New section. (false): New section. (read): New section. (true): New section.
This commit is contained in:
parent
a752763906
commit
2a2da1d030
2 changed files with 57 additions and 11 deletions
|
@ -1,3 +1,12 @@
|
|||
2011-03-30 Colin Watson <cjwatson@ubuntu.com>
|
||||
|
||||
* docs/grub.texi (Menu-specific commands): Remove some semantics
|
||||
that were true in GRUB Legacy but not in GRUB 2.
|
||||
(submenu): New section.
|
||||
(false): New section.
|
||||
(read): New section.
|
||||
(true): New section.
|
||||
|
||||
2011-03-30 Colin Watson <cjwatson@ubuntu.com>
|
||||
|
||||
* docs/grub.texi (Changes from GRUB Legacy): Minor proofreading.
|
||||
|
|
|
@ -2411,9 +2411,6 @@ In rescue mode, only the @command{insmod} (@pxref{insmod}), @command{ls}
|
|||
The semantics used in parsing the configuration file are the following:
|
||||
|
||||
@itemize @bullet
|
||||
@item
|
||||
The menu-specific commands have to be used before any others.
|
||||
|
||||
@item
|
||||
The files @emph{must} be in plain-text format.
|
||||
|
||||
|
@ -2427,20 +2424,13 @@ Options are separated by spaces.
|
|||
@item
|
||||
All numbers can be either decimal or hexadecimal. A hexadecimal number
|
||||
must be preceded by @samp{0x}, and is case-insensitive.
|
||||
|
||||
@item
|
||||
Extra options or text at the end of the line are ignored unless otherwise
|
||||
specified.
|
||||
|
||||
@item
|
||||
Unrecognized commands are added to the current entry, except before entries
|
||||
start, where they are ignored.
|
||||
@end itemize
|
||||
|
||||
These commands can only be used in the menu:
|
||||
|
||||
@menu
|
||||
* menuentry:: Start a menu entry
|
||||
* submenu:: Group menu entries
|
||||
@end menu
|
||||
|
||||
|
||||
|
@ -2470,6 +2460,22 @@ The @option{--hotkey} option associates a hotkey with a menu entry.
|
|||
@end deffn
|
||||
|
||||
|
||||
@node submenu
|
||||
@subsection submenu
|
||||
|
||||
@deffn Command submenu @var{title} @
|
||||
[@option{--class=class} @dots{}] [@option{--users=users}] @
|
||||
[@option{--hotkey=key}] @
|
||||
@{ @var{menu entries} @dots{} @}
|
||||
This defines a submenu. An entry called @var{title} will be added to the
|
||||
menu; when that entry is selected, a new menu will be displayed showing all
|
||||
the entries within this submenu.
|
||||
|
||||
All options are the same as in the @command{menuentry} command
|
||||
(@pxref{menuentry}).
|
||||
@end deffn
|
||||
|
||||
|
||||
@node General commands
|
||||
@section The list of general commands
|
||||
|
||||
|
@ -2590,6 +2596,7 @@ you forget a command, you can run the command @command{help}
|
|||
* drivemap:: Map a drive to another
|
||||
* echo:: Display a line of text
|
||||
* export:: Export an environment variable
|
||||
* false:: Do nothing, unsuccessfully
|
||||
* gettext:: Translate a string
|
||||
* gptsync:: Fill an MBR based on GPT entries
|
||||
* halt:: Shut down your computer
|
||||
|
@ -2607,10 +2614,12 @@ you forget a command, you can run the command @command{help}
|
|||
* password_pbkdf2:: Set a hashed password
|
||||
* play:: Play a tune
|
||||
* pxe_unload:: Unload the PXE environment
|
||||
* read:: Read user input
|
||||
* reboot:: Reboot your computer
|
||||
* search:: Search devices by file, label, or UUID
|
||||
* sendkey:: Emulate keystrokes
|
||||
* set:: Set an environment variable
|
||||
* true:: Do nothing, successfully
|
||||
* unset:: Unset an environment variable
|
||||
* uppermem:: Set the upper memory size
|
||||
@end menu
|
||||
|
@ -2853,6 +2862,15 @@ to subsidiary configuration files loaded using @command{configfile}.
|
|||
@end deffn
|
||||
|
||||
|
||||
@node false
|
||||
@subsection false
|
||||
|
||||
@deffn Command false
|
||||
Do nothing, unsuccessfully. This is mainly useful in control constructs
|
||||
such as @code{if} and @code{while} (@pxref{Shell-like scripting}).
|
||||
@end deffn
|
||||
|
||||
|
||||
@node gettext
|
||||
@subsection gettext
|
||||
|
||||
|
@ -3106,6 +3124,16 @@ This command is only available on PC BIOS systems.
|
|||
@end deffn
|
||||
|
||||
|
||||
@node read
|
||||
@subsection read
|
||||
|
||||
@deffn Command read [var]
|
||||
Read a line of input from the user. If an environment variable @var{var} is
|
||||
given, set that environment variable to the line of input that was read,
|
||||
with no terminating newline.
|
||||
@end deffn
|
||||
|
||||
|
||||
@node reboot
|
||||
@subsection reboot
|
||||
|
||||
|
@ -3294,6 +3322,15 @@ arguments, print all environment variables with their values.
|
|||
@end deffn
|
||||
|
||||
|
||||
@node true
|
||||
@subsection true
|
||||
|
||||
@deffn Command true
|
||||
Do nothing, successfully. This is mainly useful in control constructs such
|
||||
as @code{if} and @code{while} (@pxref{Shell-like scripting}).
|
||||
@end deffn
|
||||
|
||||
|
||||
@node unset
|
||||
@subsection unset
|
||||
|
||||
|
|
Loading…
Reference in a new issue