summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorP. J. McDermott <pjm@nac.net>2012-03-08 11:58:25 (EST)
committer P. J. McDermott <pjm@nac.net>2012-03-08 11:58:25 (EST)
commit1e5971a73338042cabe6add480fbec9f9ab1de72 (patch)
treef5683271c22cd25ccdcfdf896a0ffba29f817935
parentce1bb8b9b849bfce12ed99ea5b9551fcd15fdbe0 (diff)
Document 'Version' control field in format spec.
-rw-r--r--specs/source-package-format-1.0.txt16
1 files changed, 15 insertions, 1 deletions
diff --git a/specs/source-package-format-1.0.txt b/specs/source-package-format-1.0.txt
index 7a89082..63d5db4 100644
--- a/specs/source-package-format-1.0.txt
+++ b/specs/source-package-format-1.0.txt
@@ -1,6 +1,6 @@
Title: Source Package Format 1.0
Status: DRAFT
- Date: 2012-03-07
+ Date: 2012-03-08
1. Status of This Document
@@ -234,6 +234,20 @@ The fields in the source package metadata are:
must be at least two characters long and must start with either a letter or
a digit.
+ * `Version` (required)
+ The version number of the package. The format is:
+
+ <upstream_version>[-<package_revision>]
+
+ `<upstream_version>` is the version of the original upstream package, if
+ any.
+
+ `<package_revision>` is the version of the distribution packaging. It is
+ optional and should be omitted for native packages. It should be
+ incremented for each uploaded revision of packaging for the same upstream
+ package version. It should be reset for the first uploaded revision of
+ packaging for a new upstream package version.
+
* `Maintainer` (required)
The name and e-mail address of the package maintainer. This field must
follow the syntax of the `mailbox` symbol in RFC 5322 section 3.4.