summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorP. J. McDermott <pjm@nac.net>2012-08-26 17:51:11 (EDT)
committer P. J. McDermott <pjm@nac.net>2012-08-26 17:51:11 (EDT)
commitc2df77fb4f53916119197d681374a2ca039a0e24 (patch)
tree69f1874fdf739a896e8782cce67c0d5b5be925be
parent8e92babba4a8df133705b7f529abbed3f90f5e6d (diff)
Move documentation of install files to Metadata.
-rw-r--r--specs/spf-2.0/metadata.mdwn24
-rw-r--r--specs/spf-2.0/overview.mdwn13
2 files changed, 26 insertions, 11 deletions
diff --git a/specs/spf-2.0/metadata.mdwn b/specs/spf-2.0/metadata.mdwn
index f5b08bd..67f99be 100644
--- a/specs/spf-2.0/metadata.mdwn
+++ b/specs/spf-2.0/metadata.mdwn
@@ -40,6 +40,27 @@ field must follow the syntax of the `mailbox` symbol of RFC 5322 section 3.4.
`date-time` symbol of RFC 5322 section 3.3.
+File Installation Lists [install]
+=================================
+
+Binary packages that provide files shall have a file named `install` in their
+`<binpkg>.pkg/` directories.
+
+The `<binpkg>.pkg/install` file is a list of patterns, terminated by line
+breaks, to match files that are to be installed in the binary package.
+
+Each pattern shall be expanded to match files in the installation destination
+directory (see $[sectlink][work-area]) as explained in [POSIX.1-2008, Shell &
+Utilities Volume, Section 2.6.6][posix-xcu-2.6.6].
+
+A file or directory in the installation destination directory shall not be
+matched by the `install` file of more than one binary package. Any such case
+shall be considered an error.
+
+Run-time platform configuration files listed in a binary package's `platconf`
+file shall not be listed in the package's `install` file.
+
+
Platform Configuration File Lists [platconf]
============================================
@@ -108,3 +129,6 @@ reset to `1` for the first upload to `<dist>` of a new upstream package version,
source archive repack, or distribution packaging revision. It must be a string
of one or more digits, the first of which must be greater than or equal to `1`.
(A regular expression for this is `[1-9][0-9]*`.)
+
+
+[posix-xcu-2.6.6]: http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_06_06
diff --git a/specs/spf-2.0/overview.mdwn b/specs/spf-2.0/overview.mdwn
index 26a34d3..de45ff0 100644
--- a/specs/spf-2.0/overview.mdwn
+++ b/specs/spf-2.0/overview.mdwn
@@ -101,12 +101,7 @@ This file is required.
This file contains a list of patterns to match files to be installed in the
binary package.
-Each line in this file is a pattern that is expanded to match files as explained
-in [POSIX.1-2008, Shell & Utilities Volume, Section 2.6.6][posix-xcu-2.6.6].
-
-A file or directory in the destination directory may not be matched by more than
-one binary package's `install` file. The behavior of package building tools in
-such a case is undefined.
+See $[sectlink][install] for more information about this file.
`<binpkg>.pkg/platconf` [files-binpkg.pkg-platconf]
---------------------------------------------------
@@ -115,8 +110,7 @@ This file is optional. Its presence indicates that a binary package is
platform-specific.
This file contains a list of run-time configuration files to be installed in the
-binary package. Files listed in this file shall not be listed in the binary
-package's `install` file.
+binary package.
See $[sectlink][platconf] for the syntax of this file.
@@ -229,6 +223,3 @@ See $[sectlink][platconf] for the syntax of this file.
------------------
TODO
-
-
-[posix-xcu-2.6.6]: http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_06_06