git: 12a9d85c716c - stable/14 - build.7: Document the packages target

From: Mark Johnston <markj_at_FreeBSD.org>
Date: Tue, 03 Sep 2024 14:54:59 UTC
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 ,