From nobody Tue Sep  3 14:54:59 2024
X-Original-To: dev-commits-src-branches@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 4WypZD0412z5TMsm;
	Tue, 03 Sep 2024 14:55:00 +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 "R11" (verified OK))
	by mx1.freebsd.org (Postfix) with ESMTPS id 4WypZC4tXTz4x7m;
	Tue,  3 Sep 2024 14:54:59 +0000 (UTC)
	(envelope-from git@FreeBSD.org)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim;
	t=1725375299;
	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=cRLvVQLRbcc8PvsrtZYEoZureX60mnMauwi05ghPDFU=;
	b=rgjXwL/Or/mAt+O0audph+U9EyIhJjo/M0AAaiSb76GysOiY2tG63DeEy1obYSfJP62IJO
	hxy8zNos1XryvtIcUj4+BScbEChEbWxnZOQaNmh+n2yezAZqesCDFRY6uuWvg32nfxIAVK
	7T4BDsxwv8pdklRGivCLR1s7XmHXSacTr7Wf6fsuk/PtcYXnkPNYphYYk+NK5ErxskbCfj
	3+ao9OijJxn8R/lkb4qb2vMyj1Pa0vag2awLjF903PuGXftnbFJWCYs17iwCpWPoB9CPS7
	T3ugUYRgdjcAjku18uGNgvdWWra1QFjp+9gG3K107lJ4uFZS26UXNkMAHE9nVQ==
ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1725375299; a=rsa-sha256; cv=none;
	b=wM4XEvhNS6ZZG8eGm3NF5cgrBLZz26bXQPZBTjhJSmxNeNOHhWjALe2N3iIQ3p/6+rnkCd
	aCHUEX6QQc+eia89kqZUr28XBhjkG1Bm5Ptg8hfc4rs1TmQSsNYwVrDCCc9MRFl4pUutXI
	9oQdSG0mcULQmwqlkFH/Cyg0shDqTTqSnbqoIZKI3uP316lB1EBoxuVbEtnzkAMyELwKu6
	r/OjYfR3jZwk2f6lcZ4n8ILCfeq9LM1YezsxoWZJkuACiYCo0pDQ8tIoWS7rhON2zHlc03
	XOaV07dj3m0mdgBTI0xWf+jU0AmLulx11/4VlX52eRG+teavGqCRHDJRqDM0aw==
ARC-Authentication-Results: i=1;
	mx1.freebsd.org;
	none
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org;
	s=dkim; t=1725375299;
	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=cRLvVQLRbcc8PvsrtZYEoZureX60mnMauwi05ghPDFU=;
	b=rdqgX/acoZnX+c7ECxchxc3ntMTzfM4wNi7Oi1OzEIfnzjH5EUT6K8TMkE956RLN2IfUxY
	NVq8MIglvO5RW6naWFdMivIcbxJPzthxeQNgzXhueK7ElUEBrGMUSqLd5bVKrS4U09qwcy
	uFdcLTuXZ/HGn4wBlIPGk12lAO9cMklbCidxh5kkhq9QXSRfmhyd3OV8BirYDJMeCk3Xdx
	U0kMWre7Q29WGyULVXCcL8ho10MxoF+TBmtjuHaMAk3gibfJAYdpYNVxpqM+HvqTbhUp3W
	tEPf8AyOJ1qiXUnH1FYSEhggf1fkWRobPm+X5j+aD+ctWXqiMC4avenOzkhiGA==
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 4WypZC4V1tzlrB;
	Tue,  3 Sep 2024 14:54:59 +0000 (UTC)
	(envelope-from git@FreeBSD.org)
Received: from gitrepo.freebsd.org ([127.0.1.44])
	by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 483EsxNg070486;
	Tue, 3 Sep 2024 14:54:59 GMT
	(envelope-from git@gitrepo.freebsd.org)
Received: (from git@localhost)
	by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 483EsxjL070483;
	Tue, 3 Sep 2024 14:54:59 GMT
	(envelope-from git)
Date: Tue, 3 Sep 2024 14:54:59 GMT
Message-Id: <202409031454.483EsxjL070483@gitrepo.freebsd.org>
To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org,
        dev-commits-src-branches@FreeBSD.org
From: Mark Johnston <markj@FreeBSD.org>
Subject: git: 12a9d85c716c - stable/14 - build.7: Document the
  packages target
List-Id: Commits to the stable branches of the FreeBSD src repository <dev-commits-src-branches.freebsd.org>
List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches
List-Help: <mailto:dev-commits-src-branches+help@freebsd.org>
List-Post: <mailto:dev-commits-src-branches@freebsd.org>
List-Subscribe: <mailto:dev-commits-src-branches+subscribe@freebsd.org>
List-Unsubscribe: <mailto:dev-commits-src-branches+unsubscribe@freebsd.org>
X-BeenThere: dev-commits-src-branches@freebsd.org
Sender: owner-dev-commits-src-branches@FreeBSD.org
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Git-Committer: markj
X-Git-Repository: src
X-Git-Refname: refs/heads/stable/14
X-Git-Reftype: branch
X-Git-Commit: 12a9d85c716c63742f320e1df1f4057459e67b05
Auto-Submitted: auto-generated

The branch stable/14 has been updated by markj:

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

commit 12a9d85c716c63742f320e1df1f4057459e67b05
Author:     Mark Johnston <markj@FreeBSD.org>
AuthorDate: 2024-08-19 14:07:37 +0000
Commit:     Mark Johnston <markj@FreeBSD.org>
CommitDate: 2024-09-03 14:54:42 +0000

    build.7: Document the packages target
    
    Reviewed by:    manu, emaste
    MFC after:      1 week
    Sponsored by:   Innovate UK
    Differential Revision:  https://reviews.freebsd.org/D46286
    
    (cherry picked from commit 1d26746cfd4a19e9d641ecd2a21e764743a7bc03)
---
 share/man/man7/build.7 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/share/man/man7/build.7 b/share/man/man7/build.7
index 79c05f5ab63a..427f01e1223d 100644
--- a/share/man/man7/build.7
+++ b/share/man/man7/build.7
@@ -401,6 +401,19 @@ Install the kernel to the directory
 .Pa ${DISTDIR}/kernel/boot/kernel .
 This target is used while building a release; see
 .Xr release 7 .
+.It Cm packages
+Create a
+.Xr pkg 7
+repository containing packages that can be used to create or upgrade an
+installation of the base system.
+The output repository is placed in the object directory, under
+.Pa repo/${PKG_ABI}
+where
+.Va PKG_ABI
+is the
+.Xr pkg 7
+ABI for the build target, for example,
+.Pa /usr/obj/${SRCDIR}/repo/FreeBSD:15:amd64 .
 .It Cm packagekernel
 Archive the results of
 .Cm distributekernel ,