a5bd9f6
From 3d109c87aec982045fd78e0937589af98eb0ad38 Mon Sep 17 00:00:00 2001
a5bd9f6
From: Colin Watson <cjwatson@ubuntu.com>
a5bd9f6
Date: Thu, 3 Jan 2013 10:53:53 +0000
a5bd9f6
Subject: [PATCH 079/364] * docs/grub.texi (Invoking grub-mkrelpath): New
a5bd9f6
 section. (Invoking grub-script-check): Likewise.
a5bd9f6
a5bd9f6
---
a5bd9f6
 ChangeLog      |  5 +++++
a5bd9f6
 docs/grub.texi | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
a5bd9f6
 2 files changed, 63 insertions(+)
a5bd9f6
a5bd9f6
diff --git a/ChangeLog b/ChangeLog
a5bd9f6
index c91fe35..e530ac3 100644
a5bd9f6
--- a/ChangeLog
a5bd9f6
+++ b/ChangeLog
a5bd9f6
@@ -1,5 +1,10 @@
a5bd9f6
 2013-01-03  Colin Watson  <cjwatson@ubuntu.com>
a5bd9f6
 
a5bd9f6
+	* docs/grub.texi (Invoking grub-mkrelpath): New section.
a5bd9f6
+	(Invoking grub-script-check): Likewise.
a5bd9f6
+
a5bd9f6
+2013-01-03  Colin Watson  <cjwatson@ubuntu.com>
a5bd9f6
+
a5bd9f6
 	* docs/grub.texi (Invoking grub-mount): New section.
a5bd9f6
 	Reported by: Filipus Klutiero.  Fixes Debian bug #666427.
a5bd9f6
 
a5bd9f6
diff --git a/docs/grub.texi b/docs/grub.texi
a5bd9f6
index 60b18b5..e23cecc 100644
a5bd9f6
--- a/docs/grub.texi
a5bd9f6
+++ b/docs/grub.texi
a5bd9f6
@@ -36,9 +36,11 @@ Invariant Sections.
a5bd9f6
 * grub-install: (grub)Invoking grub-install.    Install GRUB on your drive
a5bd9f6
 * grub-mkconfig: (grub)Invoking grub-mkconfig.  Generate GRUB configuration
a5bd9f6
 * grub-mkpasswd-pbkdf2: (grub)Invoking grub-mkpasswd-pbkdf2.
a5bd9f6
+* grub-mkrelpath: (grub)Invoking grub-mkrelpath.
a5bd9f6
 * grub-mkrescue: (grub)Invoking grub-mkrescue.  Make a GRUB rescue image
a5bd9f6
 * grub-mount: (grub)Invoking grub-mount.        Mount a file system using GRUB
a5bd9f6
 * grub-probe: (grub)Invoking grub-probe.        Probe device information
a5bd9f6
+* grub-script-check: (grub)Invoking grub-script-check.
a5bd9f6
 @end direntry
a5bd9f6
 
a5bd9f6
 @setchapternewpage odd
a5bd9f6
@@ -101,9 +103,11 @@ This edition documents version @value{VERSION}.
a5bd9f6
 * Invoking grub-mkconfig::      Generate a GRUB configuration file
a5bd9f6
 * Invoking grub-mkpasswd-pbkdf2::
a5bd9f6
                                 Generate GRUB password hashes
a5bd9f6
+* Invoking grub-mkrelpath::     Make system path relative to its root
a5bd9f6
 * Invoking grub-mkrescue::      Make a GRUB rescue image
a5bd9f6
 * Invoking grub-mount::         Mount a file system using GRUB
a5bd9f6
 * Invoking grub-probe::         Probe device information for GRUB
a5bd9f6
+* Invoking grub-script-check::  Check GRUB script file for syntax errors
a5bd9f6
 * Obtaining and Building GRUB:: How to obtain and build GRUB
a5bd9f6
 * Reporting bugs::              Where you should send a bug report
a5bd9f6
 * Future::                      Some future plans on GRUB
a5bd9f6
@@ -4774,6 +4778,33 @@ Length of the salt.  Defaults to 64.
a5bd9f6
 @end table
a5bd9f6
 
a5bd9f6
 
a5bd9f6
+@node Invoking grub-mkrelpath
a5bd9f6
+@chapter Invoking grub-mkrelpath
a5bd9f6
+
a5bd9f6
+The program @command{grub-mkrelpath} makes a file system path relative to
a5bd9f6
+the root of its containing file system.  For instance, if @file{/usr} is a
a5bd9f6
+mount point, then:
a5bd9f6
+
a5bd9f6
+@example
a5bd9f6
+$ @kbd{grub-mkrelpath /usr/share/grub/unicode.pf2}
a5bd9f6
+@samp{/share/grub/unicode.pf2}
a5bd9f6
+@end example
a5bd9f6
+
a5bd9f6
+This is mainly used internally by other GRUB utilities such as
a5bd9f6
+@command{grub-mkconfig} (@pxref{Invoking grub-mkconfig}), but may
a5bd9f6
+occasionally also be useful for debugging.
a5bd9f6
+
a5bd9f6
+@command{grub-mkrelpath} accepts the following options:
a5bd9f6
+
a5bd9f6
+@table @option
a5bd9f6
+@item --help
a5bd9f6
+Print a summary of the command-line options and exit.
a5bd9f6
+
a5bd9f6
+@item --version
a5bd9f6
+Print the version number of GRUB and exit.
a5bd9f6
+@end table
a5bd9f6
+
a5bd9f6
+
a5bd9f6
 @node Invoking grub-mkrescue
a5bd9f6
 @chapter Invoking grub-mkrescue
a5bd9f6
 
a5bd9f6
@@ -5005,6 +5036,33 @@ Print verbose messages.
a5bd9f6
 @end table
a5bd9f6
 
a5bd9f6
 
a5bd9f6
+@node Invoking grub-script-check
a5bd9f6
+@chapter Invoking grub-script-check
a5bd9f6
+
a5bd9f6
+The program @command{grub-script-check} takes a GRUB script file
a5bd9f6
+(@pxref{Shell-like scripting}) and checks it for syntax errors, similar to
a5bd9f6
+commands such as @command{sh -n}.  It may take a @var{path} as a non-option
a5bd9f6
+argument; if none is supplied, it will read from standard input.
a5bd9f6
+
a5bd9f6
+@example
a5bd9f6
+grub-script-check /boot/grub/grub.cfg
a5bd9f6
+@end example
a5bd9f6
+
a5bd9f6
+@command{grub-script-check} accepts the following options:
a5bd9f6
+
a5bd9f6
+@table @option
a5bd9f6
+@item --help
a5bd9f6
+Print a summary of the command-line options and exit.
a5bd9f6
+
a5bd9f6
+@item --version
a5bd9f6
+Print the version number of GRUB and exit.
a5bd9f6
+
a5bd9f6
+@item -v
a5bd9f6
+@itemx --verbose
a5bd9f6
+Print each line of input after reading it.
a5bd9f6
+@end table
a5bd9f6
+
a5bd9f6
+
a5bd9f6
 @node Obtaining and Building GRUB
a5bd9f6
 @appendix How to obtain and build GRUB
a5bd9f6
 
a5bd9f6
-- 
a5bd9f6
1.8.1.4
a5bd9f6