From: "Vít Ondruch" <v.ondruch@...>
Date: 2012-11-07T00:31:58+09:00
Subject: [ruby-core:48982] Re: [ANN] ruby 2.0.0-preview1 released

--20cf303349d75d399404cdd54d65
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

2012/11/6 Yusuke Endoh <mame@tsg.ne.jp>

> Hello Vit,
>
> 2012/11/6 V=EDt Ondruch <v.ondruch@gmail.com>:
> > 2012/11/2 Yusuke Endoh <mame@tsg.ne.jp>
> >>
> >> We have taken considerable care in source-level compatibility with
> >> 1.9.  We believe all "normal" programs will work without modification.
> >> So, please give it a try, and report if your program does not work.
> >
> >
> > Does it mean that Ruby 2.0 will breaks ABI, e.g. the ABI will be 2.0.0
> > instead of 1.9.1 (as it was for Ruby 1.9.3).
>
> Yes, ABI will be incompatible with 1.9.1.  So, to be precise:
>
> - You can use existing "normal" Ruby scripts without modification
>
> - You can use "normal" source code of existing extenstion libraries
>   without modification, but re-compilation is needed.
>


If I am not mistaken, then this is ABI breakage. In other words as soon as
you need to rebuild your binary extensions, it is ABI breakage. Since the
.so name was renamed to libruby.2.0.0.so, it would be fine, but I'd really
love to see this clarified. If you claim that ABI is not broken, then .so
file should not be renamed nor rebuild should be needed, i.e. it should
stay libruby.1.9.1.so (
https://github.com/ruby/ruby/commit/a06a1772f3c7d7703adcad05ba10711212b1d15=
4should
be reverted in that case).



>
> Note: #6679 was introduced after preview1, which may cause a big
> compatibility issue, especially, for non-utf-8 users.  We will
> estimate the impact with preview2 release.
>
> BTW: I'm thinking to change the ABI version *name*.  Ruby 2.0.1 will
> use the same ABI version "2.0.0", which is very confusing, based on
> the experience of "1.9.1".  I'd like to name it "2.0", but I must
> talk with matz.
>

The only exception to rename the .so file could be to fix this issue, but
then, you will not be ABI compatible anymore IMO, so you should probably
avoid such change.


>
>
> >  I am just asking, since the .so
> > file is currently named libruby.2.0.0.so and abi-compliance-checker
> confirms
> > it (see attachment).
>
> Thank you, very interesting.
> The following functions (or global variables) disappered, right?
>

Right.


> We should check each if the deletion won't cause compatibility issue.
>

Deletion definitely means broken ABI compatibility and the source
compatibility might be broken as well.


>
> Removed Symbols (25)
>   OnigSyntaxPerl_NG [data]
>   rb_barrier_destroy ( ... )
>   rb_barrier_new ( ... )
>   rb_barrier_release ( ... )
>   rb_barrier_wait ( ... )
>   rb_disable_interrupt ( ... )
>   rb_enable_interrupt ( ... )
>   rb_file_const ( ... )
>   rb_file_load_ok ( ... )
>   rb_float_new ( ... )
>   rb_gc_mark_parser ( ... )
>   rb_gc_mark_symbols ( ... )
>   rb_gc_mark_threads ( ... )
>   rb_infinity [data]
>   rb_load_fail ( ... )
>   rb_mark_end_proc ( ... )
>   rb_nan [data]
>   rb_path_end ( ... )
>   rb_path_last_separator ( ... )
>   rb_path_next ( ... )
>   rb_path_skip_prefix ( ... )
>   rb_vm_get_sourceline ( ... )
>   rb_vm_make_env_object ( ... )
>   ruby_find_basename ( ... )
>   ruby_find_extname ( ... )
>
> --
> Yusuke Endoh <mame@tsg.ne.jp>
>
>

--20cf303349d75d399404cdd54d65
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

<br><br><div class=3D"gmail_quote">2012/11/6 Yusuke Endoh <span dir=3D"ltr"=
>&lt;<a href=3D"mailto:mame@tsg.ne.jp" target=3D"_blank">mame@tsg.ne.jp</a>=
&gt;</span><br><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex=
;border-left:1px #ccc solid;padding-left:1ex">
Hello Vit,<br>
<br>
2012/11/6 V=EDt Ondruch &lt;<a href=3D"mailto:v.ondruch@gmail.com">v.ondruc=
h@gmail.com</a>&gt;:<br>
<div class=3D"im">&gt; 2012/11/2 Yusuke Endoh &lt;<a href=3D"mailto:mame@ts=
g.ne.jp">mame@tsg.ne.jp</a>&gt;<br>
&gt;&gt;<br>
&gt;&gt; We have taken considerable care in source-level compatibility with=
<br>
&gt;&gt; 1.9. =A0We believe all &quot;normal&quot; programs will work witho=
ut modification.<br>
&gt;&gt; So, please give it a try, and report if your program does not work=
.<br>
&gt;<br>
&gt;<br>
&gt; Does it mean that Ruby 2.0 will breaks ABI, e.g. the ABI will be 2.0.0=
<br>
&gt; instead of 1.9.1 (as it was for Ruby 1.9.3).<br>
<br>
</div>Yes, ABI will be incompatible with 1.9.1. =A0So, to be precise:<br>
<br>
- You can use existing &quot;normal&quot; Ruby scripts without modification=
<br>
<br>
- You can use &quot;normal&quot; source code of existing extenstion librari=
es<br>
=A0 without modification, but re-compilation is needed.<br></blockquote><di=
v><br><br>If I am not mistaken, then this is ABI breakage. In other words a=
s soon as you need to rebuild your binary extensions, it is ABI breakage. S=
ince the .so name was renamed to <a href=3D"http://libruby.2.0.0.so">librub=
y.2.0.0.so</a>, it would be fine, but I&#39;d really love to see this clari=
fied. If you claim that ABI is not broken, then .so file should not be rena=
med nor rebuild should be needed, i.e. it should stay <a href=3D"http://lib=
ruby.1.9.1.so">libruby.1.9.1.so</a> (<a href=3D"https://github.com/ruby/rub=
y/commit/a06a1772f3c7d7703adcad05ba10711212b1d154">https://github.com/ruby/=
ruby/commit/a06a1772f3c7d7703adcad05ba10711212b1d154</a> should be reverted=
 in that case).<br>
<br>=A0<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8=
ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Note: #6679 was introduced after preview1, which may cause a big<br>
compatibility issue, especially, for non-utf-8 users. =A0We will<br>
estimate the impact with preview2 release.<br>
<br>
BTW: I&#39;m thinking to change the ABI version *name*. =A0Ruby 2.0.1 will<=
br>
use the same ABI version &quot;2.0.0&quot;, which is very confusing, based =
on<br>
the experience of &quot;1.9.1&quot;. =A0I&#39;d like to name it &quot;2.0&q=
uot;, but I must<br>
talk with matz.<br></blockquote><div><br>The only exception to rename the .=
so file could be to fix this issue, but then, you will not be ABI compatibl=
e anymore IMO, so you should probably avoid such change.<br>=A0<br></div>
<blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p=
x #ccc solid;padding-left:1ex">
<div class=3D"im"><br>
<br>
&gt; =A0I am just asking, since the .so<br>
&gt; file is currently named <a href=3D"http://libruby.2.0.0.so" target=3D"=
_blank">libruby.2.0.0.so</a> and abi-compliance-checker confirms<br>
&gt; it (see attachment).<br>
<br>
</div>Thank you, very interesting.<br>
The following functions (or global variables) disappered, right?<br></block=
quote><div><br>Right.<br>=A0<br></div><blockquote class=3D"gmail_quote" sty=
le=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
We should check each if the deletion won&#39;t cause compatibility issue.<b=
r></blockquote><div><br>Deletion definitely means broken ABI compatibility =
and the source compatibility might be broken as well.<br>=A0<br></div><bloc=
kquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #cc=
c solid;padding-left:1ex">

<br>
Removed Symbols (25)<br>
=A0 OnigSyntaxPerl_NG [data]<br>
=A0 rb_barrier_destroy ( ... )<br>
=A0 rb_barrier_new ( ... )<br>
=A0 rb_barrier_release ( ... )<br>
=A0 rb_barrier_wait ( ... )<br>
=A0 rb_disable_interrupt ( ... )<br>
=A0 rb_enable_interrupt ( ... )<br>
=A0 rb_file_const ( ... )<br>
=A0 rb_file_load_ok ( ... )<br>
=A0 rb_float_new ( ... )<br>
=A0 rb_gc_mark_parser ( ... )<br>
=A0 rb_gc_mark_symbols ( ... )<br>
=A0 rb_gc_mark_threads ( ... )<br>
=A0 rb_infinity [data]<br>
=A0 rb_load_fail ( ... )<br>
=A0 rb_mark_end_proc ( ... )<br>
=A0 rb_nan [data]<br>
=A0 rb_path_end ( ... )<br>
=A0 rb_path_last_separator ( ... )<br>
=A0 rb_path_next ( ... )<br>
=A0 rb_path_skip_prefix ( ... )<br>
=A0 rb_vm_get_sourceline ( ... )<br>
=A0 rb_vm_make_env_object ( ... )<br>
=A0 ruby_find_basename ( ... )<br>
=A0 ruby_find_extname ( ... )<br>
<span class=3D"HOEnZb"><font color=3D"#888888"><br>
--<br>
Yusuke Endoh &lt;<a href=3D"mailto:mame@tsg.ne.jp">mame@tsg.ne.jp</a>&gt;<b=
r>
<br>
</font></span></blockquote></div><br>

--20cf303349d75d399404cdd54d65--