From: Russ Allbery <rra@debian.org>
Date: Mon, 28 Apr 2008 02:00:41 +0000 (-0700)
Subject: Better document version ranking and 0
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=2d210c6df32ea5126179da2be4c1e3b5b4d713a5;p=debian%2Fdebian-policy.git

Better document version ranking and 0

Document that an empty Debian revision is equivalent to a Debian
revision of 0 and clarify the way version numbers are compared.  Thanks
to Raphael Hertzog for information about what dpkg does.
---

diff --git a/policy.sgml b/policy.sgml
index 1c9a339..b7ac92e 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -2877,19 +2877,22 @@ Package: libc6
 	          number apart at the last hyphen in the string (if there
 	          is one) to determine the <var>upstream_version</var> and
 	          <var>debian_revision</var>.  The absence of a
-	          <var>debian_revision</var> compares earlier than the
-	          presence of one (but note that the
-	          <var>debian_revision</var> is the least significant part
-	          of the version number).
+	          <var>debian_revision</var> is equivalent to a
+	          <var>debian_revision</var> of <tt>0</tt>.
 	        </p>
 	      </item>
 	    </taglist>
 	  </p>
 
 	  <p>
-	    The <var>upstream_version</var> and <var>debian_revision</var>
+	    When comparing two version numbers, first the <var>epoch</var>
+	    of each are compared, then the <var>upstream_version</var> if
+	    <var>epoch</var> is equal, and then <var>debian_revision</var>
+	    if <var>upstream_version</var> is also equal.
+	    <var>epoch</var> is compared numerically.  The
+	    <var>upstream_version</var> and <var>debian_revision</var>
 	    parts are compared by the package management system using the
-	    same algorithm:
+	    following algorithm:
 	  </p>
 
 	  <p>