commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject svn commit: r1652871 - in /commons/proper/net/trunk/src: changes/changes.xml site/xdoc/migration.xml
Date Sun, 18 Jan 2015 23:20:11 GMT
Author: sebb
Date: Sun Jan 18 23:20:10 2015
New Revision: 1652871

URL: http://svn.apache.org/r1652871
Log:
Document why Clirr errors are OK

Modified:
    commons/proper/net/trunk/src/changes/changes.xml
    commons/proper/net/trunk/src/site/xdoc/migration.xml

Modified: commons/proper/net/trunk/src/changes/changes.xml
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/changes/changes.xml?rev=1652871&r1=1652870&r2=1652871&view=diff
==============================================================================
--- commons/proper/net/trunk/src/changes/changes.xml [utf-8] (original)
+++ commons/proper/net/trunk/src/changes/changes.xml [utf-8] Sun Jan 18 23:20:10 2015
@@ -64,6 +64,10 @@ The <action> type attribute can be add,u
     <body>
         <release version="3.4" date="2015-01-??" description="
 This is mainly a bug-fix release. See further details below.
+
+  This release is binary compatible with previous releases.
+  However it is not source compatible, as some methods have been added to the interface NtpV3Packet
+
   Notable additions:
   IMAPExportMbox (example app) allows IMAP folders to be exported into an mbox file.
   This is the inverse of the IMAPImportMbox example added previously

Modified: commons/proper/net/trunk/src/site/xdoc/migration.xml
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/site/xdoc/migration.xml?rev=1652871&r1=1652870&r2=1652871&view=diff
==============================================================================
--- commons/proper/net/trunk/src/site/xdoc/migration.xml (original)
+++ commons/proper/net/trunk/src/site/xdoc/migration.xml Sun Jan 18 23:20:10 2015
@@ -31,6 +31,24 @@ This how-to lists the migration steps fo
 </p>
 </section>
 
+<section name="Commons Net 3.x to Commons Net 3.4">
+<p>
+Version 3.4 is binary compatible with previous 3.x versions and 2.0.
+There should be no changes required to existing binary code.
+</p>
+<p>
+However, version 3.4 is <b>not source compatible</b> with 3.3.
+</p>
+<p>
+The interface NtpV3Packet has been updated to add 3 new methods.
+Adding methods to an interface <a href="https://docs.oracle.com/javase/specs/jls/se5.0/html/binaryComp.html#45348">does
not affect binary compatibility</a>
+The <a href="clirr-report.html">clirr report</a> shows which methods have been
added.
+(note that the report does not distinguish between source and binary incompatibility)
+Code that uses the interface will need to be updated and recompiled.
+However code that uses the implementation class NtpV3Impl will continue to work as before.
+</p>
+</section>
+
 <section name="Commons Net 2.x to Commons Net 3.0">
     <p>
         Version 3.0 is binary compatible with version 2.0. There should be no changes required
to existing binary code.



Mime
View raw message