void-packages/common/environment/README

30 lines
1.0 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 environment variables for use in the xbps-src helpers
(libexec/xbps-src-*). 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:
* setup (before reading template)
* fetch (before running fetch phase)
* extract (before running extract phase)
* configure (before running configure phase)
* build (before running build phase)
* install (before running install phase)
* pkg (before running pkg phase)
NOTES
~~~~~
* All variables are exported to the environment, so please be careful when
declaring new variables in the shell snippets.
* Symlinks can be created (relative) to make a shell snippet available in
multiple phases.