doc: Add makechrootpkg man page

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[]