docs/187613: [PATCH] Improve boot section in handbook

[Fernando]

>Number:         187613
>Category:       docs
>Synopsis:       [PATCH] Improve boot section in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Mar 15 19:00:00 UTC 2014
>Closed-Date:
>Last-Modified:
>Originator:     Fernando
>Release:        9.1-RELEASE
>Organization:
>Environment:
FreeBSD beastie 9.1-RELEASE-p3 FreeBSD 9.1-RELEASE-p3 #0: Tue Jun 11 18:21:20 CEST 2013     root at beastie:/usr/obj/usr/src/sys/APEKERNEL-9.1  amd64

>Description:
In the handbook, there is missing information about how the boot loader searches for files with the boot and load commands[1].

The proposed patch adds some hints about how those files are looked for. Specifically, we should inform that if the name is not qualified, it will be searched under /boot/kernel and /boot/modules.

[1] http://www.freebsd.org/doc/en/books/handbook/boot-blocks.html
>How-To-Repeat:

>Fix:
Apply the attached patch.

If this patch gets committed I can write another one for the Spanish manual since that's my mother tongue.

Patch attached with submission follows:

Index: chapter.xml
===================================================================
--- chapter.xml	(revision 44236)
+++ chapter.xml	(working copy)
@@ -377,7 +377,10 @@
 		name on the command-line is only applicable after an
 		<emphasis>unload</emphasis> command has been issued;
 		otherwise the previously-loaded kernel will be
-		used.</para>
+		used.  If <emphasis>kernelname</emphasis> is not
+		qualified it will be searched under
+		<emphasis>/boot/kernel</emphasis> and
+		<emphasis>/boot/modules</emphasis></para>
 	    </listitem>
 	  </varlistentry>
 
@@ -425,7 +428,11 @@
 	      <para>Loads the kernel, kernel module, or file of the
 		type given, with the specified filename.  Any
 		arguments after <replaceable>filename</replaceable>
-		are passed to the file.</para>
+		are passed to the file.  If
+		<emphasis>filename</emphasis> is not qualified it
+		will be searched under
+		<emphasis>/boot/kernel</emphasis>
+		and <emphasis>/boot/modules</emphasis></para>
 	    </listitem>
 	  </varlistentry>
 


>Release-Note:
>Audit-Trail:
>Unformatted: