Document the configuration file list format.

1 files changed, 25 insertions, 0 deletions

diff --git a/specs/source-package-format-1.0.txt b/specs/source-package-format-1.0.txt
index 3fa28dd..a9c3831 100644
--- a/specs/source-package-format-1.0.txt
+++ b/specs/source-package-format-1.0.txt
@@ -155,6 +155,31 @@ The fields in the source package metadata are:
     by angle brackets or any other characters.
 
 
+Configuration File List Format
+==============================
+
+Platform-specific configuration files used by the source package at build time
+or by the binary package(s) at run time should be listed in the file 'config'.
+
+Each file must be described with an entry of the following format:
+    type source destination
+
+"type" is the string "buildtime" for a file used at build time or "runtime" for
+a file used at run time.
+
+"source" is the path to the file, relative to the platform configuration
+directory -- either `/usr/share/config/PLATFORM/PACKAGE-VERSION` or
+`/usr/share/config/PLATFORM/PACKAGE`, where "PLATFORM" is the architcture string
+denoting an application platform, "PACKAGE" is the name of the configurable
+source package, and "VERSION" is the upstream version of the configurable source
+package.
+
+"destination" is the path (file or directory) to which the file should be
+copied.  For a file used at build time, it is a path relative to the package
+building work area.  For a file used at run time, it is an absolute path in the
+user's filesystem hierarchy.
+
+
 Change Log Format
 =================