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 22d5201f Prepare for the next release candidate
22d5201f is described below
commit 22d5201fb903cd166364ffb574901670d524e1fe
Author: Gary Gregory <[email protected]>
AuthorDate: Sat Aug 10 14:00:36 2024 +0000
Prepare for the next release candidate
---
CONTRIBUTING.md | 21 +-
NOTICE.txt | 10 +-
README.md | 8 +-
RELEASE-NOTES.txt | 413 ++++++++++++++-------------------------
src/changes/changes.xml | 2 +-
src/site/xdoc/download_vfs.xml | 312 ++++++++++++++---------------
src/site/xdoc/issue-tracking.xml | 204 +++++++++----------
7 files changed, 415 insertions(+), 555 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e1d65e32..9a317148 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -41,9 +41,8 @@
Contributing to Apache Commons VFS Project
======================
-You have found a bug or you have an idea for a cool new feature? Contributing
code is a great way to give something back to
-the open source community. Before you dig right into the code there are a few
guidelines that we need contributors to
-follow so that we can have a chance of keeping on top of things.
+Have you found a bug or have an idea for a cool new feature? Contributing code
is a great way to give something back to the open-source community.
+Before you dig right into the code, we need contributors to follow a few
guidelines to have a chance of keeping on top of things.
Getting Started
---------------
@@ -62,7 +61,7 @@ Making Changes
+ Create a _topic branch_ for your isolated work.
* Usually you should base your branch on the `master` branch.
- * A good topic branch name can be the JIRA bug id plus a keyword, e.g.
`VFS-123-InputStream`.
+ * A good topic branch name can be the JIRA bug ID plus a keyword, e.g.
`VFS-123-InputStream`.
* If you have submitted multiple JIRA issues, try to maintain separate
branches and pull requests.
+ Make commits of logical units.
* Make sure your commit messages are meaningful and in the proper format.
Your commit message should contain the key of the JIRA issue.
@@ -72,7 +71,7 @@ Making Changes
+ Create minimal diffs - disable _On Save_ actions like _Reformat Source
Code_ or _Organize Imports_. If you feel the source code should be reformatted
create a separate PR for this change first.
+ Check for unnecessary whitespace with `git diff` -- check before
committing.
+ Make sure you have added the necessary tests for your changes, typically in
`src/test/java`.
-+ Run all the tests with `mvn clean verify` to assure nothing else was
accidentally broken.
++ Run all the tests with `mvn clean verify` to ensure nothing else was
accidentally broken.
Making Trivial Changes
----------------------
@@ -82,18 +81,6 @@ The JIRA tickets are used to generate the changelog for the
next release.
For changes of a trivial nature to comments and documentation, it is not
always necessary to create a new ticket in JIRA.
In this case, it is appropriate to start the first line of a commit with
'(doc)' instead of a ticket number.
-Testing
--------
-
-Please add unit tests for any fixes or new features.
-
-When running individual tests, tests that extend `AbstractProviderTestCase`
-(such as `NamingTests`) cannot be run in isolation: instead, you can run them
-'in the context of' a provider, for example from `LocalProviderTestCase`.
-These configure a `ProviderTestSuite` with the tests to run.
-
-This could likely be simplified, we are tracking that possible
-improvement in https://issues.apache.org/jira/browse/VFS-855 .
Submitting Changes
------------------
diff --git a/NOTICE.txt b/NOTICE.txt
index bba8672b..2d7b3e33 100644
--- a/NOTICE.txt
+++ b/NOTICE.txt
@@ -1,5 +1,5 @@
-Apache Commons VFS Project
-Copyright 2002-2024 The Apache Software Foundation
-
-This product includes software developed at
-The Apache Software Foundation (https://www.apache.org/).
+Apache Commons VFS Project
+Copyright 2002-2024 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (https://www.apache.org/).
diff --git a/README.md b/README.md
index 5fc09d8b..953c9f07 100644
--- a/README.md
+++ b/README.md
@@ -62,7 +62,7 @@ Getting the latest release
--------------------------
You can download source and binaries from our [download
page](https://commons.apache.org/proper/commons-vfs/download_vfs.cgi).
-Alternatively, you can pull it from the central Maven repositories:
+Alternatively, you can pull it from the central Maven repositories:
```xml
<dependency>
@@ -75,7 +75,7 @@ Alternatively, you can pull it from the central Maven
repositories:
Building
--------
-Building requires a Java JDK and [Apache Maven](https://maven.apache.org/).
+Building requires a Java JDK and [Apache Maven](https://maven.apache.org/).
The required Java version is found in the `pom.xml` as the
`maven.compiler.source` property.
From a command shell, run `mvn` without arguments to invoke the default Maven
goal to run all tests and checks.
@@ -88,7 +88,9 @@ There are some guidelines which will make applying PRs easier
for us:
+ No tabs! Please use spaces for indentation.
+ Respect the existing code style for each file.
+ Create minimal diffs - disable on save actions like reformat source code or
organize imports. If you feel the source code should be reformatted create a
separate PR for this change.
-+ Provide JUnit tests for your changes and make sure your changes don't break
any existing tests by running ```mvn```.
++ Provide JUnit tests for your changes and make sure your changes don't break
any existing tests by running `mvn`.
++ Before you pushing a PR, run `mvn` (by itself), this runs the default goal,
which contains all build checks.
++ To see the code coverage report, regardless of coverage failures, run `mvn
clean site -Dcommons.jacoco.haltOnFailure=false`
If you plan to contribute on a regular basis, please consider filing a
[contributor license agreement](https://www.apache.org/licenses/#clas).
You can learn more about contributing via GitHub in our [contribution
guidelines](CONTRIBUTING.md).
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 1e6c64f3..a9169e7c 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,274 +1,145 @@
-Apache Commons VFS Project 2.10.0
-RELEASE NOTES
-
-The Apache Commons VFS Project team is pleased to announce the release of
Apache Commons VFS Project 2.10.0.
-
-Apache Commons VFS is a Virtual File System library.
-
-Maintenance release. Requires Java 8 or above.
-
-Changes in this version
------------------------
-
-New features
-------------
-
-* VFS-848: Config option for trailing slash in webdav URI #425. Thanks to
beise, Gary Gregory.
-* Split out Apache Ant Tasks into its own Maven module
commons-vfs2-ant. Thanks to Gary Gregory.
-* VFS-851: Split out HDFS provider into its own Maven module
commons-vfs2-hdfs. Thanks to Gary Gregory.
-* Generate JPMS module info files when building on Java 11 or
greater, except for commons-vfs2-hdfs due to Hadoop libraries' overlapping
packages. Thanks to Gary Gregory.
-* Add vscode files to gitignore #205. Thanks to Seth Falco.
-* Add DefaultFileMonitor.setDelay(Duration), getDelayDuration() and
deprecate setDelay(long), getDelay(). Thanks to Gary Gregory.
-* DefaultFileMonitor implements AutoCloseable. Thanks to Gary
Gregory.
-* Add FalseFileFilter.INSTANCE and deprecate FalseFileFilter.FALSE.
Thanks to Gary Gregory.
-* Add TrueFileFilter.INSTANCE and deprecate TrueFileFilter.TRUE.
Thanks to Gary Gregory.
-* FileSystemOptions implements Comparable. Thanks to Gary Gregory.
-* Add RandomAccessMode.from(AccessMode) and toAccessModes(). Thanks
to Gary Gregory.
-* Extract the layer separator character constant into
LayeredFileName.LAYER_SEPARATOR. Thanks to Gary Gregory.
-* Add github/codeql-action.
-* VFS-821: Deprecate FileSelector#traverseDescendents in favor of
traverseDescendants. Thanks to Marc Wrobel, Gary Gregory.
-* VFS-821: Add active port range configuration for FTP client factory #318.
Thanks to Maksym Perevertov, Gary Gregory.
-* VFS-833: Make constructor FileSystemOptions(Map) public. Thanks to Kannan
Ramamoorthy, Bernd Eckenfels, Gary Gregory.
-* Add a BOM POM commons-vfs2-bom. Thanks to Gary Gregory.
-
-New features
-------------
-* Replace package.html with package-info.java #206. Thanks to Seth
Falco.
-* VFS-807: LocalFile.doGetOutputStream(boolean) for an existing file no
longer truncates the file. Thanks to Gary Gregory, L.
-* Update the Javadoc link to not lead to 404. #218. Thanks to
wodencafe.
-* VFS-810: Percent encoded backslashes in authority of URLs aren't allowed
for WebDav. Thanks to Jan Aelbrecht, Gary Gregory.
-* VFS-793: GenericFileName.getURI() returns invalid URI. Thanks to Vitali
Nashkevich, Gary Gregory.
-* Fix typos in error messages. Thanks to Gary Gregory.
-* LocalFile: Fix exception message "Unknown message with code" and
use an actual message code. Thanks to Gary Gregory.
-* VFS-778: SFTP channel isn't returned to the pool when
SftpFileObject.doGetOutputStream throws an exception. #215. Thanks to
zhouwenqing, Gary Gregory.
-* Fix OSGi "Unused Import-Package instructions". Thanks to Gary
Gregory.
-* VFS-813: NullPointerException needs a better message in SftpClientFactory
when connect with private key. Thanks to Andrey Turbanov, Gary Gregory.
-* VFS-811: Javadoc API links are broken in the commons-vfs project site #227.
Thanks to Woonsan Ko, Gary Gregory.
-* VFS-812: Don't throw FileSystemException when closing file content output
stream using a BufferedOutputStream #228. Thanks to XenoAmess, Gary Gregory.
-* VFS-814: FtpFileObject: re-fetch MDTM after refresh #238. Thanks to Luke
Wood, Gary Gregory.
-* Simplify conditions and avoid extra checks #253. Thanks to Arturo
Bernal.
-* Refactor AbstractFileObject#getOutputStream() #151. Thanks to
Boris Petrov, Gary Gregory.
-* VFS-770: FileSystemManager.createFileSystem(FileObject) fails on Gzip
files. #92. Thanks to Thomas BELOT, PeterAlfredLee, Gary Gregory.
-* Simplify/remove redundant operations. #258. Thanks to Arturo
Bernal.
-* SFTP: Memory leak because AbstractFileProvider#findFileSystem.
Thanks to Tobias Gierke, Gary Gregory.
-* Fix typos #275, #276, #277. Thanks to Marc Wrobel.
-* Fix links in Javadoc and documentations #284. Thanks to Marc
Wrobel.
-* [SFTP] Handle the case where a user does not have any groups #280.
Thanks to Mark van der Walle, Gary Gregory.
-* The dependency hadoop-hdfs-client is not set as optional #291.
Thanks to ymenager.
-* AbstractFileObject uses the wrong exception for "cause" #316.
Thanks to Boris Petrov.
-* JUnit5 assertThrows SftpFileSystemGroupsTests #323. Thanks to John
Patrick.
-* VFS-825: Fix for GZip input and output stream results in StackOverflowError
#322. Thanks to Anthony Goubard.
-* MonitorInputStream.read(byte[], int, int) and read() should be
synchronized like the superclass BufferedInputStream. Thanks to Gary Gregory.
-* VFS-683: Class loader thread safety #367. Thanks to Daryl Odnert, Otto
Fowler, Bernd Eckenfels, Dave MacDonald, Ivan Bella, Gary Gregory.
-* VFS-832: Sftp channel not put back in doGetInputStream #370. Thanks to
Wangerry, Gary Gregory.
-* [StepSecurity] ci: Harden GitHub Actions #401. Thanks to
step-security-bot, Gary Gregory.
-* VFS-846: Resolve a FileName to correct FileType #424. Thanks to beise, Gary
Gregory.
-* VFS-844: Prevent that source files urlString is twice URIEncoded #423.
Thanks to beise, Gary Gregory.
-* VFS-843: Close the HttpConnection after consuming the entire HttpEntity
#421. Thanks to beise, Gary Gregory.
-* VFS-841: Copy the Main class for testing with Jackrabbit Standalone
Components instead of reusing #409. Thanks to Woonsan Ko, Gary Gregory.
-* VFS-849: HttpConnection resources not properly cleaned up in webdav request
#428. Thanks to beise, Gary Gregory.
-* Don't use deprecated methods in
org.apache.commons.vfs2.provider.ftp.FtpClientFactory. Thanks to Gary Gregory.
-* Reduce deprecated calls in org.apache.commons.vfs2.provider.http5.
Thanks to Gary Gregory.
-*
DelegatingFileSystemOptionsBuilder.setConfigClass[es](FileSystemOptions,
String, String, Class) now throw the more general ReflectiveOperationException
instead of 2 subclasses. Thanks to Gary Gregory.
-* VFS-524: A URI with an IPv6 address can't be parsed out correctly #438.
Thanks to Alex, Fedor Yudanov, Gary Gregory.
-* Port assertions to JUnit 5 APIs. Thanks to Gary Gregory.
-* Scheme "http" now uses Apache HttpClient 5 instead of HttpClient
3. Thanks to Gary Gregory.
-* Scheme "https" now uses Apache HttpClient 5 instead of HttpClient
3. Thanks to Gary Gregory.
-* Deprecate package org.apache.commons.vfs2.provider.http in favor
of org.apache.commons.vfs2.provider.http5. Thanks to Gary Gregory.
-* Deprecate package org.apache.commons.vfs2.provider.https in favor
of org.apache.commons.vfs2.provider.http5s. Thanks to Gary Gregory.
-* Deprecate package org.apache.commons.vfs2.provider.http4 in favor
of org.apache.commons.vfs2.provider.http5. Thanks to Gary Gregory.
-* Deprecate package org.apache.commons.vfs2.provider.http4s in favor
of org.apache.commons.vfs2.provider.http5s. Thanks to Gary Gregory.
-* Support URLencoding during normalization #396. Thanks to Arnout
Engelen, Gary Gregory.
-
-Changes
--------
-
-* Bump actions/cache and others. Thanks to Dependabot, Gary Gregory.
-* Bump actions/checkout #217, #220, #245, #315, and others. Thanks
to Dependabot, Gary Gregory.
-* Bump actions/setup-java #324, and others. Thanks to Gary Gregory,
Dependabot.
-* Bump actions/upload-artifact from #327, and others. Thanks to
Dependabot.
-* Bump jakarta.mail from 1.6.7 to 2.0.1 #200. Thanks to Dependabot.
-* Bump commons.animal-sniffer.version from 1.19 to 1.21. Thanks to
Gary Gregory.
-* Bump com.puppycrawl.tools:checkstyle from 8.44 to 9.3 #211. Thanks
to Gary Gregory.
-* Bump com.github.spotbugs:spotbugs from 4.3.0 to 4.7.3 #216, #269,
#319. Thanks to Dependabot, Gary Gregory.
-* Bump spotbugs-maven-plugin from 4.3.0 to 4.7.3.0, #229, #236.
#264, #282, #331, #333. Thanks to Gary Gregory, Dependabot.
-* Bump jackrabbit2.version to 2.20.14. Never use 2.21.x, it is
"unstable". Thanks to Dependabot, Gary Gregory.
-* Bump org.apache.httpcomponents.client5:httpclient5 from 5.1 to
5.3.1. Thanks to Gary Gregory, Dependabot.
-* Bump org.apache.httpcomponents.core5:httpcore5 from 5.1.5 to 5.2.4
#369, #399, #429, #447. Thanks to Dependabot.
-* Bump org.apache.mina:mina-core from 2.1.4 to 2.1.8. Thanks to Gary
Gregory, Dependabot.
-* Bump maven-pmd-plugin from 3.14.0 to 3.19.0 #223, #294, #304.
Thanks to Dependabot, Gary Gregory.
-* Bump net.sourceforge.pmd:pmd-* from 6.36.0 to 6.53.0 #208, #247,
#256, #261, #266, #270, #283, #339, #361. Thanks to Dependabot, Gary Gregory.
-* Bump org.mockito:mockito-core from 3.11.2 to 4.11.0 #263, #292,
#308, #337, #355, #359. Thanks to Gary Gregory, Dependabot.
-* Bump maven-javadoc-plugin from 3.3.0 to 3.4.1, #293. Thanks to
Gary Gregory, Dependabot.
-* Bump biz.aQute.bnd:biz.aQute.bndlib from 5.3.0 to 6.3.1. Thanks to
Gary Gregory.
-* Bump commons.japicmp.version from 0.15.3 to 0.16.0. Thanks to Gary
Gregory.
-* Replace JUnit 4.13.2 with 5.9.1 #281, #306. Thanks to Gary
Gregory, John Patrick, Dependabot.
-* Bump org.apache.httpcomponents:httpcore-nio from 4.4.14 to 4.4.16,
#341. Thanks to Gary Gregory, Dependabot.
-* Bump Apache Log4j 2.14.1 to 2.23.0 [Tests] #226, #230, #305, #378,
#448, #461, #487. Thanks to Gary Gregory, Dependabot.
-* Bump ftpserver-core from 1.1.1 to 1.1.2 #235. Thanks to XenoAmess.
-* Bump hadoop.version from 3.3.1 to 3.3.6 #246, #262, #290, #386,
#402. Thanks to Dependabot.
-* Bump slf4j.version from 1.7.26 to 2.0.12 #484, #486. Thanks to
Dependabot.
-* Bump slf4j.version from 1.7.26 to 2.0.11. Thanks to Dependabot.
-* Bump commons-parent from 52 to 66. Thanks to Dependabot, Gary
Gregory.
-* Bump org.ow2.asm:asm from 9.2 to 9.4. Thanks to Gary Gregory.
-* Bump commons.jacoco.version from 0.8.7 to 0.8.8. Thanks to Gary
Gregory.
-* Bump commons.surefire.version from 3.0.0-M5 to 3.0.0-M7. Thanks to
Gary Gregory.
-* Bump Apache Commons BCEL from 6.5.0 to 6.8.2 #346, #451. Thanks to
Gary Gregory, Dependabot.
-* Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #321 Thanks to
Dependabot.
-* Bump commons-compress from 1.21 to 1.26.0 #329, #385. Thanks to
Dependabot, Gary Gregory.
-* Bump commons-net:commons-net from 3.8.0 to 3.10.0. Thanks to Gary
Gregory.
-* Bump httpclient from 4.5.13 to 4.5.14 #344. Thanks to Dependabot.
-* Bump commons-io:commons-io from 2.11.0 to 2.15.1. Thanks to Gary
Gregory.
-* Bump commons-codec:commons-codec from 1.15 to 1.16.1 #480. Thanks
to Gary Gregory.
-* Bump commons-lang3 from 3.12.0 to 3.14.0. Thanks to Gary Gregory.
-* Bump org.codehaus.mojo:exec-maven-plugin from 3.1.0 to 3.1.1 #445.
Thanks to Dependabot.
-* Bump commons-logging:commons-logging from 1.2 to 1.3.0. Thanks to
Gary Gregory.
-
-
-Historical list of changes:
https://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 Commons VFS Project
website:
-
-https://commons.apache.org/proper/commons-vfs/
-
-Download page: https://commons.apache.org/proper/commons-vfs/download_vfs.cgi
-
------------------------------------------------------------------------------
-
- Apache Commons VFS Project 2.10.0
- RELEASE NOTES
-
-The Apache Commons VFS Project team is pleased to announce the release of
Apache Commons VFS Project 2.10.0.
-
-Apache Commons VFS is a Virtual File System library.
-
-Maintenance release. Requires Java 8 or above.
-
-Changes in this version include:
-
-New features
-------------
-* VFS-848: Config option for trailing slash in webdav URI #425. Thanks to
beise, Gary Gregory.
-* Split out Apache Ant Tasks into its own Maven module
commons-vfs2-ant. Thanks to Gary Gregory.
-* VFS-851: Split out HDFS provider into its own Maven module
commons-vfs2-hdfs. Thanks to Gary Gregory.
-* Generate JPMS module info files when building on Java 11 or
greater, except for commons-vfs2-hdfs due to Hadoop libraries' overlapping
packages. Thanks to Gary Gregory.
-* Add vscode files to gitignore #205. Thanks to Seth Falco.
-* Add DefaultFileMonitor.setDelay(Duration), getDelayDuration() and
deprecate setDelay(long), getDelay(). Thanks to Gary Gregory.
-* DefaultFileMonitor implements AutoCloseable. Thanks to Gary
Gregory.
-* Add FalseFileFilter.INSTANCE and deprecate FalseFileFilter.FALSE.
Thanks to Gary Gregory.
-* Add TrueFileFilter.INSTANCE and deprecate TrueFileFilter.TRUE.
Thanks to Gary Gregory.
-* FileSystemOptions implements Comparable. Thanks to Gary Gregory.
-* Add RandomAccessMode.from(AccessMode) and toAccessModes(). Thanks
to Gary Gregory.
-* Extract the layer separator character constant into
LayeredFileName.LAYER_SEPARATOR. Thanks to Gary Gregory.
-* Add github/codeql-action.
-* VFS-821: Deprecate FileSelector#traverseDescendents in favor of
traverseDescendants. Thanks to Marc Wrobel, Gary Gregory.
-* VFS-821: Add active port range configuration for FTP client factory #318.
Thanks to Maksym Perevertov, Gary Gregory.
-* VFS-833: Make constructor FileSystemOptions(Map) public. Thanks to Kannan
Ramamoorthy, Bernd Eckenfels, Gary Gregory.
-* Add a BOM POM commons-vfs2-bom. Thanks to Gary Gregory.
-
-New features
-------------
-* Replace package.html with package-info.java #206. Thanks to Seth
Falco.
-* VFS-807: LocalFile.doGetOutputStream(boolean) for an existing file no
longer truncates the file. Thanks to Gary Gregory, L.
-* Update the Javadoc link to not lead to 404. #218. Thanks to
wodencafe.
-* VFS-810: Percent encoded backslashes in authority of URLs aren't allowed
for WebDav. Thanks to Jan Aelbrecht, Gary Gregory.
-* VFS-793: GenericFileName.getURI() returns invalid URI. Thanks to Vitali
Nashkevich, Gary Gregory.
-* Fix typos in error messages. Thanks to Gary Gregory.
-* LocalFile: Fix exception message "Unknown message with code" and
use an actual message code. Thanks to Gary Gregory.
-* VFS-778: SFTP channel isn't returned to the pool when
SftpFileObject.doGetOutputStream throws an exception. #215. Thanks to
zhouwenqing, Gary Gregory.
-* Fix OSGi "Unused Import-Package instructions". Thanks to Gary
Gregory.
-* VFS-813: NullPointerException needs a better message in SftpClientFactory
when connect with private key. Thanks to Andrey Turbanov, Gary Gregory.
-* VFS-811: Javadoc API links are broken in the commons-vfs project site #227.
Thanks to Woonsan Ko, Gary Gregory.
-* VFS-812: Don't throw FileSystemException when closing file content output
stream using a BufferedOutputStream #228. Thanks to XenoAmess, Gary Gregory.
-* VFS-814: FtpFileObject: re-fetch MDTM after refresh #238. Thanks to Luke
Wood, Gary Gregory.
-* Simplify conditions and avoid extra checks #253. Thanks to Arturo
Bernal.
-* Refactor AbstractFileObject#getOutputStream() #151. Thanks to
Boris Petrov, Gary Gregory.
-* VFS-770: FileSystemManager.createFileSystem(FileObject) fails on Gzip
files. #92. Thanks to Thomas BELOT, PeterAlfredLee, Gary Gregory.
-* Simplify/remove redundant operations. #258. Thanks to Arturo
Bernal.
-* SFTP: Memory leak because AbstractFileProvider#findFileSystem.
Thanks to Tobias Gierke, Gary Gregory.
-* Fix typos #275, #276, #277. Thanks to Marc Wrobel.
-* Fix links in Javadoc and documentations #284. Thanks to Marc
Wrobel.
-* [SFTP] Handle the case where a user does not have any groups #280.
Thanks to Mark van der Walle, Gary Gregory.
-* The dependency hadoop-hdfs-client is not set as optional #291.
Thanks to ymenager.
-* AbstractFileObject uses the wrong exception for "cause" #316.
Thanks to Boris Petrov.
-* JUnit5 assertThrows SftpFileSystemGroupsTests #323. Thanks to John
Patrick.
-* VFS-825: Fix for GZip input and output stream results in StackOverflowError
#322. Thanks to Anthony Goubard.
-* MonitorInputStream.read(byte[], int, int) and read() should be
synchronized like the superclass BufferedInputStream. Thanks to Gary Gregory.
-* VFS-683: Class loader thread safety #367. Thanks to Daryl Odnert, Otto
Fowler, Bernd Eckenfels, Dave MacDonald, Ivan Bella, Gary Gregory.
-* VFS-832: Sftp channel not put back in doGetInputStream #370. Thanks to
Wangerry, Gary Gregory.
-* [StepSecurity] ci: Harden GitHub Actions #401. Thanks to
step-security-bot, Gary Gregory.
-* VFS-846: Resolve a FileName to correct FileType #424. Thanks to beise, Gary
Gregory.
-* VFS-844: Prevent that source files urlString is twice URIEncoded #423.
Thanks to beise, Gary Gregory.
-* VFS-843: Close the HttpConnection after consuming the entire HttpEntity
#421. Thanks to beise, Gary Gregory.
-* VFS-841: Copy the Main class for testing with Jackrabbit Standalone
Components instead of reusing #409. Thanks to Woonsan Ko, Gary Gregory.
-* VFS-849: HttpConnection resources not properly cleaned up in webdav request
#428. Thanks to beise, Gary Gregory.
-* Don't use deprecated methods in
org.apache.commons.vfs2.provider.ftp.FtpClientFactory. Thanks to Gary Gregory.
-* Reduce deprecated calls in org.apache.commons.vfs2.provider.http5.
Thanks to Gary Gregory.
-*
DelegatingFileSystemOptionsBuilder.setConfigClass[es](FileSystemOptions,
String, String, Class) now throw the more general ReflectiveOperationException
instead of 2 subclasses. Thanks to Gary Gregory.
-* VFS-524: A URI with an IPv6 address can't be parsed out correctly #438.
Thanks to Alex, Fedor Yudanov, Gary Gregory.
-* Port assertions to JUnit 5 APIs. Thanks to Gary Gregory.
-* Scheme "http" now uses Apache HttpClient 5 instead of HttpClient
3. Thanks to Gary Gregory.
-* Scheme "https" now uses Apache HttpClient 5 instead of HttpClient
3. Thanks to Gary Gregory.
-* Deprecate package org.apache.commons.vfs2.provider.http in favor
of org.apache.commons.vfs2.provider.http5. Thanks to Gary Gregory.
-* Deprecate package org.apache.commons.vfs2.provider.https in favor
of org.apache.commons.vfs2.provider.http5s. Thanks to Gary Gregory.
-* Deprecate package org.apache.commons.vfs2.provider.http4 in favor
of org.apache.commons.vfs2.provider.http5. Thanks to Gary Gregory.
-* Deprecate package org.apache.commons.vfs2.provider.http4s in favor
of org.apache.commons.vfs2.provider.http5s. Thanks to Gary Gregory.
-* Support URLencoding during normalization #396. Thanks to Arnout
Engelen, Gary Gregory.
-
-Changes
--------
-
-* Bump actions/cache and others. Thanks to Dependabot, Gary Gregory.
-* Bump actions/checkout #217, #220, #245, #315, and others. Thanks
to Dependabot, Gary Gregory.
-* Bump actions/setup-java #324, and others. Thanks to Gary Gregory,
Dependabot.
-* Bump actions/upload-artifact from #327, and others. Thanks to
Dependabot.
-* Bump jakarta.mail from 1.6.7 to 2.0.1 #200. Thanks to Dependabot.
-* Bump commons.animal-sniffer.version from 1.19 to 1.21. Thanks to
Gary Gregory.
-* Bump com.puppycrawl.tools:checkstyle from 8.44 to 9.3 #211. Thanks
to Gary Gregory.
-* Bump com.github.spotbugs:spotbugs from 4.3.0 to 4.7.3 #216, #269,
#319. Thanks to Dependabot, Gary Gregory.
-* Bump spotbugs-maven-plugin from 4.3.0 to 4.7.3.0, #229, #236.
#264, #282, #331, #333. Thanks to Gary Gregory, Dependabot.
-* Bump jackrabbit2.version to 2.20.14. Never use 2.21.x, it is
"unstable". Thanks to Dependabot, Gary Gregory.
-* Bump org.apache.httpcomponents.client5:httpclient5 from 5.1 to 5.3
#345, #452. Thanks to Gary Gregory, Dependabot.
-* Bump org.apache.httpcomponents.core5:httpcore5 from 5.1.5 to 5.2.4
#369, #399, #429, #447. Thanks to Dependabot.
-* Bump org.apache.mina:mina-core from 2.1.4 to 2.1.8. Thanks to Gary
Gregory, Dependabot.
-* Bump maven-pmd-plugin from 3.14.0 to 3.19.0 #223, #294, #304.
Thanks to Dependabot, Gary Gregory.
-* Bump net.sourceforge.pmd:pmd-* from 6.36.0 to 6.53.0 #208, #247,
#256, #261, #266, #270, #283, #339, #361. Thanks to Dependabot, Gary Gregory.
-* Bump org.mockito:mockito-core from 3.11.2 to 4.11.0 #263, #292,
#308, #337, #355, #359. Thanks to Gary Gregory, Dependabot.
-* Bump maven-javadoc-plugin from 3.3.0 to 3.4.1, #293. Thanks to
Gary Gregory, Dependabot.
-* Bump biz.aQute.bnd:biz.aQute.bndlib from 5.3.0 to 6.3.1. Thanks to
Gary Gregory.
-* Bump commons.japicmp.version from 0.15.3 to 0.16.0. Thanks to Gary
Gregory.
-* Replace JUnit 4.13.2 with 5.9.1 #281, #306. Thanks to Gary
Gregory, John Patrick, Dependabot.
-* Bump org.apache.httpcomponents:httpcore-nio from 4.4.14 to 4.4.16,
#341. Thanks to Gary Gregory, Dependabot.
-* Bump Apache Log4j 2.14.1 to 2.22.1 [Tests] #226, #230, #305, #378,
#448, #461. Thanks to Gary Gregory, Dependabot.
-* Bump ftpserver-core from 1.1.1 to 1.1.2 #235. Thanks to XenoAmess.
-* Bump hadoop.version from 3.3.1 to 3.3.6 #246, #262, #290, #386,
#402. Thanks to Dependabot.
-* Bump slf4j.version from 1.7.26 to 1.7.36 #244. Thanks to
Dependabot.
-* Bump commons-parent from 52 to 65 #302, #349, #362. Thanks to
Dependabot, Gary Gregory.
-* Bump org.ow2.asm:asm from 9.2 to 9.4. Thanks to Gary Gregory.
-* Bump commons.jacoco.version from 0.8.7 to 0.8.8. Thanks to Gary
Gregory.
-* Bump commons.surefire.version from 3.0.0-M5 to 3.0.0-M7. Thanks to
Gary Gregory.
-* Bump Apache Commons BCEL from 6.5.0 to 6.8.1 #346, #451. Thanks to
Gary Gregory, Dependabot.
-* Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #321 Thanks to
Dependabot.
-* Bump commons-compress from 1.21 to 1.25.0 #329, #385. Thanks to
Dependabot, Gary Gregory.
-* Bump commons-net:commons-net from 3.8.0 to 3.10.0. Thanks to Gary
Gregory.
-* Bump httpclient from 4.5.13 to 4.5.14 #344. Thanks to Dependabot.
-* Bump commons-io:commons-io from 2.11.0 to 2.15.1. Thanks to Gary
Gregory.
-* Bump commons-codec:commons-codec from 1.15 to 1.16.0. Thanks to
Gary Gregory.
-* Bump commons-lang3 from 3.12.0 to 3.14.0. Thanks to Gary Gregory.
-* Bump org.codehaus.mojo:exec-maven-plugin from 3.1.0 to 3.1.1 #445.
Thanks to Dependabot.
-* Bump commons-logging:commons-logging from 1.2 to 1.3.0. Thanks to
Gary Gregory.
-
-
-Historical list of changes:
https://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 Commons VFS Project
website:
-
-https://commons.apache.org/proper/commons-vfs/
-
-Download page: https://commons.apache.org/proper/commons-vfs/download_vfs.cgi
-
+Apache Commons VFS Project 2.10.0
+RELEASE NOTES
+
+The Apache Commons VFS Project team is pleased to announce the release of
Apache Commons VFS Project 2.10.0.
+
+Apache Commons VFS is a Virtual File System library.
+
+Maintenance release. Requires Java 8 or above.
+
+Changes in this version
+-----------------------
+
+New features
+------------
+
+* VFS-848: Config option for trailing slash in webdav URI #425. Thanks to
beise, Gary Gregory.
+* Split out Apache Ant Tasks into its own Maven module
commons-vfs2-ant. Thanks to Gary Gregory.
+* VFS-851: Split out HDFS provider into its own Maven module
commons-vfs2-hdfs. Thanks to Gary Gregory.
+* Generate JPMS module info files when building on Java 11 or
greater, except for commons-vfs2-hdfs due to Hadoop libraries' overlapping
packages. Thanks to Gary Gregory.
+* Add Visual Studio Code files to gitignore #205. Thanks to Seth
Falco.
+* Add DefaultFileMonitor.setDelay(Duration), getDelayDuration() and
deprecate setDelay(long), getDelay(). Thanks to Gary Gregory.
+* DefaultFileMonitor implements AutoCloseable. Thanks to Gary
Gregory.
+* Add FalseFileFilter.INSTANCE and deprecate FalseFileFilter.FALSE.
Thanks to Gary Gregory.
+* Add TrueFileFilter.INSTANCE and deprecate TrueFileFilter.TRUE.
Thanks to Gary Gregory.
+* FileSystemOptions implements Comparable. Thanks to Gary Gregory.
+* Add RandomAccessMode.from(AccessMode) and toAccessModes(). Thanks
to Gary Gregory.
+* Extract the layer separator character constant into
LayeredFileName.LAYER_SEPARATOR. Thanks to Gary Gregory.
+* Add github/codeql-action.
+* VFS-821: Deprecate FileSelector#traverseDescendents in favor of
traverseDescendants. Thanks to Marc Wrobel, Gary Gregory.
+* VFS-821: Add active port range configuration for FTP client factory #318.
Thanks to Maksym Perevertov, Gary Gregory.
+* VFS-833: Make constructor FileSystemOptions(Map) public. Thanks to Kannan
Ramamoorthy, Bernd Eckenfels, Gary Gregory.
+* Add a BOM POM commons-vfs2-bom. Thanks to Gary Gregory.
+
+Fixed Bugs:
+* VFS-854: Avoid debug-logging URL credentials. Thanks to Andrey Turbanov.
+* VFS-853: Double wrapped weak FileListener can lose change notification with
DelegateFileObject. Thanks to Bernd Eckenfels.
+* Replace package.html with package-info.java #206. Thanks to Seth
Falco.
+* VFS-807: LocalFile.doGetOutputStream(boolean) for an existing file no
longer truncates the file. Thanks to Gary Gregory, L.
+* Update the Javadoc link to not lead to 404. #218. Thanks to
wodencafe.
+* VFS-810: Percent encoded backslashes in authority of URLs aren't allowed
for WebDav. Thanks to Jan Aelbrecht, Gary Gregory.
+* VFS-793: GenericFileName.getURI() returns invalid URI. Thanks to Vitali
Nashkevich, Gary Gregory.
+* Fix typos in error messages. Thanks to Gary Gregory.
+* LocalFile: Fix exception message "Unknown message with code" and
use an actual message code. Thanks to Gary Gregory.
+* VFS-778: SFTP channel isn't returned to the pool when
SftpFileObject.doGetOutputStream throws an exception. #215. Thanks to
zhouwenqing, Gary Gregory.
+* Fix OSGi "Unused Import-Package instructions". Thanks to Gary
Gregory.
+* VFS-813: NullPointerException needs a better message in SftpClientFactory
when connect with private key. Thanks to Andrey Turbanov, Gary Gregory.
+* VFS-811: Javadoc API links are broken in the commons-vfs project site #227.
Thanks to Woonsan Ko, Gary Gregory.
+* VFS-812: Don't throw FileSystemException when closing file content output
stream using a BufferedOutputStream #228. Thanks to XenoAmess, Gary Gregory.
+* VFS-814: FtpFileObject: re-fetch MDTM after refresh #238. Thanks to Luke
Wood, Gary Gregory.
+* Simplify conditions and avoid extra checks #253. Thanks to Arturo
Bernal.
+* Refactor AbstractFileObject#getOutputStream() #151. Thanks to
Boris Petrov, Gary Gregory.
+* VFS-770: FileSystemManager.createFileSystem(FileObject) fails on Gzip
files. #92. Thanks to Thomas BELOT, PeterAlfredLee, Gary Gregory.
+* Simplify/remove redundant operations. #258. Thanks to Arturo
Bernal.
+* SFTP: Memory leak because AbstractFileProvider#findFileSystem.
Thanks to Tobias Gierke, Gary Gregory.
+* Fix typos #275, #276, #277. Thanks to Marc Wrobel.
+* Fix links in Javadoc and documentations #284. Thanks to Marc
Wrobel.
+* [SFTP] Handle the case where a user does not have any groups #280.
Thanks to Mark van der Walle, Gary Gregory.
+* The dependency hadoop-hdfs-client is not set as optional #291.
Thanks to ymenager.
+* AbstractFileObject uses the wrong exception for "cause" #316.
Thanks to Boris Petrov.
+* JUnit5 assertThrows SftpFileSystemGroupsTests #323. Thanks to John
Patrick.
+* VFS-825: Fix for GZip input and output stream results in StackOverflowError
#322. Thanks to Anthony Goubard.
+* MonitorInputStream.read(byte[], int, int) and read() should be
synchronized like the superclass BufferedInputStream. Thanks to Gary Gregory.
+* VFS-683: Class loader thread safety #367. Thanks to Daryl Odnert, Otto
Fowler, Bernd Eckenfels, Dave MacDonald, Ivan Bella, Gary Gregory.
+* VFS-832: Sftp channel not put back in doGetInputStream #370. Thanks to
Wangerry, Gary Gregory.
+* [StepSecurity] ci: Harden GitHub Actions #401. Thanks to
step-security-bot, Gary Gregory.
+* VFS-846: Resolve a FileName to correct FileType #424. Thanks to beise, Gary
Gregory.
+* VFS-844: Prevent that source files urlString is twice URIEncoded #423.
Thanks to beise, Gary Gregory.
+* VFS-843: Close the HttpConnection after consuming the entire HttpEntity
#421. Thanks to beise, Gary Gregory.
+* VFS-841: Copy the Main class for testing with Jackrabbit Standalone
Components instead of reusing #409. Thanks to Woonsan Ko, Gary Gregory.
+* VFS-849: HttpConnection resources not properly cleaned up in webdav request
#428. Thanks to beise, Gary Gregory.
+* Don't use deprecated methods in
org.apache.commons.vfs2.provider.ftp.FtpClientFactory. Thanks to Gary Gregory.
+* Reduce deprecated calls in org.apache.commons.vfs2.provider.http5.
Thanks to Gary Gregory.
+*
DelegatingFileSystemOptionsBuilder.setConfigClass[es](FileSystemOptions,
String, String, Class) now throw the more general ReflectiveOperationException
instead of 2 subclasses. Thanks to Gary Gregory.
+* VFS-524: A URI with an IPv6 address can't be parsed out correctly #438.
Thanks to Alex, Fedor Yudanov, Gary Gregory.
+* Port assertions to JUnit 5 APIs. Thanks to Gary Gregory.
+* Scheme "http" now uses Apache HttpClient 5 instead of HttpClient
3. Thanks to Gary Gregory.
+* Scheme "https" now uses Apache HttpClient 5 instead of HttpClient
3. Thanks to Gary Gregory.
+* Deprecate package org.apache.commons.vfs2.provider.http in favor
of org.apache.commons.vfs2.provider.http5. Thanks to Gary Gregory.
+* Deprecate package org.apache.commons.vfs2.provider.https in favor
of org.apache.commons.vfs2.provider.http5s. Thanks to Gary Gregory.
+* Deprecate package org.apache.commons.vfs2.provider.http4 in favor
of org.apache.commons.vfs2.provider.http5. Thanks to Gary Gregory.
+* Deprecate package org.apache.commons.vfs2.provider.http4s in favor
of org.apache.commons.vfs2.provider.http5s. Thanks to Gary Gregory.
+* Support URLencoding during normalization #396. Thanks to Arnout
Engelen, Gary Gregory.
+* Add some documentation to make the unit tests easier to follow
#556. Thanks to Arnout Engelen, Gary Gregory.
+* Fix or address PMD warnings UnnecessaryReturn,
UnusedLocalVariable, UnnecessaryFullyQualifiedName, UnnecessaryImport, and so
on. Thanks to Gary Gregory.
+* Simplify UriParser #558. Thanks to Arnout Engelen.
+
+Changes
+-------
+
+* Bump actions/cache and others. Thanks to Dependabot, Gary Gregory.
+* Bump actions/checkout #217, #220, #245, #315, and others. Thanks
to Dependabot, Gary Gregory.
+* Bump actions/setup-java #324, and others. Thanks to Gary Gregory,
Dependabot.
+* Bump actions/upload-artifact from #327, and others. Thanks to
Dependabot.
+* Bump jakarta.mail from 1.6.7 to 2.0.1 #200. Thanks to Dependabot.
+* Bump commons.animal-sniffer.version from 1.19 to 1.21. Thanks to
Gary Gregory.
+* Bump com.puppycrawl.tools:checkstyle from 8.44 to 9.3 #211. Thanks
to Gary Gregory.
+* Bump com.github.spotbugs:spotbugs from 4.3.0 to 4.7.3 #216, #269,
#319. Thanks to Dependabot, Gary Gregory.
+* Bump spotbugs-maven-plugin from 4.3.0 to 4.7.3.0, #229, #236.
#264, #282, #331, #333. Thanks to Gary Gregory, Dependabot.
+* Bump org.apache.jackrabbit:jackrabbit-standalone-components from
2.21.7 to 2.20.16, 2.21.x is beta only. Thanks to Dependabot, Gary Gregory.
+* Bump org.apache.httpcomponents.client5:httpclient5 from 5.1 to
5.4-beta1 #561. Thanks to Gary Gregory, Dependabot.
+* Bump org.apache.httpcomponents.core5:httpcore5 from 5.1.5 to
5.3-beta1 #369, #399, #429, #447, #559. Thanks to Dependabot.
+* Bump org.apache.mina:mina-core from 2.1.4 to 2.1.8. Thanks to Gary
Gregory, Dependabot.
+* Bump maven-pmd-plugin from 3.14.0 to 3.19.0 #223, #294, #304.
Thanks to Dependabot, Gary Gregory.
+* Bump net.sourceforge.pmd:pmd-* from 6.36.0 to 6.53.0 #208, #247,
#256, #261, #266, #270, #283, #339, #361. Thanks to Dependabot, Gary Gregory.
+* Bump org.mockito:mockito-core from 3.11.2 to 4.11.0 #263, #292,
#308, #337, #355, #359. Thanks to Gary Gregory, Dependabot.
+* Bump maven-javadoc-plugin from 3.3.0 to 3.4.1, #293. Thanks to
Gary Gregory, Dependabot.
+* Bump biz.aQute.bnd:biz.aQute.bndlib from 5.3.0 to 6.3.1. Thanks to
Gary Gregory.
+* Bump commons.japicmp.version from 0.15.3 to 0.16.0. Thanks to Gary
Gregory.
+* Replace JUnit 4.13.2 with 5.9.1 #281, #306. Thanks to Gary
Gregory, John Patrick, Dependabot.
+* Bump org.apache.httpcomponents:httpcore-nio from 4.4.14 to 4.4.16,
#341. Thanks to Gary Gregory, Dependabot.
+* Bump Apache Log4j 2.14.1 to 2.23.1 [Tests] #226, #230, #305, #378,
#448, #461, #487, #499. Thanks to Gary Gregory, Dependabot.
+* Bump ftpserver-core from 1.1.1 to 1.1.2 #235. Thanks to XenoAmess.
+* Bump hadoop.version from 3.3.1 to 3.3.6 #246, #262, #290, #386,
#402. Thanks to Dependabot.
+* Bump slf4j.version from 1.7.26 to 2.0.15 #484, #486, #524, #575,
#580. Thanks to Dependabot.
+* Bump org.apache.commons:commons-parent from 52 to 72 #497. Thanks
to Dependabot, Gary Gregory.
+* Bump org.ow2.asm:asm from 9.2 to 9.4. Thanks to Gary Gregory.
+* Bump commons.jacoco.version from 0.8.7 to 0.8.8. Thanks to Gary
Gregory.
+* Bump commons.surefire.version from 3.0.0-M5 to 3.0.0-M7. Thanks to
Gary Gregory.
+* Bump Apache Commons BCEL from 6.5.0 to 6.10.0 #346, #451, #522,
#569. Thanks to Gary Gregory, Dependabot.
+* Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #321 Thanks to
Dependabot.
+* Bump commons-compress from 1.21 to 1.27.0 #329, #385, $498, #535,
#579. Thanks to Dependabot, Gary Gregory.
+* Bump commons-net:commons-net from 3.8.0 to 3.11.1 #546, #548.
Thanks to Gary Gregory, Dependabot.
+* Bump httpclient from 4.5.13 to 4.5.14 #344. Thanks to Dependabot.
+* Bump commons-io:commons-io from 2.11.0 to 2.16.1 #515. Thanks to
Gary Gregory.
+* Bump commons-codec:commons-codec from 1.15 to 1.17.1 #480, #530,
#567. Thanks to Gary Gregory.
+* Bump org.apache.commons:commons-lang3 from 3.12.0 to 3.16.0 #568,
#577. Thanks to Gary Gregory.
+* Bump org.codehaus.mojo:exec-maven-plugin from 3.1.0 to 3.4.0 #445,
#536, #576. Thanks to Dependabot.
+* Bump commons-logging:commons-logging from 1.2 to 1.3.3, #531,
#563. Thanks to Gary Gregory.
+* Bump org.codehaus.mojo:exec-maven-plugin from 3.1.1 to 3.2.0 #494.
Thanks to Gary Gregory.
+* Bump org.apache.commons:commons-collections4 from 4.4 to 4.5.0-M2.
Thanks to Gary Gregory.
+* Bump ant:ant 1.6.5 to org.apache.ant:ant 1.10.14. Thanks to Gary
Gregory.
+
+
+Historical list of changes:
https://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 Commons VFS Project
website:
+
+https://commons.apache.org/proper/commons-vfs/
+
+Download page: https://commons.apache.org/proper/commons-vfs/download_vfs.cgi
+
-----------------------------------------------------------------------------
Apache Commons VFS Project 2.9.0
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 59e38724..c0ff7eb4 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -45,7 +45,7 @@ The <action> type attribute can be add,update,fix,remove.
<author email="[email protected]">Apache Commons Developers</author>
</properties>
<body>
- <release version="2.10.0" date="YYYY-MM-DD" description="Maintenance
release. Requires Java 8 or above.">
+ <release version="2.10.0" date="2024-08-10" description="Maintenance
release. Requires Java 8 or above.">
<!-- FIX -->
<action type="fix" issue="VFS-854" dev="ecki" due-to="Andrey Turbanov">
Avoid debug-logging URL credentials.
diff --git a/src/site/xdoc/download_vfs.xml b/src/site/xdoc/download_vfs.xml
index 6d394f16..75c6bf69 100644
--- a/src/site/xdoc/download_vfs.xml
+++ b/src/site/xdoc/download_vfs.xml
@@ -1,156 +1,156 @@
-<?xml version="1.0"?>
-<!--
-Licensed to the Apache Software Foundation (ASF) under one or more
-contributor license agreements. See the NOTICE file distributed with
-this work for additional information regarding copyright ownership.
-The ASF licenses this file to You under the Apache License, Version 2.0
-(the "License"); you may not use this file except in compliance with
-the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!--
- +======================================================================+
- |**** ****|
- |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
- |**** DO NOT EDIT DIRECTLY ****|
- |**** ****|
- +======================================================================+
- | TEMPLATE FILE: download-page-template.xml |
- | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
- +======================================================================+
- | |
- | 1) Re-generate using: mvn commons-build:download-page |
- | |
- | 2) Set the following properties in the component's pom: |
- | - commons.componentid (required, alphabetic, lower case) |
- | - commons.release.version (required) |
- | - commons.release.name (required) |
- | - commons.binary.suffix (optional) |
- | (defaults to "-bin", set to "" for pre-maven2 releases) |
- | - commons.release.desc (optional) |
- | - commons.release.subdir (optional) |
- | - 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, [sha512])|
- | |
- | 3) Example Properties |
- | (commons.release.name inherited by parent: |
- | ${project.artifactId}-${commons.release.version} |
- | |
- | <properties> |
- | <commons.componentid>math</commons.componentid> |
- | <commons.release.version>1.2</commons.release.version> |
- | </properties> |
- | |
- +======================================================================+
--->
-<document>
- <properties>
- <title>Download Apache Commons VFS Project</title>
- <author email="[email protected]">Apache Commons Documentation
Team</author>
- </properties>
- <body>
- <section name="Download Apache Commons VFS Project">
- <subsection name="Using a Mirror">
- <p>
- We recommend you use a mirror to download our release
- 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.
- </p>
-
- <p>
- You are currently using <b>[preferred]</b>. If you
- encounter a problem with this mirror, please select another
- mirror. If all mirrors are failing, there are <i>backup</i>
- mirrors (at the end of the mirrors list) that should be
- available.
- <br></br>
- [if-any logo]<a href="[link]"><img align="right" src="[logo]"
border="0"></img></a>[end]
- </p>
-
- <form action="[location]" method="get" id="SelectMirror">
- <p>
- Other mirrors:
- <select name="Preferred">
- [if-any http]
- [for http]<option value="[http]">[http]</option>[end]
- [end]
- [if-any ftp]
- [for ftp]<option value="[ftp]">[ftp]</option>[end]
- [end]
- [if-any backup]
- [for backup]<option value="[backup]">[backup]
(backup)</option>[end]
- [end]
- </select>
- <input type="submit" value="Change"></input>
- </p>
- </form>
-
- <p>
- 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>SHA512</code> hash (<code>*.sha512</code>
checksum files).
- </p>
- <p>
- The <a href="https://downloads.apache.org/commons/KEYS";>KEYS</a>
- file contains the public PGP keys used by Apache Commons developers
- to sign releases.
- </p>
- </subsection>
- </section>
- <section name="Apache Commons VFS Project 2.10.0 (requires Java 8 or
above)">
- <subsection name="Binaries">
- <table>
- <tr>
- <td><a
href="[preferred]/commons/vfs/binaries/commons-vfs-2.10.0-bin.tar.gz">commons-vfs-2.10.0-bin.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/vfs/binaries/commons-vfs-2.10.0-bin.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/vfs/binaries/commons-vfs-2.10.0-bin.tar.gz.asc";>pgp</a></td>
- </tr>
- <tr>
- <td><a
href="[preferred]/commons/vfs/binaries/commons-vfs-2.10.0-bin.zip">commons-vfs-2.10.0-bin.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/vfs/binaries/commons-vfs-2.10.0-bin.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/vfs/binaries/commons-vfs-2.10.0-bin.zip.asc";>pgp</a></td>
- </tr>
- </table>
- </subsection>
- <subsection name="Source">
- <table>
- <tr>
- <td><a
href="[preferred]/commons/vfs/source/commons-vfs-2.10.0-src.tar.gz">commons-vfs-2.10.0-src.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/vfs/source/commons-vfs-2.10.0-src.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/vfs/source/commons-vfs-2.10.0-src.tar.gz.asc";>pgp</a></td>
- </tr>
- <tr>
- <td><a
href="[preferred]/commons/vfs/source/commons-vfs-2.10.0-src.zip">commons-vfs-2.10.0-src.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/vfs/source/commons-vfs-2.10.0-src.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/vfs/source/commons-vfs-2.10.0-src.zip.asc";>pgp</a></td>
- </tr>
- </table>
- </subsection>
- </section>
- <section name="Archives">
- <p>
- Older releases can be obtained from the archives.
- </p>
- <ul>
- <li class="download"><a href="[preferred]/commons/vfs/">browse
download area</a></li>
- <li><a
href="https://archive.apache.org/dist/commons/vfs/";>archives...</a></li>
- </ul>
- </section>
- </body>
-</document>
+<?xml version="1.0"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!--
+ +======================================================================+
+ |**** ****|
+ |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
+ |**** DO NOT EDIT DIRECTLY ****|
+ |**** ****|
+ +======================================================================+
+ | TEMPLATE FILE: download-page-template.xml |
+ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+ +======================================================================+
+ | |
+ | 1) Re-generate using: mvn commons-build:download-page |
+ | |
+ | 2) Set the following properties in the component's pom: |
+ | - commons.componentid (required, alphabetic, lower case) |
+ | - commons.release.version (required) |
+ | - commons.release.name (required) |
+ | - commons.binary.suffix (optional) |
+ | (defaults to "-bin", set to "" for pre-maven2 releases) |
+ | - commons.release.desc (optional) |
+ | - commons.release.subdir (optional) |
+ | - 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, [sha512])|
+ | |
+ | 3) Example Properties |
+ | (commons.release.name inherited by parent: |
+ | ${project.artifactId}-${commons.release.version} |
+ | |
+ | <properties> |
+ | <commons.componentid>math</commons.componentid> |
+ | <commons.release.version>1.2</commons.release.version> |
+ | </properties> |
+ | |
+ +======================================================================+
+-->
+<document>
+ <properties>
+ <title>Download Apache Commons VFS Project</title>
+ <author email="[email protected]">Apache Commons Documentation
Team</author>
+ </properties>
+ <body>
+ <section name="Download Apache Commons VFS Project">
+ <subsection name="Using a Mirror">
+ <p>
+ We recommend you use a mirror to download our release
+ 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.
+ </p>
+
+ <p>
+ You are currently using <b>[preferred]</b>. If you
+ encounter a problem with this mirror, please select another
+ mirror. If all mirrors are failing, there are <i>backup</i>
+ mirrors (at the end of the mirrors list) that should be
+ available.
+ <br></br>
+ [if-any logo]<a href="[link]"><img align="right" src="[logo]"
border="0"></img></a>[end]
+ </p>
+
+ <form action="[location]" method="get" id="SelectMirror">
+ <p>
+ Other mirrors:
+ <select name="Preferred">
+ [if-any http]
+ [for http]<option value="[http]">[http]</option>[end]
+ [end]
+ [if-any ftp]
+ [for ftp]<option value="[ftp]">[ftp]</option>[end]
+ [end]
+ [if-any backup]
+ [for backup]<option value="[backup]">[backup]
(backup)</option>[end]
+ [end]
+ </select>
+ <input type="submit" value="Change"></input>
+ </p>
+ </form>
+
+ <p>
+ 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>SHA512</code> hash (<code>*.sha512</code>
checksum files).
+ </p>
+ <p>
+ The <a href="https://downloads.apache.org/commons/KEYS";>KEYS</a>
+ file contains the public PGP keys used by Apache Commons developers
+ to sign releases.
+ </p>
+ </subsection>
+ </section>
+ <section name="Apache Commons VFS Project 2.10.0 (requires Java 8 or
above)">
+ <subsection name="Binaries">
+ <table>
+ <tr>
+ <td><a
href="[preferred]/commons/vfs/binaries/commons-vfs-2.10.0-bin.tar.gz">commons-vfs-2.10.0-bin.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/vfs/binaries/commons-vfs-2.10.0-bin.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/vfs/binaries/commons-vfs-2.10.0-bin.tar.gz.asc";>pgp</a></td>
+ </tr>
+ <tr>
+ <td><a
href="[preferred]/commons/vfs/binaries/commons-vfs-2.10.0-bin.zip">commons-vfs-2.10.0-bin.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/vfs/binaries/commons-vfs-2.10.0-bin.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/vfs/binaries/commons-vfs-2.10.0-bin.zip.asc";>pgp</a></td>
+ </tr>
+ </table>
+ </subsection>
+ <subsection name="Source">
+ <table>
+ <tr>
+ <td><a
href="[preferred]/commons/vfs/source/commons-vfs-2.10.0-src.tar.gz">commons-vfs-2.10.0-src.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/vfs/source/commons-vfs-2.10.0-src.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/vfs/source/commons-vfs-2.10.0-src.tar.gz.asc";>pgp</a></td>
+ </tr>
+ <tr>
+ <td><a
href="[preferred]/commons/vfs/source/commons-vfs-2.10.0-src.zip">commons-vfs-2.10.0-src.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/vfs/source/commons-vfs-2.10.0-src.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/vfs/source/commons-vfs-2.10.0-src.zip.asc";>pgp</a></td>
+ </tr>
+ </table>
+ </subsection>
+ </section>
+ <section name="Archives">
+ <p>
+ Older releases can be obtained from the archives.
+ </p>
+ <ul>
+ <li class="download"><a href="[preferred]/commons/vfs/">browse
download area</a></li>
+ <li><a
href="https://archive.apache.org/dist/commons/vfs/";>archives...</a></li>
+ </ul>
+ </section>
+ </body>
+</document>
diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml
index 6d9bab39..624b9ee6 100644
--- a/src/site/xdoc/issue-tracking.xml
+++ b/src/site/xdoc/issue-tracking.xml
@@ -1,102 +1,102 @@
-<?xml version="1.0"?>
-<!--
-Licensed to the Apache Software Foundation (ASF) under one or more
-contributor license agreements. See the NOTICE file distributed with
-this work for additional information regarding copyright ownership.
-The ASF licenses this file to You under the Apache License, Version 2.0
-(the "License"); you may not use this file except in compliance with
-the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<!--
- +======================================================================+
- |**** ****|
- |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
- |**** DO NOT EDIT DIRECTLY ****|
- |**** ****|
- +======================================================================+
- | TEMPLATE FILE: issue-tracking-template.xml |
- | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
- +======================================================================+
- | |
- | 1) Re-generate using: mvn commons-build:jira-page |
- | |
- | 2) Set the following properties in the component's pom: |
- | - commons.jira.id (required, alphabetic, upper case) |
- | - commons.jira.pid (required, numeric) |
- | |
- | 3) Example Properties |
- | |
- | <properties> |
- | <commons.jira.id>MATH</commons.jira.id> |
- | <commons.jira.pid>12310485</commons.jira.pid> |
- | </properties> |
- | |
- +======================================================================+
--->
-<document>
- <properties>
- <title>Apache Commons VFS Project Issue tracking</title>
- <author email="[email protected]">Apache Commons Documentation
Team</author>
- </properties>
- <body>
-
- <section name="Apache Commons VFS Project Issue tracking">
- <p>
- Apache Commons VFS Project uses <a
href="https://issues.apache.org/jira/";>ASF JIRA</a> for tracking issues.
- See the <a href="https://issues.apache.org/jira/browse/VFS";>Apache
Commons VFS Project JIRA project page</a>.
- </p>
-
- <p>
- To use JIRA you may need to <a
href="https://issues.apache.org/jira/secure/Signup!default.jspa";>create an
account</a>
- (if you have previously created/updated Commons issues using Bugzilla an
account will have been automatically
- created and you can use the <a
href="https://issues.apache.org/jira/secure/ForgotPassword!default.jspa";>Forgot
Password</a>
- page to get a new password).
- </p>
-
- <p>
- If you would like to report a bug, or raise an enhancement request with
- Apache Commons VFS Project please do the following:
- <ol>
- <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310495&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4";>Search
existing open bugs</a>.
- If you find your issue listed then please add a comment with your
details.</li>
- <li><a href="mail-lists.html">Search the mailing list archive(s)</a>.
- You may find your issue or idea has already been discussed.</li>
- <li>Decide if your issue is a bug or an enhancement.</li>
- <li>Submit either a <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310495&issuetype=1&priority=4&assignee=-1";>bug
report</a>
- or <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310495&issuetype=4&priority=4&assignee=-1";>enhancement
request</a>.</li>
- </ol>
- </p>
-
- <p>
- Please also remember these points:
- <ul>
- <li>the more information you provide, the better we can help you</li>
- <li>test cases are vital, particularly for any proposed
enhancements</li>
- <li>the developers of Apache Commons VFS Project are all unpaid
volunteers</li>
- </ul>
- </p>
-
- <p>
- For more information on creating patches see the
- <a href="https://www.apache.org/dev/contributors.html";>Apache
Contributors Guide</a>.
- </p>
-
- <p>
- You may also find these links useful:
- <ul>
- <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310495&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4";>All
Open Apache Commons VFS Project bugs</a></li>
- <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310495&sorter/field=issuekey&sorter/order=DESC&status=5&status=6";>All
Resolved Apache Commons VFS Project bugs</a></li>
- <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310495&sorter/field=issuekey&sorter/order=DESC";>All
Apache Commons VFS Project bugs</a></li>
- </ul>
- </p>
- </section>
- </body>
-</document>
+<?xml version="1.0"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<!--
+ +======================================================================+
+ |**** ****|
+ |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****|
+ |**** DO NOT EDIT DIRECTLY ****|
+ |**** ****|
+ +======================================================================+
+ | TEMPLATE FILE: issue-tracking-template.xml |
+ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+ +======================================================================+
+ | |
+ | 1) Re-generate using: mvn commons-build:jira-page |
+ | |
+ | 2) Set the following properties in the component's pom: |
+ | - commons.jira.id (required, alphabetic, upper case) |
+ | - commons.jira.pid (required, numeric) |
+ | |
+ | 3) Example Properties |
+ | |
+ | <properties> |
+ | <commons.jira.id>MATH</commons.jira.id> |
+ | <commons.jira.pid>12310485</commons.jira.pid> |
+ | </properties> |
+ | |
+ +======================================================================+
+-->
+<document>
+ <properties>
+ <title>Apache Commons VFS Project Issue tracking</title>
+ <author email="[email protected]">Apache Commons Documentation
Team</author>
+ </properties>
+ <body>
+
+ <section name="Apache Commons VFS Project Issue tracking">
+ <p>
+ Apache Commons VFS Project uses <a
href="https://issues.apache.org/jira/";>ASF JIRA</a> for tracking issues.
+ See the <a href="https://issues.apache.org/jira/browse/VFS";>Apache
Commons VFS Project JIRA project page</a>.
+ </p>
+
+ <p>
+ To use JIRA you may need to <a
href="https://issues.apache.org/jira/secure/Signup!default.jspa";>create an
account</a>
+ (if you have previously created/updated Commons issues using Bugzilla an
account will have been automatically
+ created and you can use the <a
href="https://issues.apache.org/jira/secure/ForgotPassword!default.jspa";>Forgot
Password</a>
+ page to get a new password).
+ </p>
+
+ <p>
+ If you would like to report a bug, or raise an enhancement request with
+ Apache Commons VFS Project please do the following:
+ <ol>
+ <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310495&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4";>Search
existing open bugs</a>.
+ If you find your issue listed then please add a comment with your
details.</li>
+ <li><a href="mail-lists.html">Search the mailing list archive(s)</a>.
+ You may find your issue or idea has already been discussed.</li>
+ <li>Decide if your issue is a bug or an enhancement.</li>
+ <li>Submit either a <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310495&issuetype=1&priority=4&assignee=-1";>bug
report</a>
+ or <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310495&issuetype=4&priority=4&assignee=-1";>enhancement
request</a>.</li>
+ </ol>
+ </p>
+
+ <p>
+ Please also remember these points:
+ <ul>
+ <li>the more information you provide, the better we can help you</li>
+ <li>test cases are vital, particularly for any proposed
enhancements</li>
+ <li>the developers of Apache Commons VFS Project are all unpaid
volunteers</li>
+ </ul>
+ </p>
+
+ <p>
+ For more information on creating patches see the
+ <a href="https://www.apache.org/dev/contributors.html";>Apache
Contributors Guide</a>.
+ </p>
+
+ <p>
+ You may also find these links useful:
+ <ul>
+ <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310495&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4";>All
Open Apache Commons VFS Project bugs</a></li>
+ <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310495&sorter/field=issuekey&sorter/order=DESC&status=5&status=6";>All
Resolved Apache Commons VFS Project bugs</a></li>
+ <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310495&sorter/field=issuekey&sorter/order=DESC";>All
Apache Commons VFS Project bugs</a></li>
+ </ul>
+ </p>
+ </section>
+ </body>
+</document>
