Re: Please review Policy change for ~ in versions

[Raphael Hertzog]

On Mon, 06 Nov 2006, Russ Allbery wrote:
> 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):

Sounds good (with the simplification of the wording proposed by Nicolas).

Cheers,
-- 
Raphaël Hertzog

Premier livre français sur Debian GNU/Linux :
http://www.ouaza.com/livre/admin-debian/


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

Re: Please review Policy change for ~ in versions

[Nicolas François]

On Mon, Nov 06, 2006 at 09:11:06AM -0800, Russ Allbery wrote:
> 
> --- 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: ~~,
> - ~~a, ~, the empty part, a.
> + ~~a, ~, the empty part,
> + a.
> +   One common use of ~ is for upstream pre-releases.
> +   For example, this sort means 1.0~beta1~svn1245

Maybe this last line should be:

  For example, 1.0~beta1~svn1245

> +   sorts earlier than 1.0~beta1, which sorts earlier
> +   than 1.0.
> + 
> 


Kind Regards,
-- 
Nekral


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

Re: Please review Policy change for ~ in versions

[Russ Allbery]

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: ~~,
-   ~~a, ~, the empty part, a.
+   ~~a, ~, the empty part,
+   a.
+ One common use of ~ is for upstream pre-releases.
+ For example, this sort means 1.0~beta1~svn1245
+ sorts earlier than 1.0~beta1, which sorts earlier
+ than 1.0.
+   
  
 
  

-- 
Russ Allbery ([EMAIL PROTECTED])   


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

Re: Please review Policy change for ~ in versions

[Raphael Hertzog]

On Sun, 05 Nov 2006, Russ Allbery wrote:
> @@ -2713,7 +2713,10 @@
>   which may be empty) are compared lexically.  If a difference
>   is found it is returned.  The lexical comparison is a
>   comparison of ASCII values modified so that all the letters
> - sort earlier than all the non-letters.
> + 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: ~~,
> + ~~a, ~, the empty part, a.
> 

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"

Cheers,
-- 
Raphaël Hertzog

Premier livre français sur Debian GNU/Linux :
http://www.ouaza.com/livre/admin-debian/


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

Re: Please review Policy change for ~ in versions

[Guillem Jover]

Hi Russ,

On Sun, 2006-11-05 at 18:50:26 -0800, Russ Allbery wrote:
> Could you please review the following patch to Debian Policy to document
> the use of ~ in version numbers and confirm that this matches dpkg's
> behavior?  I'd like to get this into Policy since it's already in
> widespread use in the archive, but the Policy proposal has gotten very few
> comments.

> --- policy.sgml.orig  2006-06-19 22:20:13.0 -0700
> +++ policy.sgml   2006-09-08 13:09:35.0 -0700
> @@ -2649,8 +2649,8 @@
>   Alphanumerics are A-Za-z0-9 only.
> 
> and the characters . + -
> -   : (full stop, plus, hyphen, colon) and should
> -   start with a digit.  If there is no
> +   : ~ (full stop, plus, hyphen, colon,
> +   tilde) and should start with a digit.  If there is no
> debian_revision then hyphens are not allowed;
> if there is no epoch then colons are not
> allowed.
> @@ -2663,8 +2663,8 @@
> This part of the version number specifies the version of
> the Debian package based on the upstream version.  It
> may contain only alphanumerics and the characters
> -   + and . (plus and full stop) and is
> -   compared in the same way as the
> +   + . ~ (plus, full stop,
> +   tilde) and is compared in the same way as the
> upstream_version is.
>   
>  
> @@ -2713,7 +2713,10 @@
>   which may be empty) are compared lexically.  If a difference
>   is found it is returned.  The lexical comparison is a
>   comparison of ASCII values modified so that all the letters
> - sort earlier than all the non-letters.
> + 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: ~~,
> + ~~a, ~, the empty part, a.
> 
>  
> 

Seems right.

thanks,
guillem


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