2009-09-26 Colin Watson <cjwatson@ubuntu.com>

	* docs/grub.texi (Command-line and menu entry commands): Document
	date and echo commands.

diff --git a/ChangeLog b/ChangeLog
index fd9865440b133921f07c73043ec308e2b21deb75..fdca53d01c2df07e48a7c8bd711000ca43b66f64 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2009-09-26  Colin Watson  <cjwatson@ubuntu.com>
+
+       * docs/grub.texi (Command-line and menu entry commands): Document
+       date and echo commands.
+
 2009-09-24  Pavel Roskin  <proski@gnu.org>
 
        * include/grub/kernel.h (struct grub_module_header): Remove

diff --git a/docs/grub.texi b/docs/grub.texi
index 06059df4dfa0206f70b910469d53a1a0a371d91c..4fa44462e773c13c1ba1a29d6a8b32b0767ec0a7 100644 (file)
--- a/docs/grub.texi
+++ b/docs/grub.texi
@@ -1118,6 +1118,8 @@ you forget a command, you can run the command @command{help}
 * cmp::                         Compare two files
 * configfile::                  Load a configuration file
 * crc::                         Calculate CRC32 checksums
+* date::                        Display or set current date and time
+* echo::                        Display a line of text
 * export::                      Export an environment variable
 * halt::                        Shut down your computer
 * help::                        Show help messages
@@ -1234,6 +1236,62 @@ Display the CRC32 checksum of @var{file}.
 @end deffn
 
 
+@node date
+@subsection date
+
+@deffn Command date [[year-]month-day] [hour:minute[:second]]
+With no arguments, print the current date and time.
+
+Otherwise, take the current date and time, change any elements specified as
+arguments, and set the result as the new date and time.  For example, `date
+01-01' will set the current month and day to January 1, but leave the year,
+hour, minute, and second unchanged.
+@end deffn
+
+
+@node echo
+@subsection echo
+
+@deffn Command echo [@option{-n}] [@option{-e}] string @dots{}
+Display the requested text and, unless the @option{-n} option is used, a
+trailing new line.  If there is more than one string, they are separated by
+spaces in the output.  As usual in GRUB commands, variables may be
+substituted using @samp{$@{var@}}.
+
+The @option{-e} option enables interpretation of backslash escapes.  The
+following sequences are recognised:
+
+@table @code
+@item \\
+backslash
+
+@item \a
+alert (BEL)
+
+@item \c
+suppress trailing new line
+
+@item \f
+form feed
+
+@item \n
+new line
+
+@item \r
+carriage return
+
+@item \t
+horizontal tab
+
+@item \v
+vertical tab
+@end table
+
+When interpreting backslash escapes, backslash followed by any other
+character will print that character.
+@end deffn
+
+
 @node export
 @subsection export