conf/161017: [patch] add a helpful blurb about PORTS_MODULES to build(7)

[Garrett Cooper]

>Number:         161017
>Category:       conf
>Synopsis:       [patch] add a helpful blurb about PORTS_MODULES to build(7)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Sep 25 19:10:08 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Garrett Cooper
>Release:        9.0-BETA2
>Organization:
n/a
>Environment:
n/a
>Description:
PORTS_MODULES is a very handy knob for folks that build kernels from source that allows one to specify a list of ports to build and install when running buildkernel and installkernel. It should be documented for power users to help improve the source upgrade process.

The attached patch adds a blurb to build(7) about PORTS_MODULES.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: share/man/man7/build.7
===================================================================
--- share/man/man7/build.7	(revision 225704)
+++ share/man/man7/build.7	(working copy)
@@ -414,6 +414,15 @@
 .It Va LOCAL_DIRS
 If set, this variable supplies a list of additional directories to
 build, relative to the root of the source tree.
+.It Va PORTS_MODULES
+A list of ports with kernel modules to build and install when running
+.Cm buildkernel
+and
+.Cm installkernel ,
+respectively (or any of the variants of the beforementioned targets), e.g.
+.Bd -literal -offset indent
+make PORTS_MODULES=emulators/kqemu-kmod kernel
+.Ed
 .It Va SUBDIR_OVERRIDE
 Override the default list of sub-directories and only build the
 sub-directory named in this variable.


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