update README.Fedora (#734090)

README.Fedora

@@ -1,44 +1,63 @@
 Using GNU GRUB 2 in Fedora
 ==========================
 
-Though GRUB 2 provides various feature enhancements over previous GRUB
+GRUB 2 provides various feature enhancements over the previous GRUB version
-version (referred to as "GRUB", or "GRUB Legacy"), it did not reach its
+(referred to as "GRUB", or "GRUB Legacy") which has been unmaintained upstream
-stability and feature completness yet, and thus is not ready to replace
+for years. GRUB has thus been deprecated in Fedora and replaced by GRUB 2 for
-it for the whole user base. This package is primarily intended to
+BIOS systems. (EFI systems still uses GRUB Legacy from the new grub-efi package.)
-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.
 
 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-fstest
-grub2-mkelfimage
-grub2-mkrescue
-grub2-emu
 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
+
+The default location for boot loader installation is /boot/grub2/ .
+
+GRUB 2 in Fedora
+----------------
+
+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
 -------------
 
-The GRUB 2 lacks documentation. While you are encouraged to contribute
+The GRUB 2 manual can be found on http://www.gnu.org/software/grub/manual/ .
-the documentation, you can use the GRUB 2 Wiki [1] as primary source of
-information pertaining to this development snapshot.
-
-[1] http://grub.enbug.org/
-
-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.
 
 Support channels
 ----------------