Documentation changes from 2.1-rc0

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/vfs/trunk@1742209 13f79535-47bb-0310-9956-ffa450edef68

RELEASE-NOTES.txt

@@ -190,6 +190,11 @@ o VFS-361:  Upgrade commons collections version to 3.2.1.
 Removed:
 o VFS-469:  Remove unused dependency to javax.jcr:jcr.
 
+Please note that release 2.1 is not completely binary compatible with the previous 2.0 release. This
+is primarily due to the upgrade of Apache Commons Compress to 1.6 and is limited to the TarFileProvider
+and related classes. All other errors reported in the Clirr report should be binary compatible as
+they consist of method additions.
+
 Historical list of changes: http://commons.apache.org/proper/commons-vfs/changes-report.html
 
 For complete information on Apache Commons VFS, including instructions on how to submit bug reports,

src/site/xdoc/index.xml

@@ -81,8 +81,8 @@
             to replace 2.0 with 2.1 without the need for changes to API consumers. VFS 2.1 has introduced some now 
             methods for provider interfaces (like <code>FileObject</code>). If you implement a VFS provider and use the
             corresponding <code>Abstract*</code> or <code>Default*</code> classes, there should be no need to modify
-            the code or recompile the provider.
-            See the <a href="https://archive.apache.org/dist/commons/vfs/RELEASE_NOTES.txt">Release Notes</a> and the
+            the code or recompile the provider. The TarFileProvider is one known exception to compatibility with 2.0.
+            See the <a href="https://dist.apache.org/repos/dist/dev/commons/vfs/RELEASE-NOTES.txt">Release Notes</a> and the
             <a href="commons-vfs2/clirr-report.html">Clirr Report</a> for details. VFS 2.1 adds a new read-only provider
             for the Apache Hadoop (HDFS) File system.
           </p><p>