From owner-freebsd-doc@FreeBSD.ORG Sat Mar 15 19:00:00 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.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 9C7C0357 for ; Sat, 15 Mar 2014 19:00:00 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 79642A2B for ; Sat, 15 Mar 2014 19:00:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.8/8.14.8) with ESMTP id s2FJ00KG068978 for ; Sat, 15 Mar 2014 19:00:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.8/8.14.8/Submit) id s2FJ00Br068977; Sat, 15 Mar 2014 19:00:00 GMT (envelope-from gnats) Resent-Date: Sat, 15 Mar 2014 19:00:00 GMT Resent-Message-Id: <201403151900.s2FJ00Br068977@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Fernando 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 ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Subject: docs/187613: [PATCH] Improve boot section in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 15 Mar 2014 19:00:00 -0000 >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@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 unload command has been issued; otherwise the previously-loaded kernel will be - used. + used. If kernelname is not + qualified it will be searched under + /boot/kernel and + /boot/modules @@ -425,7 +428,11 @@ Loads the kernel, kernel module, or file of the type given, with the specified filename. Any arguments after filename - are passed to the file. + are passed to the file. If + filename is not qualified it + will be searched under + /boot/kernel + and /boot/modules >Release-Note: >Audit-Trail: >Unformatted: