SPF 2.0: Specify tmp/<binpkg>.data/

And allow staging only in an immediate subdirectory of tmp/.

1 files changed, 11 insertions, 0 deletions

diff --git a/specs/spf-2.0/buildsys.mdwn b/specs/spf-2.0/buildsys.mdwn
index 39bb82c..12a0139 100644
--- a/specs/spf-2.0/buildsys.mdwn
+++ b/specs/spf-2.0/buildsys.mdwn
@@ -53,6 +53,17 @@ 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`.
 
+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.