summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authoryoursweetie <939696280@qq.com>2021-08-08 19:26:20 +0800
committerJelle van der Waa <jelle@archlinux.org>2021-09-07 20:55:42 +0200
commit80e8c1fc702e6a0e328bca52d3acf0710c7cc7ff (patch)
tree2896b0e45d465fe3136b615938890cd30a70b730
parent6535ac9b99d1977d123743247f7c35bf910a24b6 (diff)
downloaddevtools-80e8c1fc702e6a0e328bca52d3acf0710c7cc7ff.tar.xz
doc: Add makechrootpkg man page
-rw-r--r--Makefile1
-rw-r--r--doc/devtools.7.asciidoc3
-rw-r--r--doc/makechrootpkg.1.asciidoc76
3 files changed, 80 insertions, 0 deletions
diff --git a/Makefile b/Makefile
index bd2fb3d..d9a6492 100644
--- a/Makefile
+++ b/Makefile
@@ -70,6 +70,7 @@ BASHCOMPLETION_LINKS = \
MANS = \
+ doc/makechrootpkg.1 \
doc/lddd.1 \
doc/checkpkg.1 \
doc/offload-build.1 \
diff --git a/doc/devtools.7.asciidoc b/doc/devtools.7.asciidoc
index 1b77f4e..1276e02 100644
--- a/doc/devtools.7.asciidoc
+++ b/doc/devtools.7.asciidoc
@@ -37,6 +37,9 @@ linkman:mkarchroot[1]
Creates an arch chroot in a specified location with a specified set of
packages
+linkman:makechrootpkg[1]
+ Build a PKGBUILD in a given chroot environment
+
linkman:offload-build[1]
Build a PKGBUILD on a remote server using makechrootpkg
diff --git a/doc/makechrootpkg.1.asciidoc b/doc/makechrootpkg.1.asciidoc
new file mode 100644
index 0000000..dee0518
--- /dev/null
+++ b/doc/makechrootpkg.1.asciidoc
@@ -0,0 +1,76 @@
+makechrootpkg(1)
+================
+
+Name
+----
+makechrootpkg - Build a PKGBUILD in a given chroot environment
+
+Synopsis
+--------
+makechrootpkg [OPTIONS] -r <chrootdir> [--] [makepkg args]
+
+Description
+-----------
+
+Run this script in a directory containing a PKGBUILD to build a package
+inside a clean chroot. Arguments passed to this script after the
+end-of-options marker (--) will be passed to makepkg.
+
+The chroot dir consists of the following directories:
+<chrootdir>/{root, copy} but only "root" is required
+by default. The working copy will be created as needed
+
+The chroot "root" directory must be created via the following
+command:
+ mkarchroot <chrootdir>/root base-devel
+
+This script reads {SRC,SRCPKG,PKG,LOG}DEST, MAKEFLAGS and PACKAGER
+from makepkg.conf(5), if those variables are not part of the
+environment.
+
+Default makepkg args: --syncdeps --noconfirm --log --holdver --skipinteg
+
+Options
+-------
+
+*-h*::
+ Show this usage message
+
+*-c*::
+ Clean the chroot before building
+
+*-d* <dir>::
+ Bind directory into build chroot as read-write
+
+*-D* <dir>::
+ Bind directory into build chroot as read-only
+
+*-u*::
+ Update the working copy of the chroot before building
+ This is useful for rebuilds without dirtying the pristine
+ chroot
+
+*-r* <dir>::
+ The chroot dir to use
+
+*-I* <pkg>::
+ Install a package into the working copy of the chroot
+
+*-l* <copy>::
+ The directory to use as the working copy of the chroot
+ Useful for maintaining multiple copies
+ Default: $USER
+
+*-n*::
+ Run namcap on the build package
+
+*-C*::
+ Run checkpkg on the build package
+
+*-T*::
+ Build in a temporary directory
+
+*-U*::
+ Run makepkg as a specified user
+
+include::footer.asciidoc[]