Page MenuHomeFreeBSD

D50289.id162791.diff
No OneTemporary

D50289.id162791.diff

diff --git a/share/man/man7/build.7 b/share/man/man7/build.7
--- a/share/man/man7/build.7
+++ b/share/man/man7/build.7
@@ -278,13 +278,30 @@
and
.Sy TARGET_ARCH
must be defined.
+.It Cm packages
+Create a
+.Xr packages 7
+repository containing packages that can be
+used to install or upgrade the base system.
+The repository is created in the object directory, under
+.Pa ${REPODIR}/${PKG_ABI}
+where
+.Ev REPODIR
+is the base directory where the repository will be created, and
+.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 packageworld
Archive the results of
.Cm distributeworld ,
placing the results in
.Va DISTDIR .
-This target is used while building a release; see
-.Xr release 7 .
+This target is used while building a
+.Xr release 7
+and is unrelated to building
+.Xr packages 7 .
.It Cm installworld
Install everything built by a preceding
.Cm buildworld
@@ -365,6 +382,17 @@
.Va XDDIR
defaults to
.Pa ${TARGET_ARCH}-freebsd .
+.It Cm update-packages
+Create or update the
+.Xr packages 7
+repository for the base system, optionally created by the
+.Cm packages
+target.
+If an existing repository exists,
+create a new package release in an existing repository updating only
+those packages which have changed since the previous package build.
+Unchanged packages will be copied from the previous build and retain the
+existing version number.
.It Cm xdev-build
Builds for the
.Cm xdev
@@ -411,26 +439,15 @@
.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 ,
placing the results in
.Va DISTDIR .
-This target is used while building a release; see
-.Xr release 7 .
+This target is used while building a
+.Xr release 7
+and is unrelated to building
+.Xr packages 7 .
.It Cm kernel
Equivalent to
.Cm buildkernel
@@ -658,6 +675,11 @@
the root of the source tree to build as part of the
.Cm cross-tools
target.
+.It Va OBJROOT
+The object directory root is defined as
+.Pa ${OBJDIR}/${SRCDIR}/ .
+See
+.Pa share/mk/src.sys.obj.mk .
.It Va PKG_FORMAT
Specify a package compression format when building
.Pa src
@@ -680,9 +702,7 @@
.Cm installkernel
process.
This is currently incompatible with building
-.Pa src
-into
-.Cm packages .
+.Xr packages 7 .
Each port must be specified as
.Ar category Ns Li / Ns Ar port Ns Op Li @ Ns Ar flavor ,
e.g.
@@ -711,6 +731,13 @@
The src.conf file controls the components to build.
See
.Xr src.conf 5
+.It Va REPODIR
+The root directory used to create the package repository for building
+.Xr packges 7 .
+Defaults to
+.Pa ${OBJROOT}/repo/ .
+This can also be set in
+.Xr src-env.conf 5 .
.It Va STRIPBIN
Command to use at install time when stripping binaries.
Be sure to add any additional tools required to run
@@ -1108,6 +1135,7 @@
.Xr src.conf 5 ,
.Xr arch 7 ,
.Xr development 7 ,
+.Xr packages 7 ,
.Xr pkg 7 ,
.Xr ports 7 ,
.Xr release 7 ,

File Metadata

Mime Type
text/plain
Expires
Sun, Feb 15, 11:15 PM (15 h, 31 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
28759522
Default Alt Text
D50289.id162791.diff (3 KB)

Event Timeline