This is an automated email from the ASF dual-hosted git repository.

ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-vfs.git


The following commit(s) were added to refs/heads/master by this push:
     new aacedeb  Preparing for the next release.
aacedeb is described below

commit aacedebc5fb505b44393b82705f52adc810b3e8a
Author: Gary Gregory <gardgreg...@gmail.com>
AuthorDate: Thu Jul 11 10:32:27 2019 -0400

    Preparing for the next release.
    
    - Javadoc
    - Release notes items on source compatibility.
    - Use HTTPS in URLs.
---
 NOTICE.txt                                         |  2 +-
 README.md                                          |  7 ++-
 RELEASE-NOTES.txt                                  | 62 ++++++++++++++++++++++
 .../java/org/apache/commons/vfs2/FileContent.java  |  1 +
 .../java/org/apache/commons/vfs2/FileFilter.java   |  2 +-
 .../org/apache/commons/vfs2/FileSelectInfo.java    |  2 +-
 .../commons/vfs2/provider/AbstractFileObject.java  |  7 ++-
 .../vfs2/provider/ftp/FtpClientFactory.java        |  2 +-
 .../provider/ftp/FtpFileSystemConfigBuilder.java   |  4 +-
 .../commons/vfs2/provider/sftp/IdentityInfo.java   |  3 ++
 .../provider/sftp/SftpFileSystemConfigBuilder.java | 14 ++---
 .../commons/vfs2/util/MonitorInputStream.java      |  1 +
 .../commons/vfs2/util/MonitorOutputStream.java     |  2 +
 .../apache/commons/vfs2/filter/BaseFilterTest.java |  2 +-
 .../vfs2/filter/SymbolicLinkFileFilterTest.java    |  4 +-
 pom.xml                                            | 37 +++++++++++--
 src/changes/changes.xml                            | 13 +++++
 src/site/xdoc/download_vfs.xml                     | 34 ++++++------
 src/site/xdoc/index.xml                            |  5 +-
 src/site/xdoc/issue-tracking.xml                   |  2 +-
 src/site/xdoc/mail-lists.xml                       | 30 +++++------
 21 files changed, 179 insertions(+), 57 deletions(-)

diff --git a/NOTICE.txt b/NOTICE.txt
index a92a74f..801b6fc 100644
--- a/NOTICE.txt
+++ b/NOTICE.txt
@@ -2,4 +2,4 @@ Apache Commons VFS Project
 Copyright 2002-2019 The Apache Software Foundation
 
 This product includes software developed at
-The Apache Software Foundation (http://www.apache.org/).
+The Apache Software Foundation (https://www.apache.org/).
diff --git a/README.md b/README.md
index c03c9bb..2afade9 100644
--- a/README.md
+++ b/README.md
@@ -46,7 +46,7 @@ Apache Commons VFS Project
 [![Build 
Status](https://travis-ci.org/apache/commons-vfs.svg)](https://travis-ci.org/apache/commons-vfs)
 [![Coverage 
Status](https://coveralls.io/repos/apache/commons-vfs/badge.svg)](https://coveralls.io/r/apache/commons-vfs)
 [![Maven 
Central](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-vfs2/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-vfs2/)
-[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-vfs2/2.3.svg)](https://javadoc.io/doc/org.apache.commons/commons-vfs2/2.3)
+[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-vfs2/2.4.svg)](https://javadoc.io/doc/org.apache.commons/commons-vfs2/2.4)
 
 Apache Commons VFS is a Virtual File System library.
 
@@ -54,7 +54,7 @@ Documentation
 -------------
 
 More information can be found on the [Apache Commons VFS Project 
homepage](https://commons.apache.org/proper/commons-vfs).
-The 
[Javadoc](https://commons.apache.org/proper/commons-vfs/javadocs/api-release) 
can be browsed.
+The [Javadoc](https://commons.apache.org/proper/commons-vfs/apidocs) can be 
browsed.
 Questions related to the usage of Apache Commons VFS Project should be posted 
to the [user mailing list][ml].
 
 Where can I get the latest release?
@@ -67,7 +67,7 @@ Alternatively you can pull it from the central Maven 
repositories:
 <dependency>
   <groupId>org.apache.commons</groupId>
   <artifactId>commons-vfs2</artifactId>
-  <version>2.3</version>
+  <version>2.4</version>
 </dependency>
 ```
 
@@ -103,4 +103,3 @@ Additional Resources
 + `#apache-commons` IRC channel on `irc.freenode.org`
 
 [ml]:https://commons.apache.org/mail-lists.html
-
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 9708e15..153b480 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,3 +1,65 @@
+              Apache Commons VFS Project 2.4
+                  RELEASE NOTES
+
+The Apache Commons VFS Project team is pleased to announce the release of 
Apache Commons VFS Project 2.4.
+
+Apache Commons VFS is a Virtual File System library.
+
+New features and bug fix release.
+
+Changes in this version include:
+
+New features:
+o VFS-690:  Allow to set key exchange algorithm explicitly. GitHub #32.
+o VFS-497:  Ported filters from Commons IO #9. Thanks to Michael Schnell.
+o VFS-696:  More efficient comparison in FileExtensionSelector #44. Thanks to 
Robert DeRose.
+o VFS-660:  Expose workaround for connecting to FTP server from different 
subnets in PASV mode #35. Thanks to Liu Yubao.
+o VFS-699:  Add setting for FTP encoding auto-detection #58. Thanks to Boris 
Petrov.
+o VFS-706:  Add ability to specify buffer sizes #59. Thanks to Boris Petrov.
+o VFS-609:  SFTP provider doesn't support a private key as byte array #60. 
Thanks to stevezhuang, Rostislav, Gary Gregory.
+o VFS-707:  Update Apache HttpClient from 4.5.7 to 4.5.8. Thanks to Gary 
Gregory.
+o VFS-712:  Add null-safe 
org.apache.commons.vfs2.util.FileObjectUtils.exists(FileObject). Thanks to Gary 
Gregory.
+o VFS-713:  Add FileObjectUtils.readProperties(FileObject) method to read a 
.properties file. Thanks to Gary Gregory.
+o VFS-715:  Add org.apache.commons.vfs2.FileContent.getByteArray(). Thanks to 
Gary Gregory.
+o VFS-719:  Add methods to get the contents of file objects as strings. Thanks 
to Gary Gregory.
+o VFS-720:  Implement Closeable for RandomAccessContent #66. Thanks to Boris 
Petrov.
+o VFS-721:  Add support for symbolic links for the local file system and add 
FileObject#isSymbolicLink(). Thanks to Gary Gregory.
+
+Fixed Bugs:
+o VFS-694:  Fix inability to start the DefaultFileMonitor after it has been 
stopped. GitHub PR #55. Thanks to Boris Petrov.
+o VFS-696:  SFTP HTTP and SOCKS proxy authentication. GitHub PR #49. Thanks to 
rayzzed.
+o VFS-707:  [SFTP] SftpFileSystem.executeCommand(String, StringBuilder) can 
leak ChannelExec objects. Thanks to Gary Gregory.
+o VFS-709:  [SFTP] SftpFileSystem.getGroupsIds() can initialize underlying 
data more than once while multithreading. Thanks to Gary Gregory.
+o VFS-710:  [SFTP] SftpFileSystem.getUid() can initialize underlying data more 
than once while multithreading. Thanks to Gary Gregory.
+o VFS-711:  [SFTP] SftpFileSystem can initialize underlying Session more than 
once while multithreading. Thanks to Gary Gregory.
+o VFS-662:  [SFTP] SftpFileSystem has Thread-safe issue about idleChannel 
(#36). Thanks to qxo, Alexey Abashev, Gary Gregory.
+o VFS-700:  Some tests fail on Java 11 and above. Thanks to Gary Gregory, 
Matthias Krueger.
+o VFS-716:  Fix AbstractFileName.getURI returning unencoded #-sign #64. Thanks 
to Boris Petrov.
+o VFS-698:  SFTP file attributes are fetched multiple times leading to very 
slow directory listing; #65. Thanks to David Septimus, Bernd.
+o VFS-717:  Update org.apache.httpcomponents:httpclient from 4.5.8 to 4.5.9. 
Thanks to Gary Gregory.
+o VFS-718:  MonitorInputStream should not close the stream in "read" #67. 
Thanks to Boris Petrov.
+
+Changes:
+o VFS-692:  Update Apache Commons Collections from 4.2 to 4.3. Thanks to Gary 
Gregory.
+o VFS-693:  Add support for customizing FTP transfer aborted status codes. 
GitHub PR #51. Thanks to Boris Petrov, Gary Gregory.
+o VFS-702:  Simplify adding files to DefaultFileMonitor #57. Thanks to Boris 
Petrov.
+o VFS-703:  Update Apache Commons Lang from 3.8.1 to 3.9. Thanks to Gary 
Gregory.
+o VFS-722:  Update Apache Commons Collections from 4.3 to 4.4. Thanks to Gary 
Gregory.
+o           Source incompatibility: 
org.apache.commons.vfs2.FileFilter.accept(FileSelectInfo) now throws checked 
exception FileSystemException.
+o           Public API note: The overridden methods getURI() and 
getFriendlyURI() in org.apache.commons.vfs2.provider.local.LocalFileName where 
removed but are implemented in a superclass.
+o           Public API note: The overridden method 
org.apache.commons.vfs2.provider.sftp.SftpFileObject#refresh() was removed but 
is implemented in a superclass.
+o           Public API note: The overridden method 
org.apache.commons.vfs2.provider.sftp.SftpFileProvider#init() was removed but 
is implemented in a superclass.
+
+
+Historical list of changes: 
http://commons.apache.org/proper/commons-vfs/changes-report.html
+
+For complete information on Apache Commons VFS Project, including instructions 
on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Apache Commons VFS 
Project website:
+
+http://commons.apache.org/proper/commons-vfs/
+
+-----------------------------------------------------------------------------
+
               Apache Commons VFS Project 2.3
                   RELEASE NOTES
 
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileContent.java 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileContent.java
index 27d1c4d..1e05055 100644
--- a/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileContent.java
+++ b/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileContent.java
@@ -42,6 +42,7 @@ import org.apache.commons.vfs2.util.RandomAccessMode;
  * @see FileObject#getContent
  */
 public interface FileContent extends Closeable {
+
     /**
      * Closes all resources used by the content, including any open stream. 
Commits pending changes to the file.
      * <p>
diff --git a/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileFilter.java 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileFilter.java
index 485c7b2..b2f556a 100644
--- a/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileFilter.java
+++ b/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileFilter.java
@@ -26,7 +26,7 @@ public interface FileFilter {
      *
      * @param fileInfo the file or folder to select.
      * @return true if the file should be selected.
-     * @throws FileSystemException Thrown for file system errors.
+     * @throws FileSystemException Thrown for file system errors (since 2.4.)
      */
     boolean accept(final FileSelectInfo fileInfo) throws FileSystemException;
 }
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileSelectInfo.java 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileSelectInfo.java
index 2938b0d..7c10e5e 100644
--- a/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileSelectInfo.java
+++ b/commons-vfs2/src/main/java/org/apache/commons/vfs2/FileSelectInfo.java
@@ -23,7 +23,7 @@ package org.apache.commons.vfs2;
  * </p>
  */
 public interface FileSelectInfo {
-    
+
     /**
      * Returns the base folder of the traversal.
      *
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/AbstractFileObject.java
 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/AbstractFileObject.java
index 1fac6f0..2515849 100644
--- 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/AbstractFileObject.java
+++ 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/AbstractFileObject.java
@@ -508,6 +508,7 @@ public abstract class AbstractFileObject<AFS extends 
AbstractFileSystem> impleme
      * @throws Exception if an error occurs.
      */
     protected void doAttach() throws Exception {
+        // noop
     }
 
     /**
@@ -563,6 +564,7 @@ public abstract class AbstractFileObject<AFS extends 
AbstractFileSystem> impleme
      * @throws Exception if an error occurs.
      */
     protected void doDetach() throws Exception {
+        // noop
     }
 
     /**
@@ -1693,9 +1695,10 @@ public abstract class AbstractFileObject<AFS extends 
AbstractFileSystem> impleme
     }
 
     /**
-     * will be called after this file-object closed all its streams.
+     * Clled after this file-object closed all its streams.
      */
     protected void notifyAllStreamsClosed() {
+        // noop
     }
 
     /**
@@ -1728,6 +1731,7 @@ public abstract class AbstractFileObject<AFS extends 
AbstractFileSystem> impleme
      * @throws Exception if an error occurs.
      */
     protected void onChange() throws Exception {
+        // noop
     }
 
     /**
@@ -1742,6 +1746,7 @@ public abstract class AbstractFileObject<AFS extends 
AbstractFileSystem> impleme
      * @throws Exception if an error occurs.
      */
     protected void onChildrenChanged(final FileName child, final FileType 
newType) throws Exception {
+        // noop
     }
 
     /**
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/ftp/FtpClientFactory.java
 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/ftp/FtpClientFactory.java
index 098310b..ea7e738 100644
--- 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/ftp/FtpClientFactory.java
+++ 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/ftp/FtpClientFactory.java
@@ -150,7 +150,7 @@ public final class FtpClientFactory {
                         client.setControlEncoding(controlEncoding);
                     }
 
-                    final Boolean autodetectUTF8 = 
builder.getAutodetectUTF8(fileSystemOptions);
+                    final Boolean autodetectUTF8 = 
builder.getAutodetectUtf8(fileSystemOptions);
                     if (autodetectUTF8 != null) {
                         client.setAutodetectUTF8(autodetectUTF8);
                     }
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/ftp/FtpFileSystemConfigBuilder.java
 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/ftp/FtpFileSystemConfigBuilder.java
index ffe44ed..af0f818 100644
--- 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/ftp/FtpFileSystemConfigBuilder.java
+++ 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/ftp/FtpFileSystemConfigBuilder.java
@@ -94,7 +94,7 @@ public class FtpFileSystemConfigBuilder extends 
FileSystemConfigBuilder {
      * @return True if autodetection should be done.
      * @since 2.4
      */
-    public Boolean getAutodetectUTF8(final FileSystemOptions opts) {
+    public Boolean getAutodetectUtf8(final FileSystemOptions opts) {
         return getBoolean(opts, AUTODETECT_UTF8);
     }
 
@@ -279,7 +279,7 @@ public class FtpFileSystemConfigBuilder extends 
FileSystemConfigBuilder {
      * @param autodetectUTF8 true if autodetection should be done.
      * @since 2.4
      */
-    public void setAutodetectUTF8(final FileSystemOptions opts, final Boolean 
autodetectUTF8) {
+    public void setAutodetectUtf8(final FileSystemOptions opts, final Boolean 
autodetectUTF8) {
         setParam(opts, AUTODETECT_UTF8, autodetectUTF8);
     }
 
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/sftp/IdentityInfo.java
 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/sftp/IdentityInfo.java
index d05fb21..e3319d9 100644
--- 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/sftp/IdentityInfo.java
+++ 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/sftp/IdentityInfo.java
@@ -79,6 +79,9 @@ public class IdentityInfo implements IdentityProvider {
         this.passPhrase = passPhrase;
     }
 
+    /**
+     * @since 2.4
+     */
     @Override
     public void addIdentity(final JSch jsch) throws JSchException {
         jsch.addIdentity(getAbsolutePath(privateKey), 
getAbsolutePath(publicKey), passPhrase);
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/sftp/SftpFileSystemConfigBuilder.java
 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/sftp/SftpFileSystemConfigBuilder.java
index c180c68..83e8823 100644
--- 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/sftp/SftpFileSystemConfigBuilder.java
+++ 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/provider/sftp/SftpFileSystemConfigBuilder.java
@@ -396,9 +396,10 @@ public final class SftpFileSystemConfigBuilder extends 
FileSystemConfigBuilder {
 
     /**
      * @param opts The FileSystem options.
-     * @return the option value for spesific key exchange algorithm
+     * @return the option value for specific key exchange algorithm
      * @see #setKeyExchangeAlgorithm(FileSystemOptions, String)
-     **/
+     * @since 2.4
+     */
     public String getKeyExchangeAlgorithm(final FileSystemOptions opts) {
         return this.getString(opts, KEY_EXCHANGE_ALGORITHM);
     }
@@ -687,12 +688,13 @@ public final class SftpFileSystemConfigBuilder extends 
FileSystemConfigBuilder {
     }
 
     /**
-     ** Configure Key exchange algoritm explicitly e.g
-     * 
diffie-hellman-group14-sha1,diffie-hellman-group-exchange-sha256,diffie-hellman-group-exchange-sha1,diffie-hellman-group1-sha1
+     * Configures Key exchange algorithm explicitly e.g 
diffie-hellman-group14-sha1,
+     * diffie-hellman-group-exchange-sha256, 
diffie-hellman-group-exchange-sha1, diffie-hellman-group1-sha1
      *
      * @param opts                The FileSystem options.
-     * @param keyExchangeAlgoritm The key exchange algoritm picked.
-     **/
+     * @param keyExchangeAlgoritm The key exchange algorithm picked.
+     * @since 2.4
+     */
     public void setKeyExchangeAlgorithm(final FileSystemOptions opts, final 
String keyExchangeAlgoritm) {
         setParam(opts, KEY_EXCHANGE_ALGORITHM, keyExchangeAlgoritm);
     }
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/util/MonitorInputStream.java
 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/util/MonitorInputStream.java
index 7de18d5..df18ce6 100644
--- 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/util/MonitorInputStream.java
+++ 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/util/MonitorInputStream.java
@@ -149,6 +149,7 @@ public class MonitorInputStream extends BufferedInputStream 
{
      * @throws IOException if an error occurs.
      */
     protected void onClose() throws IOException {
+        // noop
     }
 
     /**
diff --git 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/util/MonitorOutputStream.java
 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/util/MonitorOutputStream.java
index 2cfb104..d28e673 100644
--- 
a/commons-vfs2/src/main/java/org/apache/commons/vfs2/util/MonitorOutputStream.java
+++ 
b/commons-vfs2/src/main/java/org/apache/commons/vfs2/util/MonitorOutputStream.java
@@ -55,8 +55,10 @@ public class MonitorOutputStream extends 
BufferedOutputStream {
      * <p>
      * This makes sure the buffers are flushed, close the output stream and it 
will call {@link #onClose()} and re-throw
      * last exception from any of the three.
+     * </p>
      * <p>
      * This does nothing if the stream is closed already.
+     * </p>
      *
      * @throws IOException if an error occurs.
      */
diff --git 
a/commons-vfs2/src/test/java/org/apache/commons/vfs2/filter/BaseFilterTest.java 
b/commons-vfs2/src/test/java/org/apache/commons/vfs2/filter/BaseFilterTest.java
index 7435e9d..12807f9 100644
--- 
a/commons-vfs2/src/test/java/org/apache/commons/vfs2/filter/BaseFilterTest.java
+++ 
b/commons-vfs2/src/test/java/org/apache/commons/vfs2/filter/BaseFilterTest.java
@@ -74,7 +74,7 @@ public abstract class BaseFilterTest {
                         throw new RuntimeException(ex);
                     }
                 }
-                
+
                 @Override
                 public String toString() {
                     return Objects.toString(fileObject);
diff --git 
a/commons-vfs2/src/test/java/org/apache/commons/vfs2/filter/SymbolicLinkFileFilterTest.java
 
b/commons-vfs2/src/test/java/org/apache/commons/vfs2/filter/SymbolicLinkFileFilterTest.java
index 11f59db..bce8c29 100644
--- 
a/commons-vfs2/src/test/java/org/apache/commons/vfs2/filter/SymbolicLinkFileFilterTest.java
+++ 
b/commons-vfs2/src/test/java/org/apache/commons/vfs2/filter/SymbolicLinkFileFilterTest.java
@@ -39,11 +39,11 @@ import org.junit.Test;
  * </p>
  * <p>
  * To enable this test set the system property 
"SymbolicLinkFileFilterTest.Enable" to "true".
- * 
+ *
  * <p>
  * To run only this test with Maven:
  * </p>
- * 
+ *
  * <pre>
  * mvn test -Dtest=SymbolicLinkFileFilterTest -pl commons-vfs2 
-DSymbolicLinkFileFilterTest.Enable=true
  * </pre>
diff --git a/pom.xml b/pom.xml
index 42b9ac3..99d5519 100644
--- a/pom.xml
+++ b/pom.xml
@@ -163,7 +163,7 @@
     <commons.bc.version>2.3</commons.bc.version>
     <commons.releaseManagerName>Gary Gregory</commons.releaseManagerName>    
     <commons.releaseManagerKey>86fdc7e2a11262cb</commons.releaseManagerKey>  
-    <commons.rc.version>RC2</commons.rc.version>
+    <commons.rc.version>RC1</commons.rc.version>
     
<commons.release.name>commons-vfs-${commons.release.version}</commons.release.name>
     <commons.release.desc>(requires Java 8)</commons.release.desc>
     <commons.binary.suffix /> <!-- TODO delete? -->
@@ -192,7 +192,7 @@
     <dependency.locations.enabled>false</dependency.locations.enabled>
     <hadoop.version>2.6.0</hadoop.version>
     <commons.surefire.version>2.19.1</commons.surefire.version>
-    <commons.japicmp.version>0.14.0</commons.japicmp.version>
+    <commons.japicmp.version>0.14.1</commons.japicmp.version>
   </properties>
 
   <build>
@@ -274,7 +274,6 @@
       <plugin>
         <groupId>org.apache.rat</groupId>
         <artifactId>apache-rat-plugin</artifactId>
-        <version>${commons.rat.version}</version>
         <!-- Should agree with config in reporting section -->
         <configuration>
           <excludes combine.children="append">
@@ -289,6 +288,22 @@
           </excludes>
         </configuration>
       </plugin>
+      <plugin>
+        <groupId>com.github.siom79.japicmp</groupId>
+        <artifactId>japicmp-maven-plugin</artifactId>
+        <configuration>
+          <parameter>
+            <overrideCompatibilityChangeParameters>
+              <overrideCompatibilityChangeParameter>
+                <compatibilityChange>METHOD_NEW_DEFAULT</compatibilityChange>
+                <binaryCompatible>true</binaryCompatible>
+                <sourceCompatible>true</sourceCompatible>
+                <semanticVersionLevel>PATCH</semanticVersionLevel>
+              </overrideCompatibilityChangeParameter>
+            </overrideCompatibilityChangeParameters>
+          </parameter>
+        </configuration>
+      </plugin>    
     </plugins>
   </build>
 
@@ -361,6 +376,22 @@
           <aggregate>true</aggregate>
         </configuration>
       </plugin>
+      <plugin>
+        <groupId>com.github.siom79.japicmp</groupId>
+        <artifactId>japicmp-maven-plugin</artifactId>
+        <configuration>
+          <parameter>
+            <overrideCompatibilityChangeParameters>
+              <overrideCompatibilityChangeParameter>
+                <compatibilityChange>METHOD_NEW_DEFAULT</compatibilityChange>
+                <binaryCompatible>true</binaryCompatible>
+                <sourceCompatible>true</sourceCompatible>
+                <semanticVersionLevel>PATCH</semanticVersionLevel>
+              </overrideCompatibilityChangeParameter>
+            </overrideCompatibilityChangeParameters>
+          </parameter>
+        </configuration>
+      </plugin>      
       <!-- cobertura breaks because it cannot parse annotations in methods. -->
       <!--
       <plugin>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 17df781..6b3e994 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -143,6 +143,19 @@ The <action> type attribute can be add,update,fix,remove.
       <action issue="VFS-722" dev="ggregory" type="update" due-to="Gary 
Gregory">
         Update Apache Commons Collections from 4.3 to 4.4.
       </action>
+      <!-- Source code notes -->
+      <action dev="ggregory" type="update">
+        Source incompatibility: 
org.apache.commons.vfs2.FileFilter.accept(FileSelectInfo) now throws checked 
exception FileSystemException.
+      </action>
+      <action dev="ggregory" type="update">
+        Public API note: The overridden methods getURI() and getFriendlyURI() 
in org.apache.commons.vfs2.provider.local.LocalFileName where removed but are 
implemented in a superclass.
+      </action>
+      <action dev="ggregory" type="update">
+        Public API note: The overridden method 
org.apache.commons.vfs2.provider.sftp.SftpFileObject#refresh() was removed but 
is implemented in a superclass.
+      </action>
+      <action dev="ggregory" type="update">
+        Public API note: The overridden method 
org.apache.commons.vfs2.provider.sftp.SftpFileProvider#init() was removed but 
is implemented in a superclass.
+      </action>
     </release>
     <release version="2.3" date="2019-02-01" description="New features and bug 
fix release.">
       <action issue="VFS-645" dev="ggregory" type="fix">
diff --git a/src/site/xdoc/download_vfs.xml b/src/site/xdoc/download_vfs.xml
index fba7512..7b909c4 100644
--- a/src/site/xdoc/download_vfs.xml
+++ b/src/site/xdoc/download_vfs.xml
@@ -36,14 +36,14 @@ limitations under the License.
  |      (defaults to "-bin", set to "" for pre-maven2 releases)         |
  |    - commons.release.desc    (optional)                              |
  |    - commons.release.subdir  (optional)                              |
- |    - commons.release.hash    (optional, lowercase, default sha256)   |
+ |    - commons.release.hash    (optional, lowercase, default sha512)   |
  |                                                                      |
  |    - commons.release.[234].version       (conditional)               |
  |    - commons.release.[234].name          (conditional)               |
  |    - commons.release.[234].binary.suffix (optional)                  |
  |    - commons.release.[234].desc          (optional)                  |
  |    - commons.release.[234].subdir        (optional)                  |
- |    - commons.release.[234].hash       (optional, lowercase, [sha256])|
+ |    - commons.release.[234].hash       (optional, lowercase, [sha512])|
  |                                                                      |
  | 3) Example Properties                                                |
  |    (commons.release.name inherited by parent:                        |
@@ -66,7 +66,7 @@ limitations under the License.
     <subsection name="Using a Mirror">
       <p>
         We recommend you use a mirror to download our release
-        builds, but you <strong>must</strong> <a 
href="http://www.apache.org/info/verification.html";>verify the integrity</a> of
+        builds, but you <strong>must</strong> <a 
href="https://www.apache.org/info/verification.html";>verify the integrity</a> of
         the downloaded files using signatures downloaded from our main
         distribution directories. Recent releases (48 hours) may not yet
         be available from all the mirrors.
@@ -104,7 +104,7 @@ limitations under the License.
         It is essential that you
         <a href="https://www.apache.org/info/verification.html";>verify the 
integrity</a>
         of downloaded files, preferably using the <code>PGP</code> signature 
(<code>*.asc</code> files);
-        failing that using the <code>SHA256</code> hash (<code>*.sha256</code> 
checksum files).
+        failing that using the <code>SHA512</code> hash (<code>*.sha512</code> 
checksum files).
       </p>
       <p>
         The <a href="https://www.apache.org/dist/commons/KEYS";>KEYS</a>
@@ -113,32 +113,32 @@ limitations under the License.
       </p>
     </subsection>
     </section>
-    <section name="Apache Commons VFS Project 2.3 (requires Java 8)">
+    <section name="Apache Commons VFS Project 2.4 (requires Java 8)">
       <subsection name="Binaries">
         <table>
           <tr>
-              <td><a 
href="[preferred]/commons/vfs/binaries/commons-vfs-2.3.tar.gz">commons-vfs-2.3.tar.gz</a></td>
-              <td><a 
href="https://www.apache.org/dist/commons/vfs/binaries/commons-vfs-2.3.tar.gz.sha256";>sha256</a></td>
-              <td><a 
href="https://www.apache.org/dist/commons/vfs/binaries/commons-vfs-2.3.tar.gz.asc";>pgp</a></td>
+              <td><a 
href="[preferred]/commons/vfs/binaries/commons-vfs-2.4.tar.gz">commons-vfs-2.4.tar.gz</a></td>
+              <td><a 
href="https://www.apache.org/dist/commons/vfs/binaries/commons-vfs-2.4.tar.gz.sha512";>sha512</a></td>
+              <td><a 
href="https://www.apache.org/dist/commons/vfs/binaries/commons-vfs-2.4.tar.gz.asc";>pgp</a></td>
           </tr>
           <tr>
-              <td><a 
href="[preferred]/commons/vfs/binaries/commons-vfs-2.3.zip">commons-vfs-2.3.zip</a></td>
-              <td><a 
href="https://www.apache.org/dist/commons/vfs/binaries/commons-vfs-2.3.zip.sha256";>sha256</a></td>
-              <td><a 
href="https://www.apache.org/dist/commons/vfs/binaries/commons-vfs-2.3.zip.asc";>pgp</a></td>
+              <td><a 
href="[preferred]/commons/vfs/binaries/commons-vfs-2.4.zip">commons-vfs-2.4.zip</a></td>
+              <td><a 
href="https://www.apache.org/dist/commons/vfs/binaries/commons-vfs-2.4.zip.sha512";>sha512</a></td>
+              <td><a 
href="https://www.apache.org/dist/commons/vfs/binaries/commons-vfs-2.4.zip.asc";>pgp</a></td>
           </tr>
         </table>
       </subsection>
       <subsection name="Source">
         <table>
           <tr>
-              <td><a 
href="[preferred]/commons/vfs/source/commons-vfs-2.3-src.tar.gz">commons-vfs-2.3-src.tar.gz</a></td>
-              <td><a 
href="https://www.apache.org/dist/commons/vfs/source/commons-vfs-2.3-src.tar.gz.sha256";>sha256</a></td>
-              <td><a 
href="https://www.apache.org/dist/commons/vfs/source/commons-vfs-2.3-src.tar.gz.asc";>pgp</a></td>
+              <td><a 
href="[preferred]/commons/vfs/source/commons-vfs-2.4-src.tar.gz">commons-vfs-2.4-src.tar.gz</a></td>
+              <td><a 
href="https://www.apache.org/dist/commons/vfs/source/commons-vfs-2.4-src.tar.gz.sha512";>sha512</a></td>
+              <td><a 
href="https://www.apache.org/dist/commons/vfs/source/commons-vfs-2.4-src.tar.gz.asc";>pgp</a></td>
           </tr>
           <tr>
-              <td><a 
href="[preferred]/commons/vfs/source/commons-vfs-2.3-src.zip">commons-vfs-2.3-src.zip</a></td>
-              <td><a 
href="https://www.apache.org/dist/commons/vfs/source/commons-vfs-2.3-src.zip.sha256";>sha256</a></td>
-              <td><a 
href="https://www.apache.org/dist/commons/vfs/source/commons-vfs-2.3-src.zip.asc";>pgp</a></td>
+              <td><a 
href="[preferred]/commons/vfs/source/commons-vfs-2.4-src.zip">commons-vfs-2.4-src.zip</a></td>
+              <td><a 
href="https://www.apache.org/dist/commons/vfs/source/commons-vfs-2.4-src.zip.sha512";>sha512</a></td>
+              <td><a 
href="https://www.apache.org/dist/commons/vfs/source/commons-vfs-2.4-src.zip.asc";>pgp</a></td>
           </tr>
         </table>
       </subsection>
diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml
index 92ca9a2..b7404f1 100644
--- a/src/site/xdoc/index.xml
+++ b/src/site/xdoc/index.xml
@@ -71,7 +71,7 @@
             dependencies.
           </p>
           <p>
-           Apache Commons VFS 2.3 requires Java 8.
+           Apache Commons VFS 2.3 and 2.4 requires Java 8.
           </p>
           <p>
            Apache Commons VFS 2.2 requires Java 7.
@@ -86,6 +86,9 @@
 
         <section name="News">
           <p>
+            Apache Commons VFS 2.4 is a new features and bug fix release.
+          </p>
+          <p>
             Apache Commons VFS 2.3 is a new features and bug fix release.
           </p>
           <p>
diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml
index b9ca339..5cfcdba 100644
--- a/src/site/xdoc/issue-tracking.xml
+++ b/src/site/xdoc/issue-tracking.xml
@@ -86,7 +86,7 @@ limitations under the License.
 
       <p>
       For more information on subversion and creating patches see the
-      <a href="http://www.apache.org/dev/contributors.html";>Apache 
Contributors Guide</a>.
+      <a href="https://www.apache.org/dev/contributors.html";>Apache 
Contributors Guide</a>.
       </p>
 
       <p>
diff --git a/src/site/xdoc/mail-lists.xml b/src/site/xdoc/mail-lists.xml
index c788d50..e8ec3e1 100644
--- a/src/site/xdoc/mail-lists.xml
+++ b/src/site/xdoc/mail-lists.xml
@@ -49,7 +49,7 @@ limitations under the License.
     <section name="Overview">
       <p>
         <a href="index.html">Apache Commons VFS Project</a> shares mailing 
lists with all the other
-        <a href="http://commons.apache.org/components.html";>Commons 
Components</a>.
+        <a href="https://commons.apache.org/components.html";>Commons 
Components</a>.
         To make it easier for people to only read messages related to 
components they are interested in,
         the convention in Commons is to prefix the subject line of messages 
with the component's name,
         for example:
@@ -106,9 +106,9 @@ limitations under the License.
           <td><a 
href="mailto:user-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
           <td><a 
href="mailto:u...@commons.apache.org?subject=[vfs]";>Post</a></td>
           <td><a 
href="https://mail-archives.apache.org/mod_mbox/commons-user/";>mail-archives.apache.org</a></td>
-          <td><a 
href="http://markmail.org/list/org.apache.commons.users/";>markmail.org</a><br />
-              <a 
href="http://www.mail-archive.com/user@commons.apache.org/";>www.mail-archive.com</a><br
 />
-              <a 
href="http://news.gmane.org/gmane.comp.jakarta.commons.devel";>news.gmane.org</a>
+          <td><a 
href="https://markmail.org/list/org.apache.commons.users/";>markmail.org</a><br 
/>
+              <a 
href="https://www.mail-archive.com/user@commons.apache.org/";>www.mail-archive.com</a><br
 />
+              <a 
href="https://news.gmane.org/gmane.comp.jakarta.commons.devel";>news.gmane.org</a>
           </td>
         </tr>
 
@@ -124,9 +124,9 @@ limitations under the License.
           <td><a 
href="mailto:dev-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
           <td><a 
href="mailto:d...@commons.apache.org?subject=[vfs]";>Post</a></td>
           <td><a 
href="https://mail-archives.apache.org/mod_mbox/commons-dev/";>mail-archives.apache.org</a></td>
-          <td><a 
href="http://markmail.org/list/org.apache.commons.dev/";>markmail.org</a><br />
-              <a 
href="http://www.mail-archive.com/dev@commons.apache.org/";>www.mail-archive.com</a><br
 />
-              <a 
href="http://news.gmane.org/gmane.comp.jakarta.commons.devel";>news.gmane.org</a>
+          <td><a 
href="https://markmail.org/list/org.apache.commons.dev/";>markmail.org</a><br />
+              <a 
href="https://www.mail-archive.com/dev@commons.apache.org/";>www.mail-archive.com</a><br
 />
+              <a 
href="https://news.gmane.org/gmane.comp.jakarta.commons.devel";>news.gmane.org</a>
           </td>
         </tr>
 
@@ -142,8 +142,8 @@ limitations under the License.
           <td><a 
href="mailto:issues-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
           <td><i>read only</i></td>
           <td><a 
href="https://mail-archives.apache.org/mod_mbox/commons-issues/";>mail-archives.apache.org</a></td>
-          <td><a 
href="http://markmail.org/list/org.apache.commons.issues/";>markmail.org</a><br 
/>
-              <a 
href="http://www.mail-archive.com/issues@commons.apache.org/";>www.mail-archive.com</a>
+          <td><a 
href="https://markmail.org/list/org.apache.commons.issues/";>markmail.org</a><br 
/>
+              <a 
href="https://www.mail-archive.com/issues@commons.apache.org/";>www.mail-archive.com</a>
           </td>
         </tr>
 
@@ -159,8 +159,8 @@ limitations under the License.
           <td><a 
href="mailto:commits-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
           <td><i>read only</i></td>
           <td><a 
href="https://mail-archives.apache.org/mod_mbox/commons-commits/";>mail-archives.apache.org</a></td>
-          <td><a 
href="http://markmail.org/list/org.apache.commons.commits/";>markmail.org</a><br 
/>
-              <a 
href="http://www.mail-archive.com/commits@commons.apache.org/";>www.mail-archive.com</a>
+          <td><a 
href="https://markmail.org/list/org.apache.commons.commits/";>markmail.org</a><br
 />
+              <a 
href="https://www.mail-archive.com/commits@commons.apache.org/";>www.mail-archive.com</a>
           </td>
         </tr>
 
@@ -192,10 +192,10 @@ limitations under the License.
           <td><a class="externalLink" 
href="mailto:announce-unsubscr...@apache.org";>Unsubscribe</a></td>
           <td><i>read only</i></td>
           <td><a class="externalLink" 
href="https://mail-archives.apache.org/mod_mbox/www-announce/";>mail-archives.apache.org</a></td>
-          <td><a class="externalLink" 
href="http://markmail.org/list/org.apache.announce/";>markmail.org</a><br />
-              <a class="externalLink" 
href="http://old.nabble.com/Apache-News-and-Announce-f109.html";>old.nabble.com</a><br
 />
-              <a class="externalLink" 
href="http://www.mail-archive.com/announce@apache.org/";>www.mail-archive.com</a><br
 />
-              <a class="externalLink" 
href="http://news.gmane.org/gmane.comp.apache.announce";>news.gmane.org</a>
+          <td><a class="externalLink" 
href="https://markmail.org/list/org.apache.announce/";>markmail.org</a><br />
+              <a class="externalLink" 
href="https://old.nabble.com/Apache-News-and-Announce-f109.html";>old.nabble.com</a><br
 />
+              <a class="externalLink" 
href="https://www.mail-archive.com/announce@apache.org/";>www.mail-archive.com</a><br
 />
+              <a class="externalLink" 
href="https://news.gmane.org/gmane.comp.apache.announce";>news.gmane.org</a>
           </td>
         </tr>
       </table>

Reply via email to