From 63089c9cbe835e0fcad19091f36c16fdc355b2c3 Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pjm@nac.net>
Date: Sun, 26 Feb 2012 00:14:30 -0500
Subject: Expand on source package directory structure spec.

---
(limited to 'specs/source-package-format-1.0.txt')

diff --git a/specs/source-package-format-1.0.txt b/specs/source-package-format-1.0.txt
index 209bfca..1f45c23 100644
--- a/specs/source-package-format-1.0.txt
+++ b/specs/source-package-format-1.0.txt
@@ -41,8 +41,7 @@ Directory Structure
 ===================
 
 The source package directory hierarchy can be summarized with the following
-tree, where "<binpkg>" is the name of each binary package generated by the
-source package:
+tree:
 
     <source-package-directory>/
      +- <binpkg>.pkg/
@@ -70,11 +69,28 @@ source package:
      |    contain the string "1.0".
      +- patches/
      |    Patches to be applied to package sources before building.
-     +- <pkgname>_<pkgver>.<ext>
+     +- <pkgname>_<pkgver>.tar.<ext>
      |    Upstream source archive (for non-native packages).
      \- src/
           Package sources (for native packages).
 
+`<source-package-directory>` is the directory in which all packaging work is
+done.  There are no constraints on the name of this directory.
+
+`<binpkg>` is the name of each binary package generated by the source package.
+
+`<pkgname>` is the name of the source package.
+
+`<pkgver>` is the upstream source version.
+
+`<ext>` is a compression format file extension.  It must be one of the
+following:
+
+  * `gz` for the "gzip" algorithm.
+  * `bz2` for the "bzip2" algorithm.
+  * `lz` for the "LZMA" algorithm.
+  * `Z` for the "compress" algorithm.
+
 
 Build File Format
 =================
--
cgit v0.9.1