We have fixed quite a few bugs and added some significant enhancements
since Apache Commons VFS Project 2.3 was released, so I would like to
release Apache Commons VFS Project 2.4.
Apache Commons VFS Project 2.4 RC1 is available for review here:
https://dist.apache.org/repos/dist/dev/commons/vfs/2.4-RC1 (svn
revision 34865)
The Git tag commons-vfs-2.4-RC1 commit for this RC is
796408d2f8423e22edc750b3f95ec6611b980704 which you can browse here:
https://gitbox.apache.org/repos/asf?p=commons-vfs.git;a=commit;h=796408d2f8423e22edc750b3f95ec6611b980704
You may checkout this tag using:
git clone https://gitbox.apache.org/repos/asf/commons-vfs.git --branch
commons-vfs-2.4-RC1 commons-vfs-2.4-RC1
Maven artifacts are here:
https://repository.apache.org/content/repositories/orgapachecommons-1447/org/apache/commons/commons-vfs2-project/2.4/
These are the artifacts and their SHA-512 hashes on
https://dist.apache.org/repos/dist/dev/commons/vfs/2.4-RC1:
commons-vfs-2.4-bin.tar.gz
b4bc9277c00ebaf0c8fe6534165b232db0766b9276709994d6b16e826c2531440c50261035fc40dbf48d0da0a90147ca094a3895b62577b7ee1018cab05419f6
commons-vfs-2.4-bin.zip
45c25d7d0b9ab30353d377e0fa80b55fc5eb5c228d43505635e17d3d43d3de0fd1521a5af2f9ebe669571fbbe5ff1aa863c4cad528a4b56e6cfa81c2e6112a65
commons-vfs-2.4-src.tar.gz
ba8011b1779fae7202d22dee24c6ab94b751739e932499a0230c7764b57d8042734aaaa1b17841ac7dff298fb1ee321aa974223362313413e8d5d76d98e4b214
commons-vfs-2.4-src.zip
938d16546db0130316cb7b28872253c90dedc5c4b400ee5b50021dd4889bfcae9c09d52d355c2868bbd70c8486496737f14777758841c5f24485f11f41485669
The following artifacts have been staged in Nexus:
/org/apache/commons/commons-vfs2-distribution/2.4/commons-vfs2-distribution-2.4-javadoc.jar.asc
(SHA1: 3be32ff790c0785b20f2b6ff2c1d2eb1b046a3ef)
/org/apache/commons/commons-vfs2-distribution/2.4/commons-vfs2-distribution-2.4-javadoc.jar
(SHA1: 592efe7f1e778fc5d3a2332b052d2be7822d405f)
/org/apache/commons/commons-vfs2-distribution/2.4/commons-vfs2-distribution-2.4.pom
(SHA1: f05651107067d2995e339c9ad49de3af9ad3af5b)
/org/apache/commons/commons-vfs2-distribution/2.4/commons-vfs2-distribution-2.4.pom.asc
(SHA1: c15fb439ae5155979521acac99b08a3b98b66e1a)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4-test-sources.jar
(SHA1: 2cae50abccee652cb3637136ff0d28e7fece0795)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4-test-sources.jar.asc
(SHA1: 7de44b57140d9a52a66f1645ea427fbdbfefdd11)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4.jar
(SHA1: 085e8f1fc37279c89c1504393a4a748159d91046)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4-javadoc.jar.asc
(SHA1: 00521b3fa0617777ac8ba6cc739f4fc895f82aec)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4.pom
(SHA1: bafc6da7a594ab33222c70cc67788a2fa1b63ffa)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4-javadoc.jar
(SHA1: 06b4e4f58e9c5a7e609c74ba1e8a6e311f56f8c4)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4-sources.jar.asc
(SHA1: dab139a477b22ebddcdf16bd79c2d3fa18f79832)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4.pom.asc
(SHA1: 891a6e8eec524b0ef2a41e83bd2955a16aecc914)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4-sources.jar
(SHA1: afa50c0895aa002adb7c0c5614d9885abd70fb2a)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4-tests.jar
(SHA1: 3b4f76fb2c9c0b1e5c8c00715e271e6c7514e825)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4.jar.asc
(SHA1: 94cc44bc43ba99f3b771ca6f5e9249a5923f344e)
/org/apache/commons/commons-vfs2/2.4/commons-vfs2-2.4-tests.jar.asc
(SHA1: 0466ac93c8eec703e2ae1b7fb6db76159872e19f)
/org/apache/commons/commons-vfs2-project/2.4/commons-vfs2-project-2.4.pom.asc
(SHA1: 18b9b81a9a1e55495d746c11f90b6c11b35e9bfa)
/org/apache/commons/commons-vfs2-project/2.4/commons-vfs2-project-2.4.pom
(SHA1: 17c963b66f27497a36618c851ccbee8b3006f9ea)
/org/apache/commons/commons-vfs2-project/2.4/commons-vfs2-project-2.4-site.xml.asc
(SHA1: 713c993dc4342b36c1c3c5243369b485e069693f)
/org/apache/commons/commons-vfs2-project/2.4/commons-vfs2-project-2.4-site.xml
(SHA1: baca67a9f6be69b52869c2ec49b7487bdbd6bc9f)
/org/apache/commons/commons-vfs2-project/2.4/commons-vfs2-project-2.4-javadoc.jar
(SHA1: 22a19ca2c9d4ad2f3fb5179c5f058a4216e71d2e)
/org/apache/commons/commons-vfs2-project/2.4/commons-vfs2-project-2.4-javadoc.jar.asc
(SHA1: 032892276f7814b6a51a0e231450450a3d710cab)
/org/apache/commons/commons-vfs2-examples/2.4/commons-vfs2-examples-2.4.jar
(SHA1: 01a8b92efa47e9ff54800bb4626d1907f6134bc1)
/org/apache/commons/commons-vfs2-examples/2.4/commons-vfs2-examples-2.4-sources.jar
(SHA1: b070600f9ed7d51b9bb24dd9a3b68a121e9ab188)
/org/apache/commons/commons-vfs2-examples/2.4/commons-vfs2-examples-2.4-javadoc.jar.asc
(SHA1: e8e3cc9dab30b608debd52f2552a7d413f4cc3c5)
/org/apache/commons/commons-vfs2-examples/2.4/commons-vfs2-examples-2.4.pom.asc
(SHA1: aa71fa4359c4996b8ff904ff07440b612aa1db4d)
/org/apache/commons/commons-vfs2-examples/2.4/commons-vfs2-examples-2.4.pom
(SHA1: 3ee6f6a4feb6ed6daa0fc79c8c004d0ff66274a9)
/org/apache/commons/commons-vfs2-examples/2.4/commons-vfs2-examples-2.4-javadoc.jar
(SHA1: 2156df5bf402d3e3cac9d243ecac31ff1c798cc8)
/org/apache/commons/commons-vfs2-examples/2.4/commons-vfs2-examples-2.4.jar.asc
(SHA1: 36ed9fc1fb3e6038ebf243394f2dec8230048db1)
/org/apache/commons/commons-vfs2-examples/2.4/commons-vfs2-examples-2.4-sources.jar.asc
(SHA1: a3c1811cc3f85ac62705b7808104ed36490b79b5)
I tested this with 'mvn -V clean install site' using the following JDKs:
Apache Maven 3.6.1 (d66c9c0b3152b2e69ee9bac180bb8fcc8e6af555;
2019-04-04T15:00:29-04:00)
Maven home: C:\Java\apache-maven-3.6.1\bin\..
Java version: 1.8.0_212, vendor: Oracle Corporation, runtime: C:\Program
Files\Java\jdk1.8.0_212\jre
Default locale: en_US, platform encoding: Cp1252
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
Apache Maven 3.6.1 (d66c9c0b3152b2e69ee9bac180bb8fcc8e6af555;
2019-04-04T15:00:29-04:00)
Maven home: C:\Java\apache-maven-3.6.1\bin\..
Java version: 11.0.3, vendor: Oracle Corporation, runtime: C:\Program
Files\Java\jdk-11.0.3
Default locale: en_US, platform encoding: Cp1252
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
Apache Maven 3.6.1 (d66c9c0b3152b2e69ee9bac180bb8fcc8e6af555;
2019-04-04T15:00:29-04:00)
Maven home: C:\Java\apache-maven-3.6.1\bin\..
Java version: 12.0.1, vendor: Oracle Corporation, runtime: C:\Program
Files\Java\openjdk\jdk-12.0.1
Default locale: en_US, platform encoding: Cp1252
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
Apache Maven 3.6.1 (d66c9c0b3152b2e69ee9bac180bb8fcc8e6af555;
2019-04-04T15:00:29-04:00)
Maven home: C:\Java\apache-maven-3.6.1\bin\..
Java version: 13-ea, vendor: Oracle Corporation, runtime: C:\Program
Files\Java\openjdk\jdk-13
Default locale: en_US, platform encoding: Cp1252
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
Details of changes since 2.3 are in the release notes:
https://dist.apache.org/repos/dist/dev/commons/vfs/2.4-RC1/RELEASE-NOTES.txt
https://dist.apache.org/repos/dist/dev/commons/vfs/2.4-RC1/site/changes-report.html
Site:
https://dist.apache.org/repos/dist/dev/commons/vfs/2.4-RC1/site/index.html
(note some *relative* links are broken and the 2.4 directories are not
yet created - these will be OK once the site is deployed.)
There is no CLIRR Report, see JApiCmp below.
JApiCmp Report (compared to 2.3):
https://dist.apache.org/repos/dist/dev/commons/vfs/2.4-RC1/site/commons-vfs2/japicmp.html
Note that Clirr reports several issues.
These are considered OK for the reasons stated below.
These exceptions are also noted in the Release Notes.
- Source incompatibility:
org.apache.commons.vfs2.FileFilter.accept(FileSelectInfo) now throws
checked exception FileSystemException.
- 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.
- Public API note: The overridden method
org.apache.commons.vfs2.provider.sftp.SftpFileObject#refresh() was removed
but is implemented in a superclass.
- Public API note: The overridden method
org.apache.commons.vfs2.provider.sftp.SftpFileProvider#init() was removed
but is implemented in a superclass.
RAT Report:
https://dist.apache.org/repos/dist/dev/commons/vfs/2.4-RC1/site/rat-report.html
KEYS:
https://www.apache.org/dist/commons/KEYS
Please review the release candidate and vote.
This vote will close no sooner that 72 hours from now.
[ ] +1 Release these artifacts
[ ] +0 OK, but...
[ ] -0 OK, but really should fix...
[ ] -1 I oppose this release because...
Thank you,
Gary Gregory,
Release Manager (using key 86fdc7e2a11262cb)
For following is intended as a helper and refresher for reviewers.
Validating a release candidate
==============================
These guidelines are NOT complete.
Requirements: Git, Java, Maven.
You can validate a release from a release candidate (RC) tag as follows.
1) Clone and checkout the RC tag
git clone https://gitbox.apache.org/repos/asf/commons-vfs.git --branch
commons-vfs-2.4-RC1 commons-vfs-2.4-RC1
cd commons-vfs-2.4-RC1
2) Check Apache licenses
This step is not required if the site includes a RAT report page which you
then must check.
mvn apache-rat:check
3) Check binary compatibility
Older components still use Apache Clirr:
Use JApiCmp with the japicmp Maven Profile:
This step is not required if the site includes a JApiCmp report page which
you then must check.
mvn install -DskipTests -P japicmp japicmp:cmp
4) Build the package
mvn -V clean package
You can record the Maven and Java version produced by -V in your VOTE reply.
To gather OS information from a command line:
Windows: ver
Linux: uname -a
5) Build the site for a single module project
Note: Some plugins require the components to be installed instead of
packaged.
mvn site
Check the site reports in:
- Windows: target\site\index.html
- Linux: target/site/index.html
6) Build the site for a multi-module project
mvn site
mvn site:stage
Check the site reports in:
- Windows: target\site\index.html
- Linux: target/site/index.html
-the end-
