[multiboot-guide] master: Beginning an elaboration of GRUB options used in multiboot situations. (9a30470)

[immanetize at fedoraproject.org]

Repository : http://git.fedorahosted.org/cgit/docs/multiboot-guide.git

On branch  : master

>---------------------------------------------------------------

commit 9a3047080f92deb2850be99fac93a072f33c0daf
Author: Pete Travis <immanetize at fedoraproject.org>
Date:   Sat Nov 30 22:24:24 2013 -0700

    Beginning an elaboration of GRUB options used in multiboot situations.


>---------------------------------------------------------------

 en-US/GRUB-customizing.xml |  108 +++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 106 insertions(+), 2 deletions(-)

diff --git a/en-US/GRUB-customizing.xml b/en-US/GRUB-customizing.xml
index 4fcda6e..68272d8 100644
--- a/en-US/GRUB-customizing.xml
+++ b/en-US/GRUB-customizing.xml
@@ -4,7 +4,111 @@
 %BOOK_ENTITIES;
 
 ]>
-<section id="GRUB-customizing">
+<section id="GRUB-configuration">
   <title>Customizing GRUB entries</title>
-  <para />
+  <para>
+    Templates used to create the GRUB configuration file are found in two places. General settings for GRUB itself are set in <filename>/etc/default/grub</filename>, and settings for operating systems are found within <filename>/etc/grub.conf.d</filename>. After making changes to these files, apply them using the instuctions in <xref linkend="GRUB-mkconfig" />
+  </para>
+  <section>
+    <title>GRUB Global settings</title>
+    <para>
+      This section covers existing and possible GRUB settings for <filename>/etc/default/grub</filename>.  For a complete overview, see <ulink url="http://www.gnu.org/software/grub/manual/grub.html#Configuration" />
+    </para>
+    <table>
+      <tgroup cols="3" align="left" colsep="1" rowsep="1">
+        <colspec colname="option" />
+        <colspec colname="function" />
+        <colspec colname="example" />
+        <thead>
+          <row>
+            <entry>GRUB Option</entry>
+            <entry>Function</entry>
+            <entry>Example Usage</entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>GRUB_TIMEOUT</entry>
+            <entry>
+              Number of seconds to display menu before loading default entry. 0 boots immediately, -1 waits indefinitely.
+            </entry>
+            <entry>
+              GRUB_TIMEOUT=0
+            </entry>
+          </row>
+          <row>
+            <entry>GRUB_HIDDEN_TIMEOUT</entry>
+            <entry>Number of seconds to wait for a keypress before displaying the menu. If no key is pressed, boots the default entry. Often used with GRUB_TIMEOUT=0.
+            </entry>
+            <entry>
+              GRUB_HIDDEN_TIMEOUT=0
+            </entry>
+          </row>
+          <row>
+            <entry>
+              GRUB_HIDDEN_TIMEOUT_QUIET
+            </entry>
+            <entry>
+              If set, does not display countdown during GRUB_HIDDEN_TIMOUT wait.
+            </entry>
+            <entry>
+              GRUB_HIDDEN_TIMEOUT_QUIET=true
+            </entry>
+          </row>
+          <row>
+            <entry>GRUB_CMDLINE_LINUX</entry>
+            <entry>
+              Arguments that are added to menu entries for Linux systems.
+            </entry>
+            <entry>
+              GRUB_CMDLINE_LINUX="rhgb quiet acpi_backlight=vendor"
+            </entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+    <para>This second set of GRUB options can be used to change the appearance of GRUB. By default, GRUB presentation is minimal, allowing the GRUB to load quickly and the system to boot as quickly as possible.
+    </para>
+    <table>
+      <title>Aesthetic GRUB options</title>
+      <tgroup cols="3" align="left" colsep="1" rowsep="1">
+        <colspec colname="option" />
+        <colspec colname="function" />
+        <colspec colname="example" />
+        <thead>
+          <row>
+            <entry>GRUB Option</entry>
+            <entry>Function</entry>
+            <entry>Example Usage</entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>GRUB_TERMINAL</entry>
+            <entry>
+              Sets the value for both GRUB_TERMINAL_INPUT and GRUB_TERMINAL_OUTPUT. Use gfxterm for graphical output, or serial to output through a serial port.
+            </entry>
+            <entry>GRUB_TERMINAL=gfxterm</entry>
+          </row>
+          <row>
+            <entry>GRUB_BACKGROUND</entry>
+            <entry>Set a background image for use with gfxterm. The file should be in the boot partition and of PNG, TGA, or JPG format.
+            </entry>
+            <entry>
+              GRUB_BACKGROUND=hot-dog.png
+            </entry>
+          </row>
+          <row>
+            <entry>GRUB_THEME</entry>
+            <entry>Points to the text file that defines a GRUB2 theme. None are included by default, due to the additional boot time required to load the theme. You can install the grub2-starfield-theme package for an example, or look on a website such as <ulink url="http://gnome-look.org" />
+            </entry>
+            <entry>
+              GRUB_THEME=/usr/share/grub/themes/starfield/theme.txt
+            </entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+
+  </section> 
 </section>