* docs/grub.texi (configfile): Explain environment variable

handling.
(source): New section.
Reported by: Arbiel Perlacremaz.  Fixes Savannah bug #35564.
This commit is contained in:
Colin Watson 2013-01-02 09:29:48 +00:00
parent 5c67ea6cd9
commit 971dd2c6d5
2 changed files with 24 additions and 1 deletions

View file

@ -1,3 +1,10 @@
2013-01-02 Colin Watson <cjwatson@ubuntu.com>
* docs/grub.texi (configfile): Explain environment variable
handling.
(source): New section.
Reported by: Arbiel Perlacremaz. Fixes Savannah bug #35564.
2012-12-31 Colin Watson <cjwatson@ubuntu.com> 2012-12-31 Colin Watson <cjwatson@ubuntu.com>
Remove several trivially-unnecessary uses of nested functions. Remove several trivially-unnecessary uses of nested functions.

View file

@ -3303,6 +3303,7 @@ you forget a command, you can run the command @command{help}
* search:: Search devices by file, label, or UUID * search:: Search devices by file, label, or UUID
* sendkey:: Emulate keystrokes * sendkey:: Emulate keystrokes
* set:: Set an environment variable * set:: Set an environment variable
* source:: Read a configuration file in same context
* true:: Do nothing, successfully * true:: Do nothing, successfully
* unset:: Unset an environment variable * unset:: Unset an environment variable
* uppermem:: Set the upper memory size * uppermem:: Set the upper memory size
@ -3429,7 +3430,9 @@ If they are completely identical, nothing will be printed.
@deffn Command configfile file @deffn Command configfile file
Load @var{file} as a configuration file. If @var{file} defines any menu Load @var{file} as a configuration file. If @var{file} defines any menu
entries, then show a menu containing them immediately. entries, then show a menu containing them immediately. Any environment
variable changes made by the commands in @var{file} will not be preserved
after @command{configfile} returns.
@end deffn @end deffn
@ -4069,6 +4072,19 @@ arguments, print all environment variables with their values.
@end deffn @end deffn
@node source
@subsection source
@deffn Command source file
Read @var{file} as a configuration file, as if its contents had been
incorporated directly into the sourcing file. Unlike @command{configfile}
(@pxref{configfile}), this executes the contents of @var{file} without
changing context: any environment variable changes made by the commands in
@var{file} will be preserved after @command{source} returns, and the menu
will not be shown immediately.
@end deffn
@node true @node true
@subsection true @subsection true