common/environment/README

   1 ENVIRONMENT SHELL SNIPPETS
   2 ==========================
   3
   4 This directory contains shell files (must not be executable nor contain a shebang)
   5 that are read by xbps-src when building source packages. The shell files
   6 are read in lexical order (as ordered by shell rules).
   7
   8 These files shall set or unset environment variables while building packages.
   9 Only files with the `.sh' extension are read, so this file will be simply ignored.
  10
  11 The following directories are used to set the order in which the shell snippets
  12 should be read by xbps-src:
  13
  14         * build-style   (to set vars for a specific build_style helper)
  15         * setup         (before reading template)
  16         * setup-subpkg  (before running the subpkg <pkgname>_package() function)
  17         * fetch         (before running fetch phase)
  18         * extract       (before running extract phase)
  19         * configure     (before running configure phase)
  20         * build         (before running build phase)
  21         * check         (before running check phase)
  22         * install       (before running install phase)
  23         * pkg           (before running pkg phase)
  24
  25 NOTES
  26 ~~~~~
  27 * Symlinks can be created (relative) to make a shell snippet available in
  28   multiple phases.