From 15046491e9ba4a9f2b3a7333ef201a1396b3d332 Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pjm@nac.net>
Date: Thu, 08 Mar 2012 11:58:25 -0500
Subject: Document 'Version' control field in format spec.

---
(limited to 'specs')

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.
--
cgit v0.9.1