Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 328679

Summary: handbook describes grub legacy, but points to grub2 documentation
Product: [OLD] Docs on Reporter: Andrew Winkler <a>
Component: Installation HandbookAssignee: nm (RETIRED) <nightmorph>
Severity: normal CC: docs-team
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Package list:
Runtime testing required: ---

Description Andrew Winkler 2010-07-16 23:02:42 UTC
gentoo is using grub legacy, but the documentation link points to the grub2 documentation on the gnu site.  Either the continued use of grub legacy is a bug, or pointing to grub2 documentation is.

Reproducible: Always

Steps to Reproduce:
1. read the grub documentation in the install (grub.conf)
2. follow the link to gnu, to learn more
3. notice that it documents grub2 (grub.cnf)

Actual Results:  
as described

Expected Results:  
grub legacy documentation, matching the use of grub legacy in gentoo

I don't know how to describe the severity. It's probably a feature request, since grub legacy is atrophying.
Comment 1 nm (RETIRED) gentoo-dev 2010-07-16 23:11:08 UTC
It's neither one of those things.

What happened was that rearranged their internal documentation so that the manual/ directory points to grub2, rather than grub legacy. grub2 has serious issues, and will not be the default bootloader for most linux distributions for some time. That includes Gentoo -- it's still hardmasked, in fact.

I'll fix up the links to point to someplace more sensible for grub-0.xx stuff.
Comment 2 nm (RETIRED) gentoo-dev 2010-07-16 23:19:33 UTC
Thanks for reporting. Fixed the handbook and the FAQ for the right links.