Raphael Hertzog <[EMAIL PROTECTED]> 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 ([EMAIL PROTECTED])               <http://www.eyrie.org/~eagle/>


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to