Module Name:    src
Committed By:   pgoyette
Date:           Thu Jan 14 23:32:12 UTC 2021

Modified Files:
        src/share/man/man5: mk.conf.5

Log Message:
Initial attempt at documenting the KERNEL_DIR option.

XXX EXPERIMENTAL, Work-In-Progress ! XXX


To generate a diff of this commit:
cvs rdiff -u -r1.83 -r1.84 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.83 src/share/man/man5/mk.conf.5:1.84
--- src/share/man/man5/mk.conf.5:1.83	Tue Nov 10 21:47:49 2020
+++ src/share/man/man5/mk.conf.5	Thu Jan 14 23:32:12 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.83 2020/11/10 21:47:49 kamil Exp $
+.\"	$NetBSD: mk.conf.5,v 1.84 2021/01/14 23:32:12 pgoyette Exp $
 .\"
 .\"  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -182,6 +182,37 @@ unless run in
 .Sq expert
 mode
 .
+.It Sy KERNEL_DIR (EXPERIMENTAL)
+.YorN
+Indicates if a top-level directory
+.Sy /netbsd/
+is created.
+If
+.Dq yes ,
+the directory will contain a kernel file
+.Pa /netbsd/kernel
+and a corresponding modules directory
+.Pa /netbsd/modules/ .
+System bootstrap procedures will be modified to search for the kernel
+and modules in the
+.Pa /netbsd/
+directory.
+This is intended to simplify system upgrade and rollback procedures by
+keeping the kernel and its associated modules together in one place.
+.Pp
+If
+.Dq no ,
+the kernel file will be stored in
+.Pa /netbsd
+and the modules will be stored within the
+.Pa /stand/${ARCH}/
+directory hierarchy.
+.Pp
+The
+.Sy KERNEL_DIR
+option is a work-in-progress, and is highly experimental.
+It is also subject to change without notice.
+.DFLTn
 .It Sy MAKEVERBOSE
 Level of verbosity of status messages.
 Supported values:

Reply via email to