On Mon, Oct 21, 2013 at 12:16 AM, Stefan Bodewig <bode...@apache.org> wrote:

> On 2013-10-16, Gary Gregory wrote:
>
> > Now that we have a new cleaned up RC, I want to make sure that we
> > understand that, strictly speaking and while unlikely in practice,
> > 1.6-RC2 breaks binary compatibility with 1.5 (see Clirr). I think we
> > started discussing this and after some hand-waving some folks are OK
> > with it. I'm not comfortable with it due to getting bitten in large
> > integration projects by issues like this and jar hell balls. I'll
> > likely defer to the SMEs here but I just want to double check
> > specifically on this RC vote thread and hear back before I vote.
>
> Technically this vote has had enough +1s to close it but let me try to
> address your concern by repeating and elaborating the alleged
> hand-waving:
>
> Clirr whines about a protected field that's been removed from two
> classes in the tar package.  The type of this protected field has been
> TarBuffer which has been removed, was package private and didn't
> implement any interface.  Clirr does not raise an error because of
> TarBuffer being removed as it doesn't consider the class a part of the
> public API.
>
> The only people who may get bitten by this change must have written
> subclasses of one of the Tar*Stream classes and put them into the same
> package that we use in order to gain access to a non-public type.
>

Thank you Stefan,

That is the kind of nice and clear explanation I was seeking.

It would have been fantastic to have this explanation in the release notes
along with what to expect for compatibility.

For an example, see [io]:
https://svn.apache.org/repos/asf/commons/proper/io/trunk/RELEASE-NOTES.txt

Another nice aspect of the [io] release notes, is that the notes for ALL
releases are in the file. If I am updating from version N - X to N, I can
see what to expect from an old release X all the way to the current release
N.

Gary


> Stefan
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
> For additional commands, e-mail: dev-h...@commons.apache.org
>
>


-- 
E-Mail: garydgreg...@gmail.com | ggreg...@apache.org
Java Persistence with Hibernate, Second Edition<http://www.manning.com/bauer3/>
JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
Spring Batch in Action <http://www.manning.com/templier/>
Blog: http://garygregory.wordpress.com
Home: http://garygregory.com/
Tweet! http://twitter.com/GaryGregory

Reply via email to