[pacman-dev] [PATCH 1/1] Add BUILDINFO man page

[Jelle van der Waa]

Add a new man page which describes the structure of a BUILDINFO file
included in a package produced by makepkg.

Signed-off-by: Jelle van der Waa <jelle at vdwaa.nl>
---
 doc/BUILDINFO.5.txt | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 doc/Makefile.am     |  4 +++-
 2 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 doc/BUILDINFO.5.txt

diff --git a/doc/BUILDINFO.5.txt b/doc/BUILDINFO.5.txt
new file mode 100644
index 00000000..1a454497
--- /dev/null
+++ b/doc/BUILDINFO.5.txt
@@ -0,0 +1,65 @@
+/////
+vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
+/////
+BUILDINFO(5)
+============
+
+Name
+----
+BUILDINFO - Arch Linux package build information file
+
+
+Synopsis
+--------
+BUILDINFO
+
+
+Description
+-----------
+This manual page describes the format of a BUILDINFO file usually found in a
+package created by makepkg.
+
+Contents
+--------
+The following is a list of the contents and a description of the key value pairs
+in a BUILDINFO file.
+
+*format*::
+	Denotes the file format, represented by a number.
+
+*pkgname*::
+	The name of the package.
+
+*pkgbase*::
+	The name used to refer to the group of packages in the output of makepkg.
+
+*pkgver*::
+	The version of the package including pkgrel and epoch.
+
+*pkgbuild_sha256sum*::
+	The sha256sum of the PKGBUILD used to build the package.
+
+*packager*::
+	The packager which has built the package.
+
+*builddate*
+	The build date of the package in epoch.
+
+*builddir*::
+	The build directory from which makepkg has been invoked.
+
+*buildenv (array)*::
+	The set BUILDENV from makepkg.conf.
+
+*options (array)*::
+	A combination of the OPTIONS set in makekg.conf merged with the options set
+	in the used PKGBUILD.
+
+*installed (array)*::
+	The installed packages at build time including the version of the package.
+
+See Also
+--------
+linkman:makepkg[8], linkman:pacman[8], linkman:makepkg.conf[5]
+
+include::footer.txt[]
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 44e32996..bbf2af66 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -15,7 +15,8 @@ ASCIIDOC_MANS = \
 	PKGBUILD.5 \
 	makepkg.conf.5 \
 	pacman.conf.5 \
-	libalpm.3
+	libalpm.3 \
+	BUILDINFO.5
 
 DOXYGEN_MANS = $(wildcard man3/*.3)
 
@@ -58,6 +59,7 @@ EXTRA_DIST = \
 	PKGBUILD-example.txt \
 	makepkg.conf.5.txt \
 	pacman.conf.5.txt \
+	BUILDINFO.5.txt \
 	libalpm.3.txt \
 	footer.txt \
 	index.txt \
-- 
2.15.1