From nobody Sun May 14 14:19:26 2023 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QK4Pq29YZz4BlNp; Sun, 14 May 2023 14:19:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QK4Pq1jhCz4F5m; Sun, 14 May 2023 14:19:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1684073967; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=FxFvSRVExJootF/CisXiZofwQixorGoXZ45oTDdvHPI=; b=KZ2xmiuqr+yDvVRgRLiTwcqbZM0zqEeOnT128rlX6VJAYA5rC9mgy+C+Dmmgb6REzNsN9+ cOUzXmIlJT1g+NZJCKezu3vSgmQG16KuPu74m1IHgqqCP+bz+EYhe7aFZzjlOG66OvtvSw AQ0EFUXfTxQaKGac3fZySY/jsWgBr7WK1jIEtq+gAWIxcnItfFWXLYngB1nHJb7gH4Ja+V Jlekfv3xsFrdE7R9beNYww2tc/O8s+UybuVQrubnPQ5a/yQoBcccatA4eOezqzIAZ5vNs1 G/79l7SAc6xFLKgrAJlpc8C15138a3T+Z4ti9UtsLDMlXAl5yXXpO3R1yTnibw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1684073967; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=FxFvSRVExJootF/CisXiZofwQixorGoXZ45oTDdvHPI=; b=YCh9SFhB5eJBuAmi3yfQKPHfeh90OpPJluHU0mbTsmULrwdXPjMiLemtGU9FEA/OAaMr6P GX6N15yMIxK0rFWq2QI+YOhn6XuxIHvHzTjuseD2hiRGLRpBH5WQIEjmir/RyWK+p7+UBs ba9a4djfi3y78SSNAGPR5B1tT/zFL1YM0pF2g1OAVcygQavKHOo+cRcZs4Fr2218VQfI1O xEUQLFsjHGGzEH8rIEH+nwlH7FdoUedCsiR258JrpzwE//oN7hs186elxb8GZGzPSw2PNI vBgYPGl/6LL4mUaWscV8qBjQkeZM4gEMVvb1/BUwTkFGuW0J3I30xM12JxM4Fw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1684073967; a=rsa-sha256; cv=none; b=U34rNPsxYpC6tSKeRWdsTWdLK3hsPGZeIH2nhxpSo3i8bWf9+7MlyXhuIkNErsSFQZZENt Na4RIELlA2TKKrMJo54mhfeZBI9gye0ciDm8sFJ9IeDABhFEDksxQzDjp1F7QTQa48mE5Y 0RB2nMnAOG2wytE+ySdxX/HdsmmMbRKeIcUoRdtgGIqcXNM3ImPeulkGuHmg7eTm/34dMD XohwS4yHgRbEqL5YwmZ63ovDQt/qErvQzLLG/HgT+u7WKThN+l/MLPh6UcjDuMNl/InL9u BiLlLBjJvEhGjkYVdVmXduAUs4LeLucl70yownPiRk6ClVNawHiW6glRaX+z+Q== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QK4Pq0bwtz12Bb; Sun, 14 May 2023 14:19:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 34EEJQu9056279; Sun, 14 May 2023 14:19:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 34EEJQhT056278; Sun, 14 May 2023 14:19:26 GMT (envelope-from git) Date: Sun, 14 May 2023 14:19:26 GMT Message-Id: <202305141419.34EEJQhT056278@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Ed Maste Subject: git: b46d461d59b7 - main - src.conf.5: regen List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b46d461d59b78ee189f195e18b82dd31654eefb3 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by emaste: URL: https://cgit.FreeBSD.org/src/commit/?id=b46d461d59b78ee189f195e18b82dd31654eefb3 commit b46d461d59b78ee189f195e18b82dd31654eefb3 Author: Ed Maste AuthorDate: 2023-05-14 14:17:59 +0000 Commit: Ed Maste 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