kern/46149: Multiboot man page does not mention how to boot with Grub2 ( patch included )

[emmanuel%libera.cc@localhost]

>Number:         46149
>Category:       kern
>Synopsis:       Multiboot man page does not mention how to boot with Grub2 ( 
>patch included )
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Mar 06 20:35:02 +0000 2012
>Originator:     Emmanuel Kasper
>Release:        5.1.2
>Organization:
My Org
>Environment:
NetBSD franz.libera.cc 5.1.2 NetBSD 5.1.2 (KVM) #1: Sat Feb 11 15:05:52 CET 
2012  manu@leonard:/home/manu/Projects/netbsd/src/sys/arch/i386/compile/obj/KVM 
i386

>Description:
NetBSD multiboot man page does not mention how to use the GRUB2 bootloader, 
which the most popular multiboot boot loader by now. Only GRUB legacy is 
mentioned.
This issue has been discussed in the following thread:
http://mail-index.netbsd.org/tech-kern/2011/09/13/msg011481.html
>How-To-Repeat:
man multiboot
>Fix:
Index: multiboot.8
===================================================================
RCS file: /cvsroot/src/share/man/man8/man8.i386/multiboot.8,v
retrieving revision 1.3
diff -u -r1.3 multiboot.8
--- multiboot.8 30 Apr 2008 13:10:57 -0000      1.3
+++ multiboot.8 6 Mar 2012 20:12:14 -0000
@@ -45,9 +45,7 @@
 .Cd options MULTIBOOT
 (the default in the
 .Sq GENERIC
-and
-.Sq GENERIC_LAPTOP
-configurations).
+configuration).
 .Pp
 Unlike when using the native boot loader, the
 .Nx
@@ -95,14 +93,29 @@
 .Sq root=wd0e .
 .El
 .Ss Booting with GRUB Legacy
-GRUB Legacy is the most popular bootloader that supports Multiboot.
 You can boot a
 .Nx
-kernel (assuming it is compiled with Multiboot support) with a line
+kernel with a line
 similar to the following one:
 .Bd -literal
 kernel (fd0)/netbsd.gz -c console=pc root=wd0e
 .Ed
+.Ss Booting with GRUB 2
+You can boot a
+.Nx
+kernel with the 
+following commands from the GRUB 2 prompt:
+.Bd -literal
+insmod ufs2
+set root=(hd0,msdos1)
+multiboot /netbsd
+.Ed
+.Pp
+Note that the kernel assumes the behavior of GRUB Legacy and drops the
+first argument. In order to pass extra arguments you should write:
+.Bd -literal
+multiboot /netbsd /netbsd console=pc root=wd0e
+.Ed
 .Sh SEE ALSO
 .Xr options 4
 .Sh HISTORY