[multiboot-guide] master: Added an introduction, with references, plus some minor structural revisions. The introduction includes a strong warning not to abuse the root account, and explains how to escalate privileges if needed. (87df7d5)

immanetize at fedoraproject.org immanetize at fedoraproject.org
Sun Jul 28 06:29:06 UTC 2013 

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

On branch  : master

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

commit 87df7d543a7c407e5e440038976719f2f570556f
Author: Pete Travis <immanetize at fedoraproject.org>
Date:   Sun Jul 28 00:27:35 2013 -0600

    Added an introduction, with references, plus some minor structural revisions.
    The introduction includes a strong warning not to abuse the root account, and
    explains how to escalate privileges if needed.


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

 en-US/BIOS-general.xml                            |    2 +-
 en-US/Fedora_Multiboot_Guide.xml                  |    2 +-
 en-US/Free_Space.xml                              |    2 +-
 en-US/GRUB.xml                                    |    2 +-
 en-US/Introduction.xml                            |   46 ++++++++++++++++++++-
 en-US/{UEFI_boot-apple.xml => UEFI-apple.xml}     |    2 +-
 en-US/{UEFI_boot-general.xml => UEFI-general.xml} |    2 +-
 en-US/{UEFI_boot-win.xml => UEFI-win.xml}         |    2 +-
 en-US/{UEFI_boot.xml => UEFI.xml}                 |    8 ++--
 9 files changed, 56 insertions(+), 12 deletions(-)

diff --git a/en-US/BIOS-general.xml b/en-US/BIOS-general.xml
index 7b230ee..7be8122 100644
--- a/en-US/BIOS-general.xml
+++ b/en-US/BIOS-general.xml
@@ -4,7 +4,7 @@
 %BOOK_ENTITIES;
 
 ]>
-<section id="multiboot-BIOS_GRUB-general">
+<section id="BIOS-general">
   <title>BIOS Basics</title>
   <para />
 </section>
diff --git a/en-US/Fedora_Multiboot_Guide.xml b/en-US/Fedora_Multiboot_Guide.xml
index 163bd69..3df1eea 100644
--- a/en-US/Fedora_Multiboot_Guide.xml
+++ b/en-US/Fedora_Multiboot_Guide.xml
@@ -9,7 +9,7 @@
 	<xi:include href="Free_Space.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<xi:include href="GRUB.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<xi:include href="BIOS.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-	<xi:include href="UEFI_boot.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="UEFI.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 	<index />
 </article>
diff --git a/en-US/Free_Space.xml b/en-US/Free_Space.xml
index c2f8de2..b70988a 100644
--- a/en-US/Free_Space.xml
+++ b/en-US/Free_Space.xml
@@ -4,7 +4,7 @@
 %BOOK_ENTITIES;
 
 ]>
-<section id="multiboot-freespace">
+<section id="freespace">
   <title>Free Space</title>
   <para />
 </section>
diff --git a/en-US/GRUB.xml b/en-US/GRUB.xml
index 7fd73fa..bf1fb6e 100644
--- a/en-US/GRUB.xml
+++ b/en-US/GRUB.xml
@@ -5,7 +5,7 @@
 
 ]>
 <section id="GRUB">
-  <title>The GRUB bootloader</title>
+  <title>The GRUB Bootloader</title>
   <para />
   
   <!-- GRUB Basics -->
diff --git a/en-US/Introduction.xml b/en-US/Introduction.xml
index 8289c2a..a4d061c 100644
--- a/en-US/Introduction.xml
+++ b/en-US/Introduction.xml
@@ -6,5 +6,49 @@
 ]>
 <section id="multiboot-introduction">
   <title>Introduction</title>
-  <para />
+  <para>
+    Fedora &PRODVER; can be used as the only operating system on your computer, or you can <firstterm>dual boot</firstterm> Fedora with another operating system. Fedora can enable selection of other options at boot, often with little to no user configuration. Systems that can boot more than two operating systems are referred to as <firstterm>multiboot</firstterm> systems.
+  </para>
+  <para>
+    Installing Fedora on a system where another operating system is installed requires <emphasis>unallocated</emphasis> drive space. <xref linkend="freespace" /> explains options for creating this free space.
+  </para>
+  <para>
+    When your system starts, it first performs self tests, then loads a bootloader, <application>GRUB</application>. GRUB provides a menu so you can select the Fedora kernel or other operating system you would like to boot, and GRUBs configuration file stores options and settings required for initial booting of the selected operating system. Read <xref linkend="GRUB" /> for more information on GRUB.
+  </para>
+  <para>
+    Changing Fedora's boot options can be helpful, especially when troubleshooting. <xref linkend="GRUB-customizing" /> explains how to change these options once or permanently.
+  </para>
+  <para>
+    The system's firmware allows basic configuration, performs initial startup, initializes hardware, and brings up the bootloader. Until recently, this firmware was referred to as the <firstterm>BIOS</firstterm>, or <literal>Basic Input Output System</literal>, which is described in <xref linkend="BIOS-general" />. Newer systems, such as those sold with Windows 8, use a newer type called <firstterm>UEFI</firstterm> or <literal>Universal Extensible Firmware Interface</literal>, which is described in <xref linkend="UEFI-general" />.
+  </para>
+  <para>
+    In most cases, the Fedora installer will recognize other operating systems on your computer and create boot menu entries for them. If an operating system such as Windows is installed <emphasis>after</emphasis> Fedora, GRUB may be overwritten and require reinstallation. Some circumstances, such as missing menu entries, require refreshing of the menu entries. These tasks are explained in <xref linkend="BIOS" /> or <xref linkend="UEFI" />
+  </para>
+  <para>
+    The Guide also covers concerns regarding booting of specific operating systems. For information regarding booting of Fedora with Windows 8, refer to <xref linkend="UEFI-win" />. To learn about using Fedora on Apple hardware, read <xref linkend="UEFI-apple" />
+  </para>
+  <warning>
+    <title>Using <systemitem class="username">Root</systemitem> Safely</title>
+    <para>
+      Many of the procedures in this guide involve editing of files or execution of commands that can only be performed as <systemitem class="username">root</systemitem>.  The <systemitem class="username">root</systemitem> account should be used with educated caution and <emphasis>only when required</emphasis>. Your system can break or fail to boot if the account is misused.
+    </para>
+    <para>
+      If your normal user account is configured as an administrator, you can use <command>sudo</command> to enter your user password and execute privileged commands:
+    <screen>
+      <command>[fedorauser at localhost ~]$ sudo &lt;command&gt;</command>
+      [sudo] password for fedorauser:
+    </screen>
+    </para>
+    <para> 
+      You can also open a root shell using the root password <command>su</command>. The hyphen ( - ) in the example is important because it ensures that you will work in a root environment, and not act on normal user files with root privileges.
+      <screen>
+        <command>[fedorauser at localhost ~]$ su -</command>
+        Password:
+	[root at localhost ~]#
+      </screen>
+    </para>
+    <para>
+      The <literal>root prompt</literal> is always a hash ( # ) and a normal user prompt is always a dollar sign ( $ ).
+    </para>
+  </warning>
 </section>
diff --git a/en-US/UEFI_boot-apple.xml b/en-US/UEFI-apple.xml
similarity index 89%
copy from en-US/UEFI_boot-apple.xml
copy to en-US/UEFI-apple.xml
index d3d8cd6..cc1751a 100644
--- a/en-US/UEFI_boot-apple.xml
+++ b/en-US/UEFI-apple.xml
@@ -4,7 +4,7 @@
 %BOOK_ENTITIES;
 
 ]>
-<section id="multiboot-UEFI-apple">
+<section id="UEFI-apple">
   <title>Booting on Apple systems</title>
   <para />
 </section>
diff --git a/en-US/UEFI_boot-general.xml b/en-US/UEFI-general.xml
similarity index 88%
copy from en-US/UEFI_boot-general.xml
copy to en-US/UEFI-general.xml
index 6d82169..9d7058f 100644
--- a/en-US/UEFI_boot-general.xml
+++ b/en-US/UEFI-general.xml
@@ -4,7 +4,7 @@
 %BOOK_ENTITIES;
 
 ]>
-<section id="multiboot-UEFI-general">
+<section id="UEFI-general">
   <title>UEFI Basics</title>
   <para />
 </section>
diff --git a/en-US/UEFI_boot-win.xml b/en-US/UEFI-win.xml
similarity index 89%
copy from en-US/UEFI_boot-win.xml
copy to en-US/UEFI-win.xml
index 6b2477e..94afc1d 100644
--- a/en-US/UEFI_boot-win.xml
+++ b/en-US/UEFI-win.xml
@@ -4,7 +4,7 @@
 %BOOK_ENTITIES;
 
 ]>
-<section id="multiboot-UEFI-win">
+<section id="UEFI-win">
   <title>Booting with Windows</title>
   <para />
 </section>
diff --git a/en-US/UEFI_boot.xml b/en-US/UEFI.xml
similarity index 60%
copy from en-US/UEFI_boot.xml
copy to en-US/UEFI.xml
index 1ad4397..e359118 100644
--- a/en-US/UEFI_boot.xml
+++ b/en-US/UEFI.xml
@@ -4,17 +4,17 @@
 %BOOK_ENTITIES;
 
 ]>
-<section id="multiboot-UEFI">
+<section id="UEFI">
   <title>Multiboot on UEFI Systems</title>
   <para />
 
   <!-- General UEFI stuff; where grub lives, `uefibootmgr`, etc -->
-  <xi:include href="UEFI_boot-general.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="UEFI-general.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 
   <!-- Booting with windows -->
-  <xi:include href="UEFI_boot-win.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="UEFI-win.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   
   <!-- Booting on Apple systems -->
-  <xi:include href="UEFI_boot-apple.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="UEFI-apple.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 
 </section>

More information about the docs-commits mailing list