From nobody@FreeBSD.org  Sat Mar 15 18:57:18 2014
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id 5E85E34A
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 15 Mar 2014 18:57:18 +0000 (UTC)
Received: from cgiserv.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id 4BB53A20
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 15 Mar 2014 18:57:18 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by cgiserv.freebsd.org (8.14.8/8.14.8) with ESMTP id s2FIvH88004291
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 15 Mar 2014 18:57:17 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.8/8.14.8/Submit) id s2FIvHf1004290;
	Sat, 15 Mar 2014 18:57:17 GMT
	(envelope-from nobody)
Message-Id: <201403151857.s2FIvHf1004290@cgiserv.freebsd.org>
Date: Sat, 15 Mar 2014 18:57:17 GMT
From: Fernando <fernando.apesteguia@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [PATCH] Improve boot section in handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         187613
>Category:       docs
>Synopsis:       [handbook] [patch] Improve boot section in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jgh
>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:  Sun Mar 16 01:58:48 UTC 2014
>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@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:
Responsible-Changed-From-To: freebsd-doc->jgh 
Responsible-Changed-By: jgh 
Responsible-Changed-When: Sun Mar 16 01:58:48 UTC 2014 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=187613 
>Unformatted:
