vp-build/common/environment/README
Jürgen Buchmüller c31dd888f6 xbps-src: implement a 'check' stage
Add another stage 'check' between 'build' and 'install'. It is be enabled using the
variable XBPS_CHECK_PKGS=yes and disabled if unset, set to "0" or "no" in your
local etc/conf.

A new xbps-src option `-q` for `quick` will disable XBPS_CHECK_PKGS by overriding it to 0.
If enabled, `common/xbps-src/shutils/xbps-src-docheck.sh` checks for an existing
`do_check()` function in the package's template and, if it exists, calls it.

A new template variable `checkdepends` may be present and list packages required
to run the `do_check()` function. Example: `checkdepends="bc unittest-cpp"`.
2017-03-08 11:33:48 +01:00

29 lines
1.1 KiB
Plaintext

ENVIRONMENT SHELL SNIPPETS
==========================
This directory contains shell files (must not be executable nor contain a shebang)
that are read by xbps-src when building source packages. The shell files
are read in lexical order (as ordered by shell rules).
These files shall set or unset environment variables while building packages.
Only files with the `.sh' extension are read, so this file will be simply ignored.
The following directories are used to set the order in which the shell snippets
should be read by xbps-src:
* build-style (to set vars for a specific build_style helper)
* setup (before reading template)
* setup-subpkg (before running the subpkg <pkgname>_package() function)
* fetch (before running fetch phase)
* extract (before running extract phase)
* configure (before running configure phase)
* build (before running build phase)
* check (before running check phase)
* install (before running install phase)
* pkg (before running pkg phase)
NOTES
~~~~~
* Symlinks can be created (relative) to make a shell snippet available in
multiple phases.