From fd17f53cef61ca5e25219fcc0d555e154cd0af59 Mon Sep 17 00:00:00 2001
From: tsuibin <tsuibin@qq.com>
Date: Sun, 1 Aug 2021 17:18:35 +0800
Subject: [PATCH] doc: Add archbuild man page

---
 Makefile                 |  3 ++-
 doc/archbuild.1.asciidoc | 47 ++++++++++++++++++++++++++++++++++++++++
 doc/devtools.7.asciidoc  |  3 +++
 3 files changed, 52 insertions(+), 1 deletion(-)
 create mode 100644 doc/archbuild.1.asciidoc

diff --git a/Makefile b/Makefile
index d9a6492..bac6ac2 100644
--- a/Makefile
+++ b/Makefile
@@ -70,6 +70,7 @@ BASHCOMPLETION_LINKS = \
 
 
 MANS = \
+	doc/archbuild.1 \
 	doc/makechrootpkg.1 \
 	doc/lddd.1 \
 	doc/checkpkg.1 \
@@ -98,7 +99,7 @@ edit = sed -e "s|@pkgdatadir[@]|$(PREFIX)/share/devtools|g"
 $(MANS): doc/asciidoc.conf doc/footer.asciidoc
 
 doc/%: doc/%.asciidoc
-	a2x --no-xmllint --asciidoc-opts="-f doc/asciidoc.conf" -d manpage -f manpage -D doc $<
+	a2x --no-xmllint --asciidoc-opts="-f doc/asciidoc.conf" -d manpage -f manpage -D doc -a pkgdatadir=$(PREFIX)/share/devtools $<
 
 clean:
 	rm -f $(IN_PROGS) bash_completion zsh_completion $(MANS)
diff --git a/doc/archbuild.1.asciidoc b/doc/archbuild.1.asciidoc
new file mode 100644
index 0000000..48a200d
--- /dev/null
+++ b/doc/archbuild.1.asciidoc
@@ -0,0 +1,47 @@
+archbuild(1)
+============
+
+Name
+----
+archbuild - a script to build an Arch Linux package inside a clean chroot.
+
+Synopsis
+--------
+archbuild [options] -- [makechrootpkg args]
+
+Description
+-----------
+
+'archbuild' is a script to build an Arch Linux package. archbuild is part of devtools but should only be used via one of the included symlinks:
+
+* extra-x86_64-build
+* gnome-unstable-x86_64-build
+* kde-unstable-x86_64-build
+* multilib-build
+* multilib-staging-build
+* multilib-testing-build
+* staging-x86_64-build
+* testing-x86_64-build
+
+The symlink used to run it will be inspected by archbuild, to determine which target you want it to use. It will load the available pacman configuration from 'pacman-reponame-arch.conf' with a fallback to 'pacman-reponame.conf' from {pkgdatadir}. The makepkg configuration is loaded from 'makepkg-repo-arch.conf' with a fallback to 'makepkg-reponame.conf' from {pkgdatadir}.
+
+
+Options
+-------
+
+*-h*::
+	Output command line options.
+
+*-c*::
+	Recreate the chroot before building.
+
+*-r* <dir>::
+	Create chroots in this directory.
+
+
+See Also
+--------
+
+linkman:devtools[7]
+
+include::footer.asciidoc[]
diff --git a/doc/devtools.7.asciidoc b/doc/devtools.7.asciidoc
index 1276e02..bb47620 100644
--- a/doc/devtools.7.asciidoc
+++ b/doc/devtools.7.asciidoc
@@ -21,6 +21,9 @@ for details.
 linkman:checkpkg[1]
 	Compare the current build pakcage with the repository version
 
+linkman:archbuild[1]
+	Build an Arch Linux package inside a clean chroot
+
 linkman:find-libdeps[1]
 	Find soname dependencies for a package