git: b46d461d59b7 - main - src.conf.5: regen

The branch main has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=b46d461d59b78ee189f195e18b82dd31654eefb3

commit b46d461d59b78ee189f195e18b82dd31654eefb3
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2023-05-14 14:17:59 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2023-05-14 14:17:59 +0000

    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
---
 share/man/man5/src.conf.5 | 30 ++++++++++++++++++++++++++++--
 1 file 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