summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authortsuibin <tsuibin@qq.com>2021-08-01 17:18:35 +0800
committerJelle van der Waa <jelle@archlinux.org>2021-09-07 22:23:32 +0200
commitfd17f53cef61ca5e25219fcc0d555e154cd0af59 (patch)
treeed629a9f7e06c01b591db4c2fa3fe90c5cde6791
parent80e8c1fc702e6a0e328bca52d3acf0710c7cc7ff (diff)
downloaddevtools-fd17f53cef61ca5e25219fcc0d555e154cd0af59.tar.xz
doc: Add archbuild man page
-rw-r--r--Makefile3
-rw-r--r--doc/archbuild.1.asciidoc47
-rw-r--r--doc/devtools.7.asciidoc3
3 files changed, 52 insertions, 1 deletions
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