docs/158992: loader.conf man page

[John Baldwin]

On Sunday, July 17, 2011 5:27:58 am wayne mitchell wrote:
> 
> >Number:         158992
> >Category:       docs
> >Synopsis:       loader.conf man page
> >Confidential:   no
> >Severity:       non-critical
> >Priority:       low
> >Responsible:    freebsd-doc
> >State:          open
> >Quarter:        
> >Keywords:       
> >Date-Required:
> >Class:          doc-bug
> >Submitter-Id:   current-users
> >Arrival-Date:   Sun Jul 17 09:30:12 UTC 2011
> >Closed-Date:
> >Last-Modified:
> >Originator:     wayne mitchell
> >Release:        8.1-RELEASE
> >Organization:
> >Environment:
> FreeBSD 8.1-RELEASE FreeBSd 8.1-RELEASE #(date) 
root at mason.cse.buffalo.edu:/usr/obj/sys/GENERIC amd64
> >Description:
> man page for loader.conf shows values to set with examples
> value for 'kernel' is incorrect
> man page shows:
> 
> kernel  (''/boot/kernel/kernel'')
> 
> this does not work, the system prepends this value with the /boot/kernel/ 
path value, which would give /boot/kernel//boot/kernel/kernel
> not sure what purpose this value has as the system boots with the standard 
kernel even when this value is incorrect - though it does knock out the module 
loading 

The default value is actually "kernel".  You can set it to, e.g. "test" to 
boot from /boot/test/kernel (and modules from /boot/test).

How about this:

Index: loader.conf.5
===================================================================
--- loader.conf.5	(revision 224058)
+++ loader.conf.5	(working copy)
@@ -107,6 +107,9 @@ present file.
 Name of the kernel to be loaded.
 If no kernel name is set, no additional
 modules will be loaded.
+The name must be a subdirectory of
+.Pa /boot
+that contains a kernel.
 .It Ar kernel_options
 Flags to be passed to the kernel.
 .It Ar password
@@ -190,7 +193,7 @@ replacing it with
 .Dq spinning
 character (useful for embedded products and such).
 .It Va kernel
-.Pq Dq Pa /boot/kernel/kernel
+.Pq Dq kernel
 .It Va loader_conf_files
 .Pq Dq Pa /boot/loader.conf /boot/loader.conf.local
 .It Va splash_bmp_load

-- 
John Baldwin