On 10/01/18 03:19, Jelle van der Waa wrote: > Add a new man page which describes the structure of a BUILDINFO file > included in a package produced by makepkg. >
Thanks. Some wording suggestions provided inline. A > Signed-off-by: Jelle van der Waa <[email protected]> > --- > doc/BUILDINFO.5.txt | 68 > +++++++++++++++++++++++++++++++++++++++++++++++++++++ > doc/Makefile.am | 4 +++- > 2 files changed, 71 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..32c65c83 > --- /dev/null > +++ b/doc/BUILDINFO.5.txt > @@ -0,0 +1,68 @@ > +///// > +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 usually found in a s/usually// file found in the root of a package created by makepkg? > +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 ...per line. Arrays are... > +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 when > + it's a split package. except for split packages. > + > +*pkgver*:: > + The version of the package including pkgrel and epoch. > + > +*pkgbuild_sha256sum*:: > + The sha256sum in hex format of the PKGBUILD used to build the package. > + > +*packager*:: > + The packager which has built the package. The details of the packager that built the > + > +*builddate*:: > + The build date of the package in epoch. > + > +*builddir*:: > + The build directory where the package has been build. The directory where the package was built. > +*buildenv (array)*:: > + The set BUILDENV from makepkg.conf. > + The build enviroment sepcified in makepkg.conf. > +*options (array)*:: > + A combination of the OPTIONS set in makekg.conf merged with the options > set > + in the used PKGBUILD. The option set specified when building the package. > + > +*installed (array)*:: > + The installed packages at build time including the version of the > package. ...including the version infomration. > + Formatted as "$pkgname-$pkgver-$pkgrel". > + > +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 \ >
