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>
</p>
<p>
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: