aboutsummaryrefslogtreecommitdiff
path: root/share/man/man5
diff options
context:
space:
mode:
authorEd Maste <emaste@FreeBSD.org>2023-05-14 14:17:59 +0000
committerEd Maste <emaste@FreeBSD.org>2023-05-14 14:17:59 +0000
commitb46d461d59b78ee189f195e18b82dd31654eefb3 (patch)
treef4abb464e1e5514eba94377ec552b9028d44062d /share/man/man5
parentddea995ddc08eb7988867989db0a9afe0ae1cd52 (diff)
downloadsrc-b46d461d59b78ee189f195e18b82dd31654eefb3.tar.gz
src-b46d461d59b78ee189f195e18b82dd31654eefb3.zip
src.conf.5: regen
Fixes: df9974197e46 ("Add description of WITH_META_ERROR_TARGET") Fixes: 2b519b170709 ("Update description of WITH_DIRDEPS_BUILD") Fixes: 722cfce5f494 ("Fix typo and use .Fx in WITH_DIRDEPS_BUILD") Sponsored by: The FreeBSD Foundation
Diffstat (limited to 'share/man/man5')
-rw-r--r--share/man/man5/src.conf.530
1 files changed, 28 insertions, 2 deletions
diff --git a/share/man/man5/src.conf.5 b/share/man/man5/src.conf.5
index 83dd10f18164..d610fc5a70bf 100644
--- a/share/man/man5/src.conf.5
+++ b/share/man/man5/src.conf.5
@@ -1,5 +1,5 @@
.\" DO NOT EDIT-- this file is @generated by tools/build/options/makeman.
-.Dd May 12, 2023
+.Dd May 14, 2023
.Dt SRC.CONF 5
.Os
.Sh NAME
@@ -488,7 +488,7 @@ When set, it enforces these options:
.It Va WITHOUT_DICT
Do not build the Webster dictionary files.
.It Va WITH_DIRDEPS_BUILD
-This is an experimental build system.
+This is an alternate build system.
For details see
https://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
Build commands can be seen from the top-level with:
@@ -522,7 +522,14 @@ The build hides commands executed unless
is defined.
.Pp
Note that there is currently no mass install feature for this.
+This build is designed for producing packages, that can then be installed
+on a target system.
.Pp
+The implementation in
+.Fx
+is incomplete.
+Completion would require leaf directories for building each kernel
+and package so that their dependencies can be tracked.
When set, it enforces these options:
.Pp
.Bl -item -compact
@@ -1161,6 +1168,25 @@ Do not build utilities for manual pages,
.Xr whatis 1 ,
.Xr manctl 8 ,
and related support files.
+.It Va WITH_META_ERROR_TARGET
+Enable the META_MODE .ERROR target.
+.Pp
+This target will copy the meta file of a failed target
+to
+.Va ERROR_LOGDIR
+(default is
+.Ql ${SRCTOP:H}/error )
+to help with failure analysis.
+Depends on
+.Va WITH_META_MODE .
+This default when
+.Va WITH_DIRDEPS_BUILD
+is set.
+.Pp
+This must be set in the environment, make command line, or
+.Pa /etc/src-env.conf ,
+not
+.Pa /etc/src.conf .
.It Va WITH_META_MODE
Create
.Xr make 1