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

Re: Please review Policy change for ~ in versions

Raphael Hertzog <hertzog@debian.org> writes:

> Maybe give more concrete examples of usage of the tilde? 

> I know this is the policy, but it should still translate in useful
> information for the packager: I expect to see at least an example
> explaining that "1.0~beta1~svn1245 < 1.0~beta1 < 1.0"

How about the following (applied over top of the previous patch; sorry
about that):

--- orig/policy.sgml
+++ mod/policy.sgml
@@ -2716,7 +2716,13 @@
 	    sort earlier than all the non-letters and so that a tilde
 	    sorts before anything, even the end of a part.  For example,
 	    the following parts are in sorted order: <tt>~~</tt>,
-	    <tt>~~a</tt>, <tt>~</tt>, the empty part, <tt>a</tt>.
+	    <tt>~~a</tt>, <tt>~</tt>, the empty part,
+	    <tt>a</tt>.<footnote>
+	      One common use of <tt>~</tt> is for upstream pre-releases.
+	      For example, this sort means <tt>1.0~beta1~svn1245</tt>
+	      sorts earlier than <tt>1.0~beta1</tt>, which sorts earlier
+	      than <tt>1.0</tt>.
+	    </footnote>

Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>

Reply to: