diff options
author | P. 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) |
commit | 15046491e9ba4a9f2b3a7333ef201a1396b3d332 (patch) | |
tree | 67eccfcf8d5278895630e1008aede3d3753bd619 | |
parent | f553f9947cb970d75ab3e7e2826a10a27cb834cc (diff) |
Document 'Version' control field in format spec.
-rw-r--r-- | specs/source-package-format-1.0.txt | 16 |
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. |