[src/trunk]: src/share/man/man5 PR# port-i386/39463: boot.cfg(8) does not men...

[jmcneill <jmcneill%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f5a63d252c44
branches:  trunk
changeset: 747396:f5a63d252c44
user:      jmcneill <jmcneill%NetBSD.org@localhost>
date:      Sun Sep 13 18:39:20 2009 +0000

description:
PR# port-i386/39463: boot.cfg(8) does not mention about relative path for
        the 'load' option

Document the search behaviour of the 'load' directive when an absolute
path is not specified.

diffstat:

 share/man/man5/boot.cfg.5 |  12 +++++++++---
 1 files changed, 9 insertions(+), 3 deletions(-)

diffs (33 lines):

diff -r b215ecdf485d -r f5a63d252c44 share/man/man5/boot.cfg.5
--- a/share/man/man5/boot.cfg.5 Sun Sep 13 18:30:30 2009 +0000
+++ b/share/man/man5/boot.cfg.5 Sun Sep 13 18:39:20 2009 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: boot.cfg.5,v 1.16 2009/09/04 10:34:16 wiz Exp $
+.\"    $NetBSD: boot.cfg.5,v 1.17 2009/09/13 18:39:20 jmcneill Exp $
 .\"
 .\" Copyright (c) 2007 Stephen Borrill
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 4, 2009
+.Dd September 13, 2009
 .Dt BOOT.CFG 5
 .Os
 .Sh NAME
@@ -93,7 +93,13 @@
 .It Sy load
 Used to load kernel modules, which will be passed on to the kernel for
 initialization during early boot.
-The argument is the complete path and file name of the module to be loaded.
+The argument is either the complete path and file name of the module to be
+loaded, or a symbolic module name.
+When the argument is not an absolute path, the boot loader will first
+attempt to load
+.Pa /stand/<machine>/<kernel_version>/modules/<name>/<name>.kmod .
+If that file does not exist, it will then attempt to load
+.Pa /<name> .
 May be used as many times as needed.
 .It Sy menu
 (may be present multiple times)