This is an automated email from the ASF dual-hosted git repository. sebb pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-net.git
commit 595bbea7b2aefb9b4c97e69cdb04329a7b9eea19 Author: Sebb <s...@apache.org> AuthorDate: Wed Aug 5 23:40:06 2020 +0100 Merge tag 'refs/tags/NET_3_7' Create Commons NET 3.7 tag from NET_3_7_RC2 --- README.md | 10 +++--- RELEASE-NOTES.txt | 77 ++++++++++++++++++++++-------------------- pom.xml | 6 ++-- src/changes/changes.xml | 2 +- src/site/xdoc/download_net.xml | 30 ++++++++-------- 5 files changed, 65 insertions(+), 60 deletions(-) diff --git a/README.md b/README.md index 15f0f7b..dab1518 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | +======================================================================+ | | - | 1) Re-generate using: mvn commons:readme-md | + | 1) Re-generate using: mvn commons-build:readme-md | | | | 2) Set the following properties in the component's pom: | | - commons.componentid (required, alphabetic, lower case) | @@ -43,10 +43,10 @@ Apache Commons Net =================== -[](https://travis-ci.org/apache/commons-net) -[](https://coveralls.io/r/apache/commons-net) +[](https://travis-ci.org/apache/commons-net) +[](https://coveralls.io/r/apache/commons-net) [](https://maven-badges.herokuapp.com/maven-central/commons-net/commons-net/) -[](http://www.apache.org/licenses/LICENSE-2.0.html) +[](https://javadoc.io/doc/commons-net/commons-net/3.6) 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 @@ -55,7 +55,7 @@ Documentation ------------- More information can be found on the [Apache Commons Net homepage](https://commons.apache.org/proper/commons-net). -The [JavaDoc](https://commons.apache.org/proper/commons-net/javadocs/api-release) can be browsed. +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][ml]. Where can I get the latest release? diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index d5dc8ff..207e8ca 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,54 +1,55 @@ - Apache Commons Net 3.6 + Apache Commons Net 3.7 RELEASE NOTES -The Apache Commons Net team is pleased to announce the release of Apache Commons Net 3.6 +The Apache Commons Net team is pleased to announce the release of Apache Commons Net 3.7 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 This is mainly a bug-fix release. See further details below. - -This release is binary compatible with previous releases. + This release requires a minimum of Java 7. + This release is binary compatible with previous releases. However it is not source compatible with releases before 3.4, as some methods were added to the interface NtpV3Packet in 3.4 - -The code now requires a minimum of Java 1.6. - -Changes to functionality: -* The FTP client now performs stricter checks on non-multiline command replies. - The 3 digit code must now be followed by a space and some text, as per RFC 959. - To suppress this stricter checking, call FTP#setStrictReplyParsing(false). This should not be needed with a well-behaved server. - Note also that if strict checking is disabled, some functions may unconditionally strip the next character after the code, without checking it if is a space. -* The FTP client mlistFile() method now checks for a leading space before removing it. - If the space is missing, a MalformedServerReplyException is thrown. - This will only happen if the FTP server is not compliant with RFC 3659. - -Notable additions: -* The POP3Mail examples can now get password from console, stdin or an environment variable. -* TFTPClient code has been rewritten to improve error handling and retries. + Note that the examples packages were moved under org/apache/commons/net/examples. +The examples are not part of the public API, so this does not affect compatibility. Changes in this version include: +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 +o NET-648: Add Automatic-Module-Name MANIFEST entry for Java 9 compatibility +o NET-638: Telnet subnegotiations hard-limited to 512 bytes - allow override Thanks to Daniel Leong. +o NET-634: Add SIZE command support Thanks to Mauro Molinari. +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: -o NET-613: TFTPClient assumes that lastBlock == 0 only once -o NET-320: Allow TFTPServer.java to bind to a specific network adapter Thanks to Kevin Bulebush. -o NET-414: Apache Commons TFTP does not reject request replies that originate from a control port. Thanks to Chuck Wolber. -o NET-477: TFTP sendFile retry broken Thanks to John Walton. -o NET-596: NullPointerException when disconnecting TelnetClient twice with JDK 7 Thanks to Vincent Bories-Azeau. -o NET-602: Failure to parse times from SYST_L8 systems that report as "WINDOWS Type: L8" Thanks to Ross Braithwaite. -o NET-604: TFTP send and receive don't have progress indication Thanks to Frank Delporte. -o NET-588: FTPClient.setPassiveNatWorkaround assumes host is outside site local range Thanks to Dave Nice / Thai H. -o NET-610: FTPClient.mlistFile incorrectly handles MLST reply Thanks to Sergey Yanzin. -o NET-611: FTP does not validate command reply syntax fully -o NET-609: DefaultUnixFTPFileEntryParserFactory Issue (leading spaces removal configuration) Thanks to Tqup3. -o NET-597: FTP fails to parse listings for Solaris 10 FTPd in Japanese Thanks to Hiroki Taniura. -o NET-593: HostnameVerifier is called with ip addess instead of the provided hostname Thanks to J�rg Weule. -o NET-594: TelnetClient._closeOutputStream unhandled exception from FilterOutputStream.close Thanks to Brad Worrral. -o NET-592: plainSocket in FTPSClient is never closed Thanks to Mark Ford. +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. +o NET-639: MVSFTPEntryParser.preParse - MVS, z/OS - allow for merged Ext/Used fields Thanks to Alexander Eller. +o NET-636: examples should be in org.apache.commons.net subpackage +o NET-631: Bug in MVSFTPEntryParser.parseUnixList (FindBugs) +o NET-584: Error when using org.apache.commons.net.ftp.FTPClient setControlKeepAliveTimeout Thanks to Kazantsev Andrey Sergeevich/Nick Manley. +o NET-624: SubnetInfo#toCidrNotation: A wrong format subnet mask is allowed Thanks to Makoto Sakaguchi. +o NET-623: SubnetUtils - fixed spelling errors Thanks to Makoto Sakaguchi. +o NET-613: System Information Leak in ftp parser Thanks to Donald Kwakkel. +o NET-663: NullPointerException when FTPClient remote verification fails Thanks to Max Shenfield. +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: -o NET-612: Allow TFTP socket IO tracing -o POP3Mail example: support host port; allow reading password from Console/stdin/environment -o NET-599: Add shorthand FTPClientConfig constructor +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. +o NET-625: SubnetUtils - improve construction +o NET-624: SubnetInfo#getCidrSignature - improve functions Thanks to Makoto Sakaguchi. +o NET-621: SubnetUtils#SubnetInfo - remove unnecessary accessors Thanks to Makoto Sakaguchi. +o NET-619: SubnetUtils - improve binary netmask algorithm Thanks to Makoto Sakaguchi. +o NET-678: VMS ftp LIST parsing results in empty file list Thanks to Roman Grigoriadi. Historical list of changes: https://commons.apache.org/proper/commons-net/changes-report.html @@ -57,3 +58,5 @@ For complete information on Apache Commons Net, including instructions on how to patches, or suggestions for improvement, see the Apache 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 9090f38..a039534 100644 --- a/pom.xml +++ b/pom.xml @@ -28,7 +28,7 @@ <groupId>commons-net</groupId> <artifactId>commons-net</artifactId> - <version>3.7-SNAPSHOT</version> + <version>3.7</version> <name>Apache Commons Net</name> <!-- N.B. the description content is deliberately not indented ! to improve the layout of the Release Notes generated by mvn changes:announcement-generate @@ -54,8 +54,8 @@ Supported protocols include: Echo, Finger, FTP, NNTP, NTP, POP3(S), SMTP(S), Tel <commons.scmPubUrl>https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-net</commons.scmPubUrl> <!-- Current release --> - <commons.release.version>3.6</commons.release.version> - <commons.rc.version>RC1</commons.rc.version> + <commons.release.version>3.7</commons.release.version> + <commons.rc.version>RC2</commons.rc.version> <commons.release.desc>(Requires Java ${maven.compiler.target} or later)</commons.release.desc> <!-- Release plugin defines --> diff --git a/src/changes/changes.xml b/src/changes/changes.xml index af19c39..d7a6630 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -63,7 +63,7 @@ The <action> type attribute can be add,update,fix,remove. --> <body> - <release version="3.7" date="TBA" description=" + <release version="3.7" date="2020-08-05" description=" This is mainly a bug-fix release. See further details below. This release requires a minimum of Java 7. diff --git a/src/site/xdoc/download_net.xml b/src/site/xdoc/download_net.xml index 2ecc3f4..21d9ce2 100644 --- a/src/site/xdoc/download_net.xml +++ b/src/site/xdoc/download_net.xml @@ -26,22 +26,24 @@ limitations under the License. | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | +======================================================================+ | | - | 1) Re-generate using: mvn commons:download-page | + | 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.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.2/3.version (conditional) | - | - commons.release.2/3.name (conditional) | - | - commons.release.2/3.binary.suffix (optional) | - | - commons.release.2/3.desc (optional) | - | - commons.release.2/3.subdir (optional) | + | - 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: | @@ -64,7 +66,7 @@ limitations under the License. <subsection name="Using a Mirror"> <p> We recommend you use a mirror to download our release - builds, but you <strong>must</strong> <a href="http://www.apache.org/info/verification.html">verify the integrity</a> of + builds, but you <strong>must</strong> <a href="https://www.apache.org/info/verification.html">verify the integrity</a> of the downloaded files using signatures downloaded from our main distribution directories. Recent releases (48 hours) may not yet be available from all the mirrors. @@ -102,7 +104,7 @@ limitations under the License. It is essential that you <a href="https://www.apache.org/info/verification.html">verify the integrity</a> of downloaded files, preferably using the <code>PGP</code> signature (<code>*.asc</code> files); - failing that using the <code>SHA256</code> hash (<code>*.sha256</code> checksum files). + failing that using the <code>SHA512</code> hash (<code>*.sha512</code> checksum files). </p> <p> The <a href="https://www.apache.org/dist/commons/KEYS">KEYS</a> @@ -111,17 +113,17 @@ limitations under the License. </p> </subsection> </section> - <section name="Apache Commons Net 3.6 (Requires Java 1.6 or later)"> + <section name="Apache Commons Net 3.6 (Requires Java 1.7 or later)"> <subsection name="Binaries"> <table> <tr> <td><a href="[preferred]/commons/net/binaries/commons-net-3.6-bin.tar.gz">commons-net-3.6-bin.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/net/binaries/commons-net-3.6-bin.tar.gz.sha256">sha256</a></td> + <td><a href="https://www.apache.org/dist/commons/net/binaries/commons-net-3.6-bin.tar.gz.sha512">sha512</a></td> <td><a href="https://www.apache.org/dist/commons/net/binaries/commons-net-3.6-bin.tar.gz.asc">pgp</a></td> </tr> <tr> <td><a href="[preferred]/commons/net/binaries/commons-net-3.6-bin.zip">commons-net-3.6-bin.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/net/binaries/commons-net-3.6-bin.zip.sha256">sha256</a></td> + <td><a href="https://www.apache.org/dist/commons/net/binaries/commons-net-3.6-bin.zip.sha512">sha512</a></td> <td><a href="https://www.apache.org/dist/commons/net/binaries/commons-net-3.6-bin.zip.asc">pgp</a></td> </tr> </table> @@ -130,12 +132,12 @@ limitations under the License. <table> <tr> <td><a href="[preferred]/commons/net/source/commons-net-3.6-src.tar.gz">commons-net-3.6-src.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/net/source/commons-net-3.6-src.tar.gz.sha256">sha256</a></td> + <td><a href="https://www.apache.org/dist/commons/net/source/commons-net-3.6-src.tar.gz.sha512">sha512</a></td> <td><a href="https://www.apache.org/dist/commons/net/source/commons-net-3.6-src.tar.gz.asc">pgp</a></td> </tr> <tr> <td><a href="[preferred]/commons/net/source/commons-net-3.6-src.zip">commons-net-3.6-src.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/net/source/commons-net-3.6-src.zip.sha256">sha256</a></td> + <td><a href="https://www.apache.org/dist/commons/net/source/commons-net-3.6-src.zip.sha512">sha512</a></td> <td><a href="https://www.apache.org/dist/commons/net/source/commons-net-3.6-src.zip.asc">pgp</a></td> </tr> </table>