summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/devtools.7.asciidoc46
-rw-r--r--doc/makerepropkg.1.asciidoc11
-rw-r--r--doc/offload-build.1.asciidoc2
3 files changed, 57 insertions, 2 deletions
diff --git a/doc/devtools.7.asciidoc b/doc/devtools.7.asciidoc
new file mode 100644
index 0000000..1b77f4e
--- /dev/null
+++ b/doc/devtools.7.asciidoc
@@ -0,0 +1,46 @@
+devtools(7)
+===========
+
+Name
+----
+devtools - Developer tools for the Arch Linux distribution
+
+Description
+-----------
+
+Devtools contains tools for package maintenance in Arch Linux. The toolset
+varies from tools for building packages in a clean chroot ('mkarchroot',...),
+packaging related tools for sonames ('sogrep', 'lddd') and tools for
+repository management such as ('archco', 'extra2community')
+
+Programs
+--------
+The list below gives a short overview; see the respective documentation
+for details.
+
+linkman:checkpkg[1]
+ Compare the current build pakcage with the repository version
+
+linkman:find-libdeps[1]
+ Find soname dependencies for a package
+
+linkman:find-libprovides[1]
+ Find soname's which are provided by a package
+
+linkman:lddd[1]
+ Find broken library links on your system
+
+linkman:makerepropkg[1]
+ Rebuild a package to see if it is reproducible
+
+linkman:mkarchroot[1]
+ Creates an arch chroot in a specified location with a specified set of
+ packages
+
+linkman:offload-build[1]
+ Build a PKGBUILD on a remote server using makechrootpkg
+
+linkman:sogrep[1]
+ Find packages using a linked to a given shared library
+
+include::footer.asciidoc[]
diff --git a/doc/makerepropkg.1.asciidoc b/doc/makerepropkg.1.asciidoc
index 0d7ddcb..e9f4c24 100644
--- a/doc/makerepropkg.1.asciidoc
+++ b/doc/makerepropkg.1.asciidoc
@@ -7,7 +7,7 @@ makerepropkg - Rebuild a package to see if it is reproducible
Synopsis
--------
-makerepropkg [OPTIONS] <package_file>...
+makerepropkg [OPTIONS] [<package_file|pkgname>...]
Description
-----------
@@ -24,6 +24,15 @@ When given multiple packages, additional package files are assumed to be split
packages and will be treated as additional artifacts to compare during the
verification step.
+A valid target(s) for pacman -S can be specified instead, and makerepropkg will
+download it to the cache if needed. This is mostly useful to specify which
+repository to retrieve from. If no positional arguments are specified, the
+targets will be sourced from the PKGBUILD.
+
+In either case, the package name will be converted to a filename from the
+cache, and makerepropkg will proceed as though this filename was initially
+specified.
+
This implements a verifier for pacman/libalpm packages in accordance with the
link:https://reproducible-builds.org/[Reproducible Builds] project.
diff --git a/doc/offload-build.1.asciidoc b/doc/offload-build.1.asciidoc
index 3633faa..5c9515f 100644
--- a/doc/offload-build.1.asciidoc
+++ b/doc/offload-build.1.asciidoc
@@ -28,7 +28,7 @@ Options
architecture officially supported by Arch Linux.
*-s, --server* <hostname>::
- Offload to a specific build server. The default is dragon.archlinux.org
+ Offload to a specific build server. The default is build.archlinux.org
which is used as part of the build toolchain for the official Arch Linux
repos.