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 | 1e5971a73338042cabe6add480fbec9f9ab1de72 (patch) | |
| tree | f5683271c22cd25ccdcfdf896a0ffba29f817935 | |
| parent | ce1bb8b9b849bfce12ed99ea5b9551fcd15fdbe0 (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. |