From nobody Thu Oct 29 23:32:50 2026 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 4jG0s43HS6z6xqmW for ; Thu, 29 Oct 2026 23:32:56 +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) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4jG0s36x28z4pq4 for ; Thu, 29 Oct 2026 23:32:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1793316776; 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=aQSIZr8x5wcn9uIvd/Ey74zZ9aI2iKwzqm2Z2uulSsw=; b=jy/3g6DrPTd7/c4HSCVwbL9jmPj3sLZZSWFL82JYnaYqBmYfY+UykYNo2FnjBvQybMpxFY +eIkfzA0dz+JjviYgpCTou77TBkZFIPTU0N3Y/2v3qk2DN3CK0IyI5EwYHiMb9MVspSq16 ustDXM/nK1MNhG/Gz0yAz+whEc+6jp5lHuOPe9RiH/fZh2WgmhJ+snIqdhU7Nrch5RNDNI e1ZrdOYnkZ4Njl3trkMReGCY7NNooRuN/SLW9JrSOb3JWd5BXIF5JUrc/UaBS2GS4Mw0mX SiS/DCnzSkBBb2KLjrEEWwA0Dhr0yFYb2ajYXEyNXHgbWwUNymZo64Xy0uwRQQ== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1793316776; b=YzGJ7udVHMM8BcZFdSdtS+vhWPXiHqp/fWtEG2IhnUL5WSY5aA8RhPyXpuh4cp+pURDYvC BTio0zEgCIA7uC6sRM4CbISC/V67zgjl7eZnjyaceVKCIrvX8EspMHK2IP105gXzd9VC9v SoJkvNy4yGLXoEy4iFzSrpkod95mBSz7bC4lUSPy+2KqhZ+MAyi1kBB8Zn7FI338+U+W8A sUQFbzz+REgfAbfcQmtYd64a2zBLp0DTPK9f/5GOf8ZdvAf1ekYg9njIS5++Q9o69uu4RS OfgjpGL1BiDIVBJ3NAVdsZfghxpzb71ySLSqpz8i7TwI1f+VJR+Mo7vQIFl2NA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1793316776; 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=aQSIZr8x5wcn9uIvd/Ey74zZ9aI2iKwzqm2Z2uulSsw=; b=VPYTojCyePGxvUDYXNW3Jk45H8FoAOeJLggX9m+b5SJJ9g2fRPnT+2NN0KlFoRHrgxgbMY P5vJTqEigIix4jayn+Cm5M0kXACi/2fFVJx9Axq6QxFLS7h6OUmKKiy1KoYjN0lCQqvnKN ONtWHLfUAAtTolruU4/1iPzmA8lq3IKrahv6u2aDnLAbFM9MUgp2V+vZEfqHN/4JCzbixp cOfjowwIL+LLIzL/btzfUqAXazDarxmgRm8bZm4uUCmMTetaYkPkupjIwi7BuzkvPkw4PO 6JGyJY+WK8AigvEYaeOwxxh//aCoeYICZPt1/zOGG9K4iVQtV+zi+01KlLu6ZA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4jG0s36bWNz120w for ; Thu, 29 Oct 2026 23:32:55 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3ab4d by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 29 Oct 2026 23:32:50 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Enji Cooper Subject: git: 68aebfa28a17 - main - style.Makefile(5): update recommendations List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: Commit messages for all branches of the src repository List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ngie X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 68aebfa28a17189e1e697e612c0a1a2220b9fa2b Auto-Submitted: auto-generated Date: Thu, 29 Oct 2026 23:32:50 +0000 Message-Id: <6ae3d7a2.3ab4d.29b4cc98@gitrepo.freebsd.org> The branch main has been updated by ngie: URL: https://cgit.FreeBSD.org/src/commit/?id=68aebfa28a17189e1e697e612c0a1a2220b9fa2b commit 68aebfa28a17189e1e697e612c0a1a2220b9fa2b Author: Enji Cooper AuthorDate: 2026-10-29 20:47:36 +0000 Commit: Enji Cooper CommitDate: 2026-10-29 23:31:58 +0000 style.Makefile(5): update recommendations - Mention `CXXFLAGS` and `CXXSTD`, in addition to `CFLAGS` and `CSTD`. - Mention `LIBADD`, in addition to the legacy (in-tree) variables, `DPADD` and `LDADD`. - Mention the other option types, e.g., `MK_FOO`, `WITHOUT_FOO`, etc, added as part of `src.opts.mk` in the past couple releases. Bump .Dd for the change. MFC after: 1 week --- share/man/man5/style.Makefile.5 | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/share/man/man5/style.Makefile.5 b/share/man/man5/style.Makefile.5 index 8537c4428d88..f28c7f4af777 100644 --- a/share/man/man5/style.Makefile.5 +++ b/share/man/man5/style.Makefile.5 @@ -28,7 +28,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd October 29, 2025 +.Dd October 29, 2026 .Dt STYLE.MAKEFILE 5 .Os .Sh NAME @@ -70,9 +70,12 @@ order is: .Va SRCS .Va WARNS .Va CSTD +.Va CXXSTD .Va CFLAGS +.Va CXXFLAGS .Va DPADD -.Va LDADD . +.Va LDADD +.Va LIBADD . The general .Dq build order is: @@ -80,9 +83,12 @@ order is: .Va SRCS .Va WARNS .Va CSTD +.Va CXXSTD .Va CFLAGS +.Va CXXFLAGS .Va DPADD .Va LDADD +.Va LIBADD .Va INCS .Va FILES .Va LINKS @@ -229,13 +235,22 @@ To not build the .Dq foo part of the base system, use -.Va NO_FOO , +.Va WITHOUT_FOO +or +.Dv MK_FOO=no , not +.Va NO_FOO +or .Va NOFOO . +The latter are reserved for the +.Fx +Ports Collection. .It To optionally build something in the base system, spell the knob .Va WITH_FOO +or +.Dv MK_FOO=yes , not .Va WANT_FOO or