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.
