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-net.git
The following commit(s) were added to refs/heads/master by this push:
new 775b04b4 Prepare for the next release candidate
775b04b4 is described below
commit 775b04b49400f36f03b68b8e8d50273390a35bc7
Author: Gary Gregory <garydgreg...@gmail.com>
AuthorDate: Tue May 28 23:46:30 2024 +0000
Prepare for the next release candidate
---
CONTRIBUTING.md | 5 +-
README.md | 81 ++++++-----------------
RELEASE-NOTES.txt | 145 ++++++++++++++++++++++++++++++-----------
pom.xml | 3 +-
src/changes/changes.xml | 2 +-
src/changes/release-notes.vm | 22 ++++---
src/site/xdoc/download_net.xml | 26 ++++----
src/site/xdoc/mail-lists.xml | 38 +++++------
8 files changed, 177 insertions(+), 145 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 71f0edce..c0684bf3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -49,13 +49,13 @@ Getting Started
---------------
+ Make sure you have a [JIRA account](https://issues.apache.org/jira/).
-+ Make sure you have a [GitHub account](https://github.com/signup/free).
++ Make sure you have a [GitHub account](https://github.com/signup/free). This
is not essential, but makes providing patches much easier.
+ If you're planning to implement a new feature it makes sense to discuss your
changes on the [dev list](https://commons.apache.org/mail-lists.html) first.
This way you can make sure you're not wasting your time on something that isn't
considered to be in Apache Commons Net's scope.
+ Submit a [Jira Ticket][jira] for your issue, assuming one does not already
exist.
+ Clearly describe the issue including steps to reproduce when it is a bug.
+ Make sure you fill in the earliest version that you know has the issue.
+ Find the corresponding [repository on
GitHub](https://github.com/apache/?query=commons-),
-[fork](https://help.github.com/articles/fork-a-repo/) and check out your
forked repository.
+[fork](https://help.github.com/articles/fork-a-repo/) and check out your
forked repository. If you don't have a GitHub account, you can still clone the
Commons repository.
Making Changes
--------------
@@ -109,7 +109,6 @@ Additional Resources
+ [General GitHub documentation](https://help.github.com/)
+ [GitHub pull request
documentation](https://help.github.com/articles/creating-a-pull-request/)
+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
-+ `#apache-commons` IRC channel on `irc.freenode.net`
[cla]:https://www.apache.org/licenses/#clas
[jira]:https://issues.apache.org/jira/browse/NET
diff --git a/README.md b/README.md
index ccddd16c..63a91252 100644
--- a/README.md
+++ b/README.md
@@ -46,12 +46,12 @@ Apache Commons Net
[](https://github.com/apache/commons-net/actions/workflows/maven.yml)
[](https://app.codecov.io/gh/apache/commons-net)
[](https://maven-badges.herokuapp.com/maven-central/commons-net/commons-net/?gav=true)
-[](https://javadoc.io/doc/commons-net/commons-net/3.10.0)
+[](https://javadoc.io/doc/commons-net/commons-net/3.11.0)
[](https://github.com/apache/commons-net/actions/workflows/codeql-analysis.yml)
[](https://api.securityscorecards.dev/projects/github.com/apache/commons-net)
Apache Commons Net library contains a collection of network utilities and
protocol implementations.
-Supported protocols include: Echo, Finger, FTP, NNTP, NTP, POP3(S), SMTP(S),
Telnet, Whois.
+Supported protocols include Echo, Finger, FTP, NNTP, NTP, POP3(S), SMTP(S),
Telnet, and Whois.
Documentation
-------------
@@ -60,8 +60,8 @@ More information can be found on the [Apache Commons Net
homepage](https://commo
The [Javadoc](https://commons.apache.org/proper/commons-net/apidocs) can be
browsed.
Questions related to the usage of Apache Commons Net should be posted to the
[user mailing list](https://commons.apache.org/mail-lists.html).
-Where can I get the latest release?
------------------------------------
+Getting the latest release
+--------------------------
You can download source and binaries from our [download
page](https://commons.apache.org/proper/commons-net/download_net.cgi).
Alternatively, you can pull it from the central Maven repositories:
@@ -70,17 +70,25 @@ Alternatively, you can pull it from the central Maven
repositories:
<dependency>
<groupId>commons-net</groupId>
<artifactId>commons-net</artifactId>
- <version>3.10.0</version>
+ <version>3.11.0</version>
</dependency>
```
+Building
+--------
+
+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.
+
Contributing
------------
We accept Pull Requests via GitHub. The [developer mailing
list](https://commons.apache.org/mail-lists.html) is the main channel of
communication for contributors.
There are some guidelines which will make applying PRs easier for us:
+ No tabs! Please use spaces for indentation.
-+ Respect the code style.
++ 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```.
@@ -89,13 +97,13 @@ You can learn more about contributing via GitHub in our
[contribution guidelines
License
-------
-This code is under the [Apache License
v2](https://www.apache.org/licenses/LICENSE-2.0).
+This code is licensed under the [Apache License
v2](https://www.apache.org/licenses/LICENSE-2.0).
See the `NOTICE.txt` file for required notices and attributions.
-Donations
----------
-You like Apache Commons Net? Then [donate back to the
ASF](https://www.apache.org/foundation/contributing.html) to support the
development.
+Donating
+--------
+You like Apache Commons Net? Then [donate back to the
ASF](https://www.apache.org/foundation/contributing.html) to support
development.
Additional Resources
--------------------
@@ -104,59 +112,8 @@ Additional Resources
+ [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/NET)
+ [Apache Commons Slack Channel](https://the-asf.slack.com/archives/C60NVB8AD)
+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
-+ `#apache-commons` IRC channel on `irc.freenode.org`
Apache Commons Components
-------------------------
-| Component | GitHub Repository | Apache Homepage |
-| --------- | ----------------- | ----------------|
-| Apache Commons BCEL | [commons-bcel](https://github.com/apache/commons-bcel)
| [commons-bcel](https://commons.apache.org/proper/commons-bcel) |
-| Apache Commons Beanutils |
[commons-beanutils](https://github.com/apache/commons-beanutils) |
[commons-beanutils](https://commons.apache.org/proper/commons-beanutils) |
-| Apache Commons BSF | [commons-bsf](https://github.com/apache/commons-bsf) |
[commons-bsf](https://commons.apache.org/proper/commons-bsf) |
-| Apache Commons Build-plugin |
[commons-build-plugin](https://github.com/apache/commons-build-plugin) |
[commons-build-plugin](https://commons.apache.org/proper/commons-build-plugin) |
-| Apache Commons Chain |
[commons-chain](https://github.com/apache/commons-chain) |
[commons-chain](https://commons.apache.org/proper/commons-chain) |
-| Apache Commons CLI | [commons-cli](https://github.com/apache/commons-cli) |
[commons-cli](https://commons.apache.org/proper/commons-cli) |
-| Apache Commons Codec |
[commons-codec](https://github.com/apache/commons-codec) |
[commons-codec](https://commons.apache.org/proper/commons-codec) |
-| Apache Commons Collections |
[commons-collections](https://github.com/apache/commons-collections) |
[commons-collections](https://commons.apache.org/proper/commons-collections) |
-| Apache Commons Compress |
[commons-compress](https://github.com/apache/commons-compress) |
[commons-compress](https://commons.apache.org/proper/commons-compress) |
-| Apache Commons Configuration |
[commons-configuration](https://github.com/apache/commons-configuration) |
[commons-configuration](https://commons.apache.org/proper/commons-configuration)
|
-| Apache Commons Crypto |
[commons-crypto](https://github.com/apache/commons-crypto) |
[commons-crypto](https://commons.apache.org/proper/commons-crypto) |
-| Apache Commons CSV | [commons-csv](https://github.com/apache/commons-csv) |
[commons-csv](https://commons.apache.org/proper/commons-csv) |
-| Apache Commons Daemon |
[commons-daemon](https://github.com/apache/commons-daemon) |
[commons-daemon](https://commons.apache.org/proper/commons-daemon) |
-| Apache Commons DBCP | [commons-dbcp](https://github.com/apache/commons-dbcp)
| [commons-dbcp](https://commons.apache.org/proper/commons-dbcp) |
-| Apache Commons Dbutils |
[commons-dbutils](https://github.com/apache/commons-dbutils) |
[commons-dbutils](https://commons.apache.org/proper/commons-dbutils) |
-| Apache Commons Digester |
[commons-digester](https://github.com/apache/commons-digester) |
[commons-digester](https://commons.apache.org/proper/commons-digester) |
-| Apache Commons Email |
[commons-email](https://github.com/apache/commons-email) |
[commons-email](https://commons.apache.org/proper/commons-email) |
-| Apache Commons Exec | [commons-exec](https://github.com/apache/commons-exec)
| [commons-exec](https://commons.apache.org/proper/commons-exec) |
-| Apache Commons Fileupload |
[commons-fileupload](https://github.com/apache/commons-fileupload) |
[commons-fileupload](https://commons.apache.org/proper/commons-fileupload) |
-| Apache Commons Functor |
[commons-functor](https://github.com/apache/commons-functor) |
[commons-functor](https://commons.apache.org/proper/commons-functor) |
-| Apache Commons Geometry |
[commons-geometry](https://github.com/apache/commons-geometry) |
[commons-geometry](https://commons.apache.org/proper/commons-geometry) |
-| Apache Commons Graph |
[commons-graph](https://github.com/apache/commons-graph) |
[commons-graph](https://commons.apache.org/proper/commons-graph) |
-| Apache Commons Imaging |
[commons-imaging](https://github.com/apache/commons-imaging) |
[commons-imaging](https://commons.apache.org/proper/commons-imaging) |
-| Apache Commons IO | [commons-io](https://github.com/apache/commons-io) |
[commons-io](https://commons.apache.org/proper/commons-io) |
-| Apache Commons JCI | [commons-jci](https://github.com/apache/commons-jci) |
[commons-jci](https://commons.apache.org/proper/commons-jci) |
-| Apache Commons JCS | [commons-jcs](https://github.com/apache/commons-jcs) |
[commons-jcs](https://commons.apache.org/proper/commons-jcs) |
-| Apache Commons Jelly |
[commons-jelly](https://github.com/apache/commons-jelly) |
[commons-jelly](https://commons.apache.org/proper/commons-jelly) |
-| Apache Commons Jexl | [commons-jexl](https://github.com/apache/commons-jexl)
| [commons-jexl](https://commons.apache.org/proper/commons-jexl) |
-| Apache Commons Jxpath |
[commons-jxpath](https://github.com/apache/commons-jxpath) |
[commons-jxpath](https://commons.apache.org/proper/commons-jxpath) |
-| Apache Commons Lang | [commons-lang](https://github.com/apache/commons-lang)
| [commons-lang](https://commons.apache.org/proper/commons-lang) |
-| Apache Commons Logging |
[commons-logging](https://github.com/apache/commons-logging) |
[commons-logging](https://commons.apache.org/proper/commons-logging) |
-| Apache Commons Math | [commons-math](https://github.com/apache/commons-math)
| [commons-math](https://commons.apache.org/proper/commons-math) |
-| Apache Commons Net | [commons-net](https://github.com/apache/commons-net) |
[commons-net](https://commons.apache.org/proper/commons-net) |
-| Apache Commons Numbers |
[commons-numbers](https://github.com/apache/commons-numbers) |
[commons-numbers](https://commons.apache.org/proper/commons-numbers) |
-| Apache Commons Parent |
[commons-parent](https://github.com/apache/commons-parent) |
[commons-parent](https://commons.apache.org/proper/commons-parent) |
-| Apache Commons Pool | [commons-pool](https://github.com/apache/commons-pool)
| [commons-pool](https://commons.apache.org/proper/commons-pool) |
-| Apache Commons Proxy |
[commons-proxy](https://github.com/apache/commons-proxy) |
[commons-proxy](https://commons.apache.org/proper/commons-proxy) |
-| Apache Commons RDF | [commons-rdf](https://github.com/apache/commons-rdf) |
[commons-rdf](https://commons.apache.org/proper/commons-rdf) |
-| Apache Commons Release-plugin |
[commons-release-plugin](https://github.com/apache/commons-release-plugin) |
[commons-release-plugin](https://commons.apache.org/proper/commons-release-plugin)
|
-| Apache Commons Rng | [commons-rng](https://github.com/apache/commons-rng) |
[commons-rng](https://commons.apache.org/proper/commons-rng) |
-| Apache Commons Scxml |
[commons-scxml](https://github.com/apache/commons-scxml) |
[commons-scxml](https://commons.apache.org/proper/commons-scxml) |
-| Apache Commons Signing |
[commons-signing](https://github.com/apache/commons-signing) |
[commons-signing](https://commons.apache.org/proper/commons-signing) |
-| Apache Commons Skin | [commons-skin](https://github.com/apache/commons-skin)
| [commons-skin](https://commons.apache.org/proper/commons-skin) |
-| Apache Commons Statistics |
[commons-statistics](https://github.com/apache/commons-statistics) |
[commons-statistics](https://commons.apache.org/proper/commons-statistics) |
-| Apache Commons Testing |
[commons-testing](https://github.com/apache/commons-testing) |
[commons-testing](https://commons.apache.org/proper/commons-testing) |
-| Apache Commons Text | [commons-text](https://github.com/apache/commons-text)
| [commons-text](https://commons.apache.org/proper/commons-text) |
-| Apache Commons Validator |
[commons-validator](https://github.com/apache/commons-validator) |
[commons-validator](https://commons.apache.org/proper/commons-validator) |
-| Apache Commons VFS | [commons-vfs](https://github.com/apache/commons-vfs) |
[commons-vfs](https://commons.apache.org/proper/commons-vfs) |
-| Apache Commons Weaver |
[commons-weaver](https://github.com/apache/commons-weaver) |
[commons-weaver](https://commons.apache.org/proper/commons-weaver) |
+Please see the [list of components](https://commons.apache.org/components.html)
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 0209ea54..a762e48a 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,5 +1,59 @@
- Apache Commons Net 3.10.0
- RELEASE NOTES
+Apache Commons Net 3.11.0
+Release Notes
+
+The Apache Commons Net team is pleased to announce the release of Apache
Commons Net 3.11.0.
+
+Apache Commons Net library contains a collection of network utilities and
protocol implementations.
+Supported protocols include Echo, Finger, FTP, NNTP, NTP, POP3(S), SMTP(S),
Telnet, and Whois.
+
+
+Maintenance and bug fix release (Java 8 or above).
+
+For complete information on Apache Commons Net, including instructions on how
to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons Net website:
+
+https://commons.apache.org/proper/commons-net/
+
+Download page: https://commons.apache.org/proper/commons-net/download_net.cgi
+
+New features
+------------
+
+o NET-726: Add protected getters to FTPSClient #204. Thanks to PJ Fanning,
Gary Gregory.
+o Add SubnetUtils.toString(). Thanks to Gary Gregory.
+o Add Maven property project.build.outputTimestamp for build
reproducibility. Thanks to Gary Gregory.
+o Add FTP.DEFLATE_TRANSFER_MODE to support the "deflate" compression
format in FTPClient.setFileTransferMode(int). Thanks to Georg Voss, Gary
Gregory.
+o Add org.apache.commons.net.SocketClient.checkOpenOutputStream().
Thanks to Gary Gregory.
+
+Fixed Bugs
+----------
+
+o Precompile regular expression in
UnixFTPEntryParser.preParse(List<String>). Thanks to Gary Gregory.
+o Guard against polynomial regular expression used on uncontrolled
data in VMSVersioningFTPEntryParser.REGEX. Thanks to Gary Gregory.
+o Guard against polynomial regular expression used on uncontrolled
data in IMAPReply.TAGGED_RESPONSE. Thanks to Gary Gregory.
+o Guard against polynomial regular expression used on uncontrolled
data in IMAPReply.UNTAGGED_RESPONSE. Thanks to Gary Gregory.
+o NET-730: Cannot connect to FTP server with HTTP proxy. Thanks to Johannes
Thalmair, Gary Gregory.
+o Base 64 Encoding with URL and Filename Safe Alphabet should not
chunk per RFC 4648. Thanks to Gary Gregory.
+o Deprecate org.apache.commons.net.util.Charsets.Charsets() for
removal. Thanks to Gary Gregory.
+o Deprecate
org.apache.commons.net.util.TrustManagerUtils.TrustManagerUtils() for removal.
Thanks to Gary Gregory.
+
+Changes
+-------
+
+o Bump commons-parent from 62 to 70 #238. Thanks to Dependabot, Gary
Gregory.
+o Bump org.codehaus.mojo:exec-maven-plugin from 3.1.0 to 3.2.0,
#221. Thanks to Dependabot.
+o Bump commons-lang3 from 3.13.0 to 3.14.0. Thanks to Gary Gregory.
+o Bump commons-io from 2.15.0 to 2.16.1 #236, #240. Thanks to Gary
Gregory.
+
+
+Historical list of changes:
https://commons.apache.org/proper/commons-net/changes-report.html
+
+Enjoy!
+-Apache Commons Net team
+
+-----------------------------------------------------------------------------
+Apache Commons Net 3.10.0
+Release Notes
The Apache Commons Net team is pleased to announce the release of Apache
Commons Net 3.10.0.
@@ -16,10 +70,9 @@ https://commons.apache.org/proper/commons-net/
Download page: https://commons.apache.org/proper/commons-net/download_net.cgi
-Changes in this version include:
-===============================
+New features
+------------
-New features:
o Add and use DatagramSocketClient.setDefaultTimeout(Duration) and
deprecate DatagramSocketClient.setDefaultTimeout(int). Thanks to Gary Gregory.
o Add and use TFTP.DEFAULT_TIMEOUT_DURATION and deprecate
org.apache.commons.net.tftp.TFTP.DEFAULT_TIMEOUT. Thanks to Gary Gregory.
o Add and use DatagramSocketClient#getSoTimeoutDuration(). Thanks to
Gary Gregory.
@@ -33,7 +86,9 @@ o Add Base64 missing tests and documentation fixes
#161. Thanks to KuK
o Add FTPFile tests and fix Javadoc typos #162. Thanks to KuKa, Gary
Gregory.
o Add IMAPReply tests and documentation fixes #165. Thanks to KuKa,
Gary Gregory, Bruno P. Kinoshita.
-Fixed Bugs:
+Fixed Bugs
+----------
+
o NET-650: Delegate host resolution to Socket.connect() #138. Thanks to
Matthew McGillis, exceptionfactory, sebbASF.
o Fixes many grammar issues and typos in JavaDoc and code comments
#141. Thanks to Martin Wiesner, Gary Gregory, sebbASF.
o Remove redundant (null) initializations and other clean ups #155.
Thanks to Martin Wiesner, Gary Gregory.
@@ -56,7 +111,9 @@ o Replace use of
org.apache.commons.net.util.Base64 with java.util.Bas
o Replace use of org.apache.commons.net.util.Base64 with
java.util.Base64 in org.apache.commons.net.pop3. Thanks to Gary Gregory.
o Replace use of org.apache.commons.net.util.Base64 with
java.util.Base64 in org.apache.commons.net.smtp. Thanks to Gary Gregory.
-Changes:
+Changes
+-------
+
o Bump commons-parent from 54 to 62 #132, #137, #153. Thanks to
Dependabot.
o Bump commons-io from 2.11.0 to 2.14.0. Thanks to Gary Gregory.
o Bump commons-lang3 from 3.12.0 to 3.13.0. Thanks to Gary Gregory.
@@ -69,8 +126,8 @@ Enjoy!
-----------------------------------------------------------------------------
- Apache Commons Net 3.9.0
- RELEASE NOTES
+Apache Commons Net 3.9.0
+Release Notes
The Apache Commons Net team is pleased to announce the release of Apache
Commons Net 3.9.0.
@@ -87,10 +144,9 @@ https://commons.apache.org/proper/commons-net/
Download page: https://commons.apache.org/proper/commons-net/download_net.cgi
-Changes in this version include:
-===============================
+New features
+------------
-New features:
o [FTP] Add FTPClient.mdtmInstant(String). Thanks to Gary Gregory.
o [FTP] Add MLSxEntryParser.parseGmtInstant(String). Thanks to Gary
Gregory.
o [FTP] Add FTPClient.getControlKeepAliveReplyTimeoutDuration().
Thanks to Gary Gregory.
@@ -102,7 +158,9 @@ o [FTP] Add FTPClient.setDataTimeout(Duration).
Thanks to Gary Gregory
o [FTP] Add FTPFile.getTimestampInstant(). Thanks to Gary Gregory.
o Add github/codeql-action. Thanks to Gary Gregory.
-Fixed Bugs:
+Fixed Bugs
+----------
+
o NET-708: Use yyyy instead of YYYY in SimpleDateFormat #97. Thanks to
XenoAmess.
o Prevent serialization of the 4 classes that implement Serializable.
It is not useful and is unlikely to work properly.
@@ -115,7 +173,9 @@ o Simplify conditions avoiding extra operations
#88. Thanks to Arturo
o Remove reflection from SSLSocketUtils. Thanks to Gary Gregory.
o NET-707: Process files with spaces in name for OS400 #95. Thanks to Dmytro
Sylaiev, sebbASF, Gary Gregory.
-Changes:
+Changes
+-------
+
o Bump actions/cache from 2.1.6 to 3.0.11 #93, #102, #115, #116.
Thanks to Dependabot, Gary Gregory.
o Bump actions/checkout from 2.3.4 to 3.1.0 #89, #91, #100, #114.
Thanks to Dependabot, Gary Gregory.
o Bump actions/upload-artifact from 3.1.0 to 3.1.1 #124. Thanks to
Dependabot.
@@ -136,8 +196,8 @@ Enjoy!
-----------------------------------------------------------------------------
- Apache Commons Net 3.8.0
- RELEASE NOTES
+Apache Commons Net 3.8.0
+Release Notes
The Apache Commons Net team is pleased to announce the release of Apache
Commons Net 3.8.0.
@@ -154,20 +214,23 @@ https://commons.apache.org/proper/commons-net/
Download page: https://commons.apache.org/proper/commons-net/download_net.cgi
-Changes in this version include:
-===============================
+New features
+------------
-New features:
o Add and use NetConstants. Thanks to Arturo Bernal, Gary Gregory.
o Add and use SocketClient.applySocketAttributes(). Thanks to Gary
Gregory.
o Add FTPClient.hasFeature(FTPCmd). Thanks to Gary Gregory.
o Add FTPClient.mdtmCalendar(String). Thanks to Gary Gregory.
-Fixed Bugs:
+Fixed Bugs
+----------
+
o Fix concurrent counting of chunks in IMAPExportMbox. Thanks to
Gary Gregory.
o Fix possible if rare NPEs in tests. Thanks to Gary Gregory.
-Changes:
+Changes
+-------
+
o Bump actions/checkout from v2.3.3 to v2.3.4 #69. Thanks to
Dependabot.
o NET-685: Update SocketClient default connect timeout from ? to 60 seconds
#51. Thanks to Simo385.
o NET-695: Apply SocketClient timeout after connection but before SSL
negotiation. Thanks to Gary Gregory, Possibly Cott.
@@ -182,8 +245,8 @@ Enjoy!
-----------------------------------------------------------------------------
- Apache Commons Net 3.7.2
- RELEASE NOTES
+Apache Commons Net 3.7.2
+Release Notes
The Apache Commons Net team is pleased to announce the release of Apache
Commons Net 3.7.2.
@@ -200,15 +263,16 @@ https://commons.apache.org/proper/commons-net/
Download page: https://commons.apache.org/proper/commons-net/download_net.cgi
-Changes in this version include:
-===============================
+Fixed Bugs
+----------
-Fixed Bugs:
o NET-689: Host name is not set on the SSLSocket causing
isEndpointCheckingEnabled to fail. Thanks to Charlie, Gary Gregory.
o Fix possible socket and input stream leak on socket exception in
org.apache.commons.net.ftp.FTPClient._retrieveFile(String, String,
OutputStream). Thanks to Dependabot.
o NET-690: Performance issue when using the FTPClient to retrieve files #65.
Thanks to payal-meh, Gary Gregory.
-Changes:
+Changes
+-------
+
o NET-691: Improve Javadoc for IMAPSClient #68. Thanks to Lewis John
McGibbney.
o Bump actions/setup-java from v1.4.2 to v1.4.3 #62. Thanks to
Dependabot.
o Bump junit from 4.13 to 4.13.1 #67. Thanks to Dependabot.
@@ -221,8 +285,8 @@ Enjoy!
-----------------------------------------------------------------------------
- Apache Commons Net 3.7.1
- RELEASE NOTES
+Apache Commons Net 3.7.1
+Release Notes
The Apache Commons Net team is pleased to announce the release of Apache
Commons Net 3.7.1
@@ -239,10 +303,9 @@ https://commons.apache.org/proper/commons-net/
Download page: https://commons.apache.org/proper/commons-net/download_net.cgi
-Changes in this version include:
-===============================
+Fixed Bugs
+----------
-Fixed Bugs:
o NET-687: [FTPS] javax.net.ssl.SSLException: Unsupported or unrecognized SSL
message, #59. Thanks to Gary Gregory, Mikael, j-verse.
o NET-673: Update actions/checkout from v2.3.1 to v2.3.3 #56, #61. Thanks to
Dependabot.
o NET-673: Update actions/setup-java from v1.4.0 to v1.4.2 #58. Thanks to
Dependabot.
@@ -255,8 +318,8 @@ Enjoy!
-----------------------------------------------------------------------------
- Apache Commons Net 3.7
- RELEASE NOTES
+Apache Commons Net 3.7
+Release Notes
The Apache Commons Net team is pleased to announce the release of Apache
Commons Net 3.7
@@ -272,7 +335,9 @@ The examples are not part of the public API, so this does
not affect compatibili
Changes in this version include:
-New features:
+New features
+------------
+
o NET-646: ALLO FTP Command for files >2GB
o NET-615: IMAPClient could simplify using empty arguments
o NET-614: IMAP fails to quote/encode mailbox names
@@ -283,7 +348,9 @@ o Add POP3ExportMbox example code
o NET-674: FTPListParseEngine should support listing via MLSD Thanks to Chris
Steingen.
o NET-660: Next and Previous IP Address in SubnetUtils.SubnetInfo Thanks to
Nagabhushan S N.
-Fixed Bugs:
+Fixed Bugs
+----------
+
o NET-673: IMAPClient.APPEND does not always calculate the correct length
o NET-643: NPE when closing telnet stream Thanks to Vasily.
o NET-641: SubnetUtils.SubnetInfo.isInRange("0.0.0.0") returns true for
CIDR/31, 32 Thanks to pin_ptr.
@@ -298,7 +365,9 @@ o NET-663: NullPointerException when FTPClient remote
verification fails Thanks
o NET-649: 227 Entering Passive Mode Thanks to Filipe Bojikian Rissi.
o NET-682: MVSFTPEntryParser doesn't support Record Formats of U Thanks to
richard.
-Changes:
+Changes
+-------
+
o NET-633: Add XOAUTH2 to IMAP and SMTP Thanks to n0rm1e.
o NET-632: FTPHTTPClient - support for encoding other than UTF-8 Thanks to
prakapenka.
o NET-626: SubnetUtils#SubnetUtils - improved comment Thanks to Makoto
Sakaguchi.
@@ -317,3 +386,5 @@ patches, or suggestions for improvement, see the Apache
Commons Net website:
https://commons.apache.org/proper/commons-net/
Download page: https://commons.apache.org/proper/commons-net/download_net.cgi
+
+-----------------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 39799983..6d958ec4 100644
--- a/pom.xml
+++ b/pom.xml
@@ -51,7 +51,8 @@ Supported protocols include Echo, Finger, FTP, NNTP, NTP,
POP3(S), SMTP(S), Teln
<checkstyle.configdir>src/conf</checkstyle.configdir>
<spotbugs.configdir>src/conf</spotbugs.configdir>
<!-- Current release -->
- <commons.release.versionBump>3.11.0</commons.release.versionBump>
+ <commons.release.version>3.11.0</commons.release.version>
+ <commons.release.next>3.11.1</commons.release.next>
<commons.rc.version>RC1</commons.rc.version>
<commons.release.desc>(Requires Java ${maven.compiler.target} or
later)</commons.release.desc>
<project.build.outputTimestamp>2024-01-01T00:00:00Z</project.build.outputTimestamp>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 93921bea..03d30c9d 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -64,7 +64,7 @@ The <action> type attribute can be add,update,fix,remove.
-->
<body>
- <release version="3.11.0" date="YYYY-MM-DD" description="Maintenance and
bug fix release (Java 8 or above).">
+ <release version="3.11.0" date="2024-05-28" description="Maintenance and
bug fix release (Java 8 or above).">
<!-- FIX -->
<action type="fix" dev="ggregory" due-to="Gary Gregory">Precompile
regular expression in UnixFTPEntryParser.preParse(List<String>).</action>
<action type="fix" dev="ggregory" due-to="Gary Gregory">Guard against
polynomial regular expression used on uncontrolled data in
VMSVersioningFTPEntryParser.REGEX.</action>
diff --git a/src/changes/release-notes.vm b/src/changes/release-notes.vm
index ab86526d..fb9b92e6 100644
--- a/src/changes/release-notes.vm
+++ b/src/changes/release-notes.vm
@@ -15,8 +15,8 @@
## specific language governing permissions and limitations
## under the License.
##
- ${project.name} ${version}
- RELEASE NOTES
+${project.name} ${version}
+Release Notes
The ${developmentTeam} is pleased to announce the release of ${project.name}
${version}.
@@ -87,11 +87,11 @@ o $issue ${action}$dueto
#if ($release.getActions().size() == 0)
No changes defined in this version.
#else
-Changes in this version include:
-===============================
#if ($release.getActions('add').size() !=0)
-New features:
+New features
+------------
+
#foreach($actionItem in $release.getActions('add'))
#processaction()
#end
@@ -99,7 +99,9 @@ New features:
#end
##
#if ($release.getActions('fix').size() !=0)
-Fixed Bugs:
+Fixed Bugs
+----------
+
#foreach($actionItem in $release.getActions('fix'))
#processaction()
#end
@@ -107,7 +109,9 @@ Fixed Bugs:
#end
##
#if ($release.getActions('update').size() !=0)
-Changes:
+Changes
+-------
+
#foreach($actionItem in $release.getActions('update'))
#processaction()
#end
@@ -115,7 +119,9 @@ Changes:
#end
##
#if ($release.getActions('remove').size() !=0)
-Removed:
+Removed
+-------
+
#foreach($actionItem in $release.getActions('remove'))
#processaction()
#end
diff --git a/src/site/xdoc/download_net.xml b/src/site/xdoc/download_net.xml
index 7e95bf08..f71220d5 100644
--- a/src/site/xdoc/download_net.xml
+++ b/src/site/xdoc/download_net.xml
@@ -113,32 +113,32 @@ limitations under the License.
</p>
</subsection>
</section>
- <section name="Apache Commons Net 3.10.0 (Requires Java 8 or later)">
+ <section name="Apache Commons Net 3.11.0 (Requires Java 1.8 or later)">
<subsection name="Binaries">
<table>
<tr>
- <td><a
href="[preferred]/commons/net/binaries/commons-net-3.10.0-bin.tar.gz">commons-net-3.10.0-bin.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/net/binaries/commons-net-3.10.0-bin.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/net/binaries/commons-net-3.10.0-bin.tar.gz.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/net/binaries/commons-net-3.11.0-bin.tar.gz">commons-net-3.11.0-bin.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/net/binaries/commons-net-3.11.0-bin.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/net/binaries/commons-net-3.11.0-bin.tar.gz.asc";>pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/net/binaries/commons-net-3.10.0-bin.zip">commons-net-3.10.0-bin.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/net/binaries/commons-net-3.10.0-bin.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/net/binaries/commons-net-3.10.0-bin.zip.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/net/binaries/commons-net-3.11.0-bin.zip">commons-net-3.11.0-bin.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/net/binaries/commons-net-3.11.0-bin.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/net/binaries/commons-net-3.11.0-bin.zip.asc";>pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a
href="[preferred]/commons/net/source/commons-net-3.10.0-src.tar.gz">commons-net-3.10.0-src.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/net/source/commons-net-3.10.0-src.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/net/source/commons-net-3.10.0-src.tar.gz.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/net/source/commons-net-3.11.0-src.tar.gz">commons-net-3.11.0-src.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/net/source/commons-net-3.11.0-src.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/net/source/commons-net-3.11.0-src.tar.gz.asc";>pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/net/source/commons-net-3.10.0-src.zip">commons-net-3.10.0-src.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/net/source/commons-net-3.10.0-src.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/net/source/commons-net-3.10.0-src.zip.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/net/source/commons-net-3.11.0-src.zip">commons-net-3.11.0-src.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/net/source/commons-net-3.11.0-src.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/net/source/commons-net-3.11.0-src.zip.asc";>pgp</a></td>
</tr>
</table>
</subsection>
diff --git a/src/site/xdoc/mail-lists.xml b/src/site/xdoc/mail-lists.xml
index a5694869..58eefbd4 100644
--- a/src/site/xdoc/mail-lists.xml
+++ b/src/site/xdoc/mail-lists.xml
@@ -59,9 +59,9 @@ limitations under the License.
</p>
<p>
Questions related to the usage of Apache Commons Net should be posted
to the
- <a href="https://mail-archives.apache.org/mod_mbox/commons-user/";>User
List</a>.
+ <a
href="https://lists.apache.org/list.html?u...@commons.apache.org";>User List</a>.
<br />
- The <a
href="https://mail-archives.apache.org/mod_mbox/commons-dev/";>Developer List</a>
+ The <a
href="https://lists.apache.org/list.html?d...@commons.apache.org";>Developer
List</a>
is for questions and discussion related to the development of Apache
Commons Net.
<br />
Please do not cross-post; developers are also subscribed to the user
list.
@@ -70,8 +70,10 @@ limitations under the License.
to subscribe.
</p>
<p>
- <strong>Note:</strong> please don't send patches or attachments to any
of the mailing lists.
+ <strong>Note:</strong> please don't send patches or attachments to any
of the mailing lists;
+ most of the lists are set up to drop attachments.
Patches are best handled via the <a href="issue-tracking.html">Issue
Tracking</a> system.
+ If you have a GitHub account, most components also accept PRs (pull
requests).
Otherwise, please upload the file to a public server and include the
URL in the mail.
</p>
</section>
@@ -105,12 +107,11 @@ limitations under the License.
<td><a
href="mailto:user-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:user-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
<td><a
href="mailto:u...@commons.apache.org?subject=[net]";>Post</a></td>
- <td><a
href="https://mail-archives.apache.org/mod_mbox/commons-user/";>mail-archives.apache.org</a><br
/>
+ <td>
<a
href="https://lists.apache.org/list.html?u...@commons.apache.org";>lists.apache.org</a>
</td>
- <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>
+ <a
href="https://www.mail-archive.com/user@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -125,12 +126,11 @@ limitations under the License.
<td><a
href="mailto:dev-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:dev-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
<td><a
href="mailto:d...@commons.apache.org?subject=[net]";>Post</a></td>
- <td><a
href="https://mail-archives.apache.org/mod_mbox/commons-dev/";>mail-archives.apache.org</a><br
/>
+ <td>
<a
href="https://lists.apache.org/list.html?d...@commons.apache.org";>lists.apache.org</a>
</td>
- <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>
+ <a
href="https://www.mail-archive.com/dev@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -145,10 +145,10 @@ limitations under the License.
<td><a
href="mailto:issues-subscr...@commons.apache.org";>Subscribe</a></td>
<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><br
/>
+ <td>
<a
href="https://lists.apache.org/list.html?iss...@commons.apache.org";>lists.apache.org</a>
</td>
- <td><a
href="https://markmail.org/list/org.apache.commons.issues/";>markmail.org</a><br
/>
+ <td>
<a
href="https://www.mail-archive.com/issues@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -164,10 +164,10 @@ limitations under the License.
<td><a
href="mailto:commits-subscr...@commons.apache.org";>Subscribe</a></td>
<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><br
/>
+ <td>
<a
href="https://lists.apache.org/list.html?commits@commons.apache.org";>lists.apache.org</a>
</td>
- <td><a
href="https://markmail.org/list/org.apache.commons.commits/";>markmail.org</a><br
/>
+ <td>
<a
href="https://www.mail-archive.com/commits@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -199,13 +199,11 @@ limitations under the License.
<td><a class="externalLink"
href="mailto:announce-subscr...@apache.org";>Subscribe</a></td>
<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><br
/>
+ <td>
<a class="externalLink"
href="https://lists.apache.org/list.html?annou...@apache.org";>lists.apache.org</a>
</td>
- <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>
+ <a class="externalLink"
href="https://www.mail-archive.com/announce@apache.org/";>www.mail-archive.com</a>
</td>
</tr>
</table>
