summaryrefslogtreecommitdiffstats
path: root/specs/spf-2.0/buildsys.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'specs/spf-2.0/buildsys.mdwn')
-rw-r--r--specs/spf-2.0/buildsys.mdwn38
1 files changed, 27 insertions, 11 deletions
diff --git a/specs/spf-2.0/buildsys.mdwn b/specs/spf-2.0/buildsys.mdwn
index 07c8039..a483d46 100644
--- a/specs/spf-2.0/buildsys.mdwn
+++ b/specs/spf-2.0/buildsys.mdwn
@@ -49,9 +49,21 @@ Certain environment variables (see $[sectlink][env-vars]) shall be set when the
Build Work Area [work-area]
===========================
-When building packages, a new directory named `tmp` shall be created in the
-source package directory. In this directory, the package source code shall be
-copied or unpacked into a directory called `src` shall be created.
+When building packages, the package building tool shall create a new directory
+named `tmp` in the source package directory. In this directory, the package
+building tool shall copy or unpack the package source code into a directory
+called `src`.
+
+For each binary package, the `build` file (see $[sectlink][build]) must create
+within the work area `tmp` a directory named `<binpkg>.data`, where `<binpkg>`
+is the name of the binary package. See $[sectlink][bin-name] for the
+requirements on binary package names.
+
+Before installing binary package data files into `<binpkg>.data`, the `build`
+file may stage them in a different directory immediately under the work area
+directory `tmp`. For example, opkhelper's **oh-autoinstall**(1) installs files
+into `tmp/dest/` before **oh-installfiles**(1) moves them to
+`tmp/<binpkg>.data/`.
After all expected binary packages have been built, the work area (`tmp` and its
children) shall be removed.
@@ -60,14 +72,9 @@ children) shall be removed.
Environment Variables [env-vars]
================================
-Certain environment variables shall be set to provide to the configuration
-script and build makefile information about the package and the environments in
-and for which binary packages are to be built.
-
-The terms "build system" and "host system" below are used according to [the
-convention set by GNU Autoconf][target-triplets]. The build system is the type
-of system on which a package is built. The host system is the type of system on
-which a binary package is expected to be natively installed and used.
+The package building tool shall set certain environment variables to provide to
+the build makefile information about the package and the environments in and for
+which binary packages are to be built.
Package Variables [env-vars-pkg]
--------------------------------
@@ -100,9 +107,18 @@ The following environment variables shall be set to describe the source package:
architecture-dependent or architecture-independent packages may have been
selected for building.
+ * `OPK_WORK_AREA`
+
+ The absolute path to the build work area (see $[sectlink][work-area]).
+
Build and Host System Variables [env-vars-sys]
----------------------------------------------
+The terms "build system" and "host system" are used according to [the convention
+set by GNU Autoconf][target-triplets]. The build system is the type of system
+on which a package is built. The host system is the type of system on which a
+binary package is expected to be natively installed and used.
+
The following environment variables shall be set to describe the build system:
* `OPK_BUILD_ARCH`