From c2df77fb4f53916119197d681374a2ca039a0e24 Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pjm@nac.net>
Date: Sun, 26 Aug 2012 17:51:11 -0400
Subject: Move documentation of install files to Metadata.

---
(limited to 'specs/spf-2.0/metadata.mdwn')

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
--
cgit v0.9.1