summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorP. J. McDermott <pjm@nac.net>2012-02-26 00:14:30 (EST)
committer P. J. McDermott <pjm@nac.net>2012-02-26 00:14:30 (EST)
commit9db3c6c4e60183a1cd9c6fdc69fad510b72048ee (patch)
tree57aaf8fa1baeb09cbbbb1dff7b39a78221adbed0
parente7ada68fd28ad0ba4198d1262d5659c9e9b02fa5 (diff)
Expand on source package directory structure spec.
-rw-r--r--specs/source-package-format-1.0.txt22
1 files changed, 19 insertions, 3 deletions
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
=================