From nobody@FreeBSD.org  Sun Sep 25 19:03:21 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 0CE1A1065670
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 25 Sep 2011 19:03:21 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id F1A878FC0C
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 25 Sep 2011 19:03:20 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p8PJ3KnZ071668
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 25 Sep 2011 19:03:20 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p8PJ3K4Q071665;
	Sun, 25 Sep 2011 19:03:20 GMT
	(envelope-from nobody)
Message-Id: <201109251903.p8PJ3K4Q071665@red.freebsd.org>
Date: Sun, 25 Sep 2011 19:03:20 GMT
From: Garrett Cooper <yaneurabeya@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] add a helpful blurb about PORTS_MODULES to build(7)
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         161017
>Category:       docs
>Synopsis:       [patch] add a helpful blurb about PORTS_MODULES to build(7)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Sep 25 19:10:08 UTC 2011
>Closed-Date:    Mon Oct 10 11:18:33 UTC 2011
>Last-Modified:  Sun Feb 03 22:29:33 UTC 2013
>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:
State-Changed-From-To: open->patched 
State-Changed-By: gjb 
State-Changed-When: Thu Sep 29 02:52:50 UTC 2011 
State-Changed-Why:  
Patched in HEAD with minor changes.  MFC in 1 week. 



Responsible-Changed-From-To: freebsd-bugs->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Thu Sep 29 02:52:50 UTC 2011 
Responsible-Changed-Why:  
Over to me. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=161017 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/161017: commit references a PR
Date: Thu, 29 Sep 2011 02:52:48 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Thu Sep 29 02:52:33 2011
 New Revision: 225858
 URL: http://svn.freebsd.org/changeset/base/225858
 
 Log:
   Document, and provide an example for, PORTS_MODULES in build(7).
   
   PR:		161017
   Submitted by:	gcooper
   MFC after:	1 week
 
 Modified:
   head/share/man/man7/build.7
 
 Modified: head/share/man/man7/build.7
 ==============================================================================
 --- head/share/man/man7/build.7	Thu Sep 29 02:29:32 2011	(r225857)
 +++ head/share/man/man7/build.7	Thu Sep 29 02:52:33 2011	(r225858)
 @@ -414,6 +414,16 @@ is set to the value of 
  .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 that should be built and installed
 +as part of the
 +.Cm buildkernel
 +and
 +.Cm installkernel
 +process.
 +.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.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Mon Oct 10 11:18:09 UTC 2011 
State-Changed-Why:  
MFC'd to 9-STABLE, 8-STABLE, 7-STABLE.  Thanks! 


http://www.freebsd.org/cgi/query-pr.cgi?pr=161017 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/161017: commit references a PR
Date: Mon, 10 Oct 2011 11:14:17 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Mon Oct 10 11:14:03 2011
 New Revision: 226193
 URL: http://svn.freebsd.org/changeset/base/226193
 
 Log:
   MFC r225858, 225859, 226172:
   
   225858:
    - Document and provide an example for PORTS_MODULES [1]
   
   225859:
    - Whitespace cleanup
   
   226172:
    - Bump date
   
   PR:		161017 [1]
   Approved by:	re (kib)
 
 Modified:
   stable/9/share/man/man7/build.7
 Directory Properties:
   stable/9/share/man/man7/   (props changed)
 
 Modified: stable/9/share/man/man7/build.7
 ==============================================================================
 --- stable/9/share/man/man7/build.7	Mon Oct 10 11:12:40 2011	(r226192)
 +++ stable/9/share/man/man7/build.7	Mon Oct 10 11:14:03 2011	(r226193)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd June 16, 2011
 +.Dd September 29, 2011
  .Dt BUILD 7
  .Os
  .Sh NAME
 @@ -238,7 +238,7 @@ This command takes a long time.
  Get updated sources as configured in
  .Xr make.conf 5 .
  .It Cm targets
 -Print a list of supported 
 +Print a list of supported
  .Va TARGET
  /
  .Va TARGET_ARCH
 @@ -399,21 +399,31 @@ It defaults to
  .It Va KERNFAST
  If set, the build target
  .Cm buildkernel
 -defaults to setting 
 +defaults to setting
  .Va NO_KERNELCLEAN ,
  .Va NO_KERNELCONFIG ,
 -.Va NO_KERNELDEPEND 
 +.Va NO_KERNELDEPEND
  and
  .Va NO_KERNELOBJ .
  When set to a value other than
  .Cm 1
 -then 
 -.Va KERNCONF 
 -is set to the value of 
 +then
 +.Va KERNCONF
 +is set to the value of
  .Va KERNFAST .
  .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 that should be built and installed
 +as part of the
 +.Cm buildkernel
 +and
 +.Cm installkernel
 +process.
 +.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.
 @@ -442,11 +452,11 @@ output.
  Set this to cross-build for a different architecture.
  If not set,
  .Va TARGET_ARCH
 -defaults to the current machine architecture, unless 
 +defaults to the current machine architecture, unless
  .Va TARGET
  is also set, in which case it defaults to the appropriate
  value for that platform.
 -Typically, one only needs to set 
 +Typically, one only needs to set
  .Va TARGET .
  .El
  .Pp
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/161017: commit references a PR
Date: Mon, 10 Oct 2011 11:15:13 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Mon Oct 10 11:14:44 2011
 New Revision: 226194
 URL: http://svn.freebsd.org/changeset/base/226194
 
 Log:
   MFC r225858, 225859, 226172:
   
   225858:
    - Document and provide an example for PORTS_MODULES [1]
   
   225859:
    - Whitespace cleanup
   
   226172:
    - Bump date
   
   PR:		161017 [1]
 
 Modified:
   stable/8/share/man/man7/build.7
 Directory Properties:
   stable/8/share/man/man7/   (props changed)
   stable/8/share/man/man7/ports.7   (props changed)
 
 Modified: stable/8/share/man/man7/build.7
 ==============================================================================
 --- stable/8/share/man/man7/build.7	Mon Oct 10 11:14:03 2011	(r226193)
 +++ stable/8/share/man/man7/build.7	Mon Oct 10 11:14:44 2011	(r226194)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd February 10, 2011
 +.Dd September 29, 2011
  .Dt BUILD 7
  .Os
  .Sh NAME
 @@ -365,21 +365,31 @@ It defaults to
  .It Va KERNFAST
  If set, the build target
  .Cm buildkernel
 -defaults to setting 
 +defaults to setting
  .Va NO_KERNELCLEAN ,
  .Va NO_KERNELCONFIG ,
 -.Va NO_KERNELDEPEND 
 +.Va NO_KERNELDEPEND
  and
  .Va NO_KERNELOBJ .
  When set to a value other than
  .Cm 1
 -then 
 -.Va KERNCONF 
 -is set to the value of 
 +then
 +.Va KERNCONF
 +is set to the value of
  .Va KERNFAST .
  .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 that should be built and installed
 +as part of the
 +.Cm buildkernel
 +and
 +.Cm installkernel
 +process.
 +.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.
 @@ -408,11 +418,11 @@ output.
  Set this to cross-build for a different architecture.
  If not set,
  .Va TARGET_ARCH
 -defaults to the current machine architecture, unless 
 +defaults to the current machine architecture, unless
  .Va TARGET
  is also set, in which case it defaults to the appropriate
  value for that platform.
 -Typically, one only needs to set 
 +Typically, one only needs to set
  .Va TARGET .
  .El
  .Pp
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/161017: commit references a PR
Date: Mon, 10 Oct 2011 11:16:05 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Mon Oct 10 11:15:57 2011
 New Revision: 226195
 URL: http://svn.freebsd.org/changeset/base/226195
 
 Log:
   MFC r225858, 225859, 226172:
   
   225858:
    - Document and provide an example for PORTS_MODULES [1]
   
   225859:
    - Whitespace cleanup
   
   226172:
    - Bump date
   
   PR:		161017 [1]
 
 Modified:
   stable/7/share/man/man7/build.7
 Directory Properties:
   stable/7/share/man/man7/   (props changed)
   stable/7/share/man/man7/ports.7   (props changed)
 
 Modified: stable/7/share/man/man7/build.7
 ==============================================================================
 --- stable/7/share/man/man7/build.7	Mon Oct 10 11:14:44 2011	(r226194)
 +++ stable/7/share/man/man7/build.7	Mon Oct 10 11:15:57 2011	(r226195)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd March 31, 2010
 +.Dd September 29, 2011
  .Dt BUILD 7
  .Os
  .Sh NAME
 @@ -352,6 +352,16 @@ variables:
  .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 that should be built and installed
 +as part of the
 +.Cm buildkernel
 +and
 +.Cm installkernel
 +process.
 +.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.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
