docs/158992: loader.conf man page

[John Baldwin]

The following reply was made to PR docs/158992; it has been noted by GNATS.

From: John Baldwin <jhb at freebsd.org>
To: freebsd-doc at freebsd.org
Cc: wayne mitchell <wayne.mitchell.iz at gmail.com>,
 freebsd-gnats-submit at freebsd.org
Subject: Re: docs/158992: loader.conf man page
Date: Mon, 18 Jul 2011 13:15:45 -0400

 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