git: 1d26746cfd4a - main - build.7: Document the packages target

From: Mark Johnston <markj_at_FreeBSD.org>
Date: Mon, 19 Aug 2024 14:37:35 UTC
The branch main has been updated by markj:

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

commit 1d26746cfd4a19e9d641ecd2a21e764743a7bc03
Author:     Mark Johnston <markj@FreeBSD.org>
AuthorDate: 2024-08-19 14:07:37 +0000
Commit:     Mark Johnston <markj@FreeBSD.org>
CommitDate: 2024-08-19 14:37:27 +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
---
 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 3c71c14e6039..afafef9d3c02 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 ,