Document src-env.conf and note its use for MAKEOBJDIRPREFIX and WITH_META_MDOE.

Sponsored by:	EMC / Isilon Storage Division

2 files changed, 18 insertions, 0 deletions

diff --git a/tools/build/options/WITH_META_MODE b/tools/build/options/WITH_META_MODE
index b255777956bc..88402a464466 100644
--- a/tools/build/options/WITH_META_MODE
+++ b/tools/build/options/WITH_META_MODE
@@ -25,6 +25,11 @@ If
 is available the meta file will also capture a record of files
 used to produce the target by tracking syscalls.
 .Pp
+This must be set in the environment or
+.Pa /etc/src-env.conf ,
+not
+.Pa /etc/src.conf .
+.Pp
 The build will hide commands ran unless
 .Va NO_SILENT
 is defined.
diff --git a/tools/build/options/makeman b/tools/build/options/makeman
index 4247ff23b3d9..ef469e1751b5 100755
--- a/tools/build/options/makeman
+++ b/tools/build/options/makeman
@@ -188,6 +188,18 @@ option of
 or in its environment; see
 .Xr environ 7 .
 .Pp
+The environment of
+.Xr make 1
+for the build can be controlled via the
+.Va SRC_ENV_CONF
+variable, which defaults to
+.Pa /etc/src-env.conf .
+Some examples that may only be set in this file are
+.Va MAKEOBJDIRPREFIX ,
+and
+.Va WITH_META_MODE
+as they are environment-only variables.
+.Pp
 The values of variables are ignored regardless of their setting;
 even if they would be set to
 .Dq Li FALSE
@@ -284,6 +296,7 @@ EOF
 .Sh FILES
 .Bl -tag -compact -width Pa
 .It Pa /etc/src.conf
+.It Pa /etc/src-env.conf
 .It Pa /usr/share/mk/bsd.own.mk
 .El
 .Sh SEE ALSO