[grub2] update README.Fedora (#734090)

[Peter Jones]

commit 21d845a6c3e6b3f2292d10ccf304e9148be90463
Author: Mads Kiilerich <mads at kiilerich.com>
Date:   Thu Oct 27 17:09:00 2011 +0200

    update README.Fedora (#734090)

 README.Fedora |   67 ++++++++++++++++++++++++++++++++++++--------------------
 1 files changed, 43 insertions(+), 24 deletions(-)
---
diff --git a/README.Fedora b/README.Fedora
index ccfe58e..3313a5a 100644
--- a/README.Fedora
+++ b/README.Fedora
@@ -1,44 +1,63 @@
 Using GNU GRUB 2 in Fedora
 ==========================
 
-Though GRUB 2 provides various feature enhancements over previous GRUB
-version (referred to as "GRUB", or "GRUB Legacy"), it did not reach its
-stability and feature completness yet, and thus is not ready to replace
-it for the whole user base. This package is primarily intended to
-encourage testing and accelerate distribution integration.
-
-It is generally safe to install the package. It is able to co-exist with
-existing GRUB installation and adds itself to the GRUB menu upon
-installation, so you'll able to select GRUB 2 from GRUB menu during
-the boot.
+GRUB 2 provides various feature enhancements over the previous GRUB version
+(referred to as "GRUB", or "GRUB Legacy") which has been unmaintained upstream
+for years. GRUB has thus been deprecated in Fedora and replaced by GRUB 2 for
+BIOS systems. (EFI systems still uses GRUB Legacy from the new grub-efi package.)
 
 Utilities
 ---------
 
-The GRUB 2 utilities are prefixed (or postfixed) with 'grub2':
+The GRUB 2 utilities are prefixed with 'grub2':
 
+grub2-bin2h
 grub2-editenv
-grub2-mkimage
-grub2-mkelfimage
-grub2-mkrescue
-grub2-emu
+grub2-fstest
 grub2-install
+grub2-kbdcomp
+grub2-menulst2cfg
+grub2-mkconfig
 grub2-mkdevicemap
+grub2-mkfont
+grub2-mkimage
+grub2-mklayout
+grub2-mknetdir
+grub2-mkpasswd-pbkdf2
+grub2-mkrelpath
+grub2-mkrescue
 grub2-probe
+grub2-reboot
+grub2-script-check
+grub2-set-default
 grub2-setup
-update-grub2
 
-Documentation
--------------
+The default location for boot loader installation is /boot/grub2/ .
 
-The GRUB 2 lacks documentation. While you are encouraged to contribute
-the documentation, you can use the GRUB 2 Wiki [1] as primary source of
-information pertaining to this development snapshot.
+GRUB 2 in Fedora
+----------------
 
-[1] http://grub.enbug.org/
+The Fedora installer (anaconda) will make sure grub2 is installed for new and
+updated systems. It will write /etc/default/grub and run grub2-mkconfig to
+create /boot/grub2/grub.cfg, and it will run grub2-install to install the boot
+loader in the MBR and in /boot/grub2/ .
+
+grubby will patch grub.cfg (through /etc/grub2.cfg) when new kernels are
+installed. The GRUB 2 configuration system in /etc/default/grub and /etc/grub.d/
+is thus only used initially by anaconda, but it is possible to generate a new
+grub.cfg with:
+
+  grub2-mkconfig -o /boot/grub2/grub.cfg
+
+The active boot loader will not be changed when the GRUB 2 package is updated.
+A new boot loader can be installed with something like:
+
+  grub2-install /dev/sda
+
+Documentation
+-------------
 
-If you intend to install grub2 as your primary boot loader refer to
-the GRUB 2 Wiki for information on how to set it up.
+The GRUB 2 manual can be found on http://www.gnu.org/software/grub/manual/ .
 
 Support channels
 ----------------