[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[PATCH 1/1] Better document version ranking and 0



Hi,

        The following patch, from branch bug458910-rra, looks good to
 me.

        manoj

> 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.

Acked-by: Manoj Srivastava <srivasta@debian.org>

>From: Russ Allbery <rra@debian.org>
>Date: Sun, 27 Apr 2008 19:00:41 -0700
---
 policy.sgml |   15 +++++++++------
 1 files changed, 9 insertions(+), 6 deletions(-)

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>
-- 
1.5.5.1


-- 
momentum, n.: What you give a person when they are going away.
Manoj Srivastava <srivasta@debian.org> <http://www.debian.org/~srivasta/>  
1024D/BF24424C print 4966 F272 D093 B493 410B  924B 21BA DABB BF24 424C


Reply to: