Building Less?

[Russell Haley]

Okay, here is the diff for the changes above. I didn't re-build as Mr.
Gurney said he would validate and commit . Can I suggest/submit some other
changes to the build (7) page (that I will test myself)? Also the
fdp-primer says in chapter 3.1 that the doc project owns man pages and then
I couldn't find another single reference to them again.

Much thanks!
Russ

On Mon, Sep 28, 2015 at 9:08 PM, Warner Losh <imp at bsdimp.com> wrote:

> That's a good place to start.
>
> Warner
>
> On Mon, Sep 28, 2015 at 9:56 PM, Russell Haley <russ.haley at gmail.com>
> wrote:
>
>> Do I follow this?
>>
>> https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/
>>
>> Thanks,
>>
>> Russ
>>
>> On Mon, Sep 28, 2015 at 9:29 AM, John-Mark Gurney <jmg at funkthat.com>
>> wrote:
>>
>>> Russell Haley wrote this message on Sun, Sep 27, 2015 at 21:21 -0700:
>>> > The option should be included in the man pages for build:
>>> >
>>> >
>>> https://www.freebsd.org/cgi/man.cgi?query=build&sektion=7&apropos=0&manpath=FreeBSD+10.2-RELEASE
>>>
>>> [great additions]
>>>
>>> I agree that this needs better documentation...  If you send me a patch,
>>> I'll make sure it's marked up properly and committed...
>>>
>>> Thanks!
>>>
>>> > On Sun, Sep 27, 2015 at 9:06 PM, Warner Losh <imp at bsdimp.com> wrote:
>>> >
>>> > > src.conf is only used to build /usr/src. src.con(5) documents that.
>>> > > build(5) has a pointer.
>>> > >
>>> > > How would you suggest making this clearer?
>>>
>>> --
>>>   John-Mark Gurney                              Voice: +1 415 225 5579
>>>
>>>      "All that I will do, has been done, All that I have, has not."
>>>
>>
>>
>
-------------- next part --------------
Index: man5/src.conf.5
===================================================================
--- man5/src.conf.5	(revision 288164)
+++ man5/src.conf.5	(working copy)
@@ -10,7 +10,7 @@
 .Sh DESCRIPTION
 The
 .Nm
-file contains settings that will apply to every build involving the
+file contains variables that control what components will be generated for all builds involving the
 .Fx
 source tree; see
 .Xr build 7 .
Index: man7/build.7
===================================================================
--- man7/build.7	(revision 288164)
+++ man7/build.7	(working copy)
@@ -102,7 +102,11 @@
 variables described in the
 .Sx ENVIRONMENT
 section below, and by the variables documented in
-.Xr make.conf 5 .
+.Xr make.conf 5 . 
+The default components included in the build are specified in the file 
+/etc/src.conf in the source tree. To override the default file, include 
+the SRCCONF option in the make steps, pointing to a custom src.conf 
+file. For more information see src.conf.
 .Pp
 The following list provides the names and actions for the targets
 supported by the build system:
@@ -445,6 +449,9 @@
 .Bd -literal -offset indent
 make PORTS_MODULES=emulators/kqemu-kmod kernel
 .Ed
+.It Va SRCCONF
+Specify a file to override the default /etc/src.conf. The src.conf file controls the components to build. See 
+.Xr SRC.CONF 5
 .It Va STRIPBIN
 Command to use at install time when stripping binaries.
 Be sure to add any additional tools required to run