Send patches - preferably formatted by git format-patch - to patches at archlinux32 dot org.
summaryrefslogtreecommitdiff
path: root/doc/BUILDINFO.5.asciidoc
diff options
context:
space:
mode:
authorEli Schwartz <eschwartz@archlinux.org>2018-05-03 00:10:21 -0400
committerAllan McRae <allan@archlinux.org>2018-05-14 09:59:17 +1000
commit076b6184de2b20e9b26225d93f6f3a7030504109 (patch)
treeca0e375b9fd89d6b6ce40026b732985c4b335841 /doc/BUILDINFO.5.asciidoc
parent860e4c4943ad062bd0eff99f28e7d64804b3c08e (diff)
Ensure better text editor automatic filetype detection
Since we no longer use vim-specific modelines, use the .asciidoc file extension which is, well, reserved for asciidoc formatted files. This should presumably work everywhere without needing editor-specific workarounds and configuration. Also add a shebang to makepkg.conf to indicate it contains bash content. Signed-off-by: Eli Schwartz <eschwartz@archlinux.org> Signed-off-by: Allan McRae <allan@archlinux.org>
Diffstat (limited to 'doc/BUILDINFO.5.asciidoc')
-rw-r--r--doc/BUILDINFO.5.asciidoc70
1 files changed, 70 insertions, 0 deletions
diff --git a/doc/BUILDINFO.5.asciidoc b/doc/BUILDINFO.5.asciidoc
new file mode 100644
index 00000000..3db1e12f
--- /dev/null
+++ b/doc/BUILDINFO.5.asciidoc
@@ -0,0 +1,70 @@
+/////
+vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
+/////
+BUILDINFO(5)
+============
+
+Name
+----
+BUILDINFO - Makepkg package build information file
+
+
+Synopsis
+--------
+This manual page describes the format of a BUILDINFO file found in the root of
+a package created by makepkg. The file contains a description of the package's
+build environment. The information is formatted in key-value pairs separated by
+a '=', one value per line. Arrays are represented multiple keys with the same
+value.
+
+
+Description
+-----------
+
+This is a description of the contents of version '1' of the
+BUILDINFO file format.
+
+*format*::
+ Denotes the file format version, represented by a plain positive integer.
+
+*pkgname*::
+ The name of the package.
+
+*pkgbase*::
+
+ The base name of a package, usually the same as the pkgname except for
+ split packages.
+
+*pkgver*::
+ The version of the package including pkgrel and epoch.
+
+*pkgarch*::
+ The architecture of the package.
+
+*pkgbuild_sha256sum*::
+ The sha256sum in hex format of the PKGBUILD used to build the package.
+
+*packager*::
+ The details of the packager that built the package.
+
+*builddate*::
+ The build date of the package in epoch.
+
+*builddir*::
+ The directory where the package was built.
+
+*buildenv (array)*::
+ The build environment specified in makepkg.conf.
+
+*options (array)*::
+ The options set specified when building the package.
+
+*installed (array)*::
+ The installed packages at build time including the version information of
+ the package. Formatted as "$pkgname-$pkgver-$pkgrel-$pkgarch".
+
+See Also
+--------
+linkman:makepkg[8], linkman:pacman[8], linkman:makepkg.conf[5]
+
+include::footer.asciidoc[]