https://bugzilla.redhat.com/show_bug.cgi?id=2033158
Bug ID: 2033158
Summary: Grub documentation out of date in System
Administration Guide
Product: Fedora Documentation
Version: devel
Status: NEW
Component: system-administrator's-guide
Assignee: pbokoc(a)redhat.com
Reporter: fedora(a)chrisirwin.ca
QA Contact: docs-qa(a)lists.fedoraproject.org
CC: swadeley(a)redhat.com
Target Milestone: ---
Classification: Fedora
Description of problem:
Grub2 documentation is out of date in System Administrators Guide.
It explains how grub was configured in previous releases, but doesn't explain
the current configuration and tools sufficiently/
* systemd Boot Loader Specification (/boot/loader/entries)
* grubby description is inaccurate (it says it edits grub.cfg, while it looks
like it now edits /boot/loader/entries/*conf files)
* location of grub config (/boot/grub2/grub.cfg, even on EFI systems now)
* menuentries in grub.cfg (not used now)
* Gives instruction to `grub2-mkconfig -o /boot/efi/EFI/fedora/grub.cfg`
several times, but that is not the proper location now
* Above command is given for "Editing a Menu Entry" to change kernel command
args, but it doesn't do that any more. grubby must be used for that task.
Version-Release number of selected component (if applicable):
Fedora 35 Documentation:
https://docs.fedoraproject.org/en-US/fedora/f35/system-administrators-gui...
Rawhide documentation appears the same.
How reproducible:
It's documentation, so every time.
Steps to Reproduce:
1. Look at Fedora documentation to see where kernel menuentries are defined
2. Documentation says /boot/efi/EFI/fedora/grub.cfg
3. That is not correct.
Actual results:
1. /boot/efi/EFI/fedora/grub.cfg is only a stub to load /boot/grub2/grub.cfg,
even on EFI systems (documentation says this file is BIOS only)
2. No kernel menu entries are defined there, either
3. Kernel menu entries defined in /boot/loader/entries/*conf files, and
probed by grub via unknown mechanism
Expected results:
Expected documentation to match and explain grub configuration on a current
Fedora system.
Additional info:
--
You are receiving this mail because:
You are the QA Contact for the bug.
https://bugzilla.redhat.com/show_bug.cgi?id=2033158