You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by se...@apache.org on 2020/08/01 16:49:58 UTC

[commons-net] 01/01: Update version and associated files for 3.7

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

sebb pushed a commit to branch NET_3_7_RC1
in repository https://gitbox.apache.org/repos/asf/commons-net.git

commit 53e06985186513fcf32bafba09bb7e3fb5bc6871
Author: Sebb <se...@apache.org>
AuthorDate: Sat Aug 1 17:49:25 2020 +0100

    Update version and associated files for 3.7
---
 README.md                      | 10 +++---
 RELEASE-NOTES.txt              | 77 ++++++++++++++++++++++--------------------
 pom.xml                        |  2 +-
 src/site/xdoc/download_net.xml | 30 ++++++++--------
 4 files changed, 62 insertions(+), 57 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
 ===================
 
-[![Build Status](https://travis-ci.org/apache/commons-net.svg?branch=master)](https://travis-ci.org/apache/commons-net)
-[![Coverage Status](https://coveralls.io/repos/apache/commons-net/badge.svg?branch=master)](https://coveralls.io/r/apache/commons-net)
+[![Build Status](https://travis-ci.org/apache/commons-net.svg)](https://travis-ci.org/apache/commons-net)
+[![Coverage Status](https://coveralls.io/repos/apache/commons-net/badge.svg)](https://coveralls.io/r/apache/commons-net)
 [![Maven Central](https://maven-badges.herokuapp.com/maven-central/commons-net/commons-net/badge.svg)](https://maven-badges.herokuapp.com/maven-central/commons-net/commons-net/)
-[![License](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)
+[![Javadocs](https://javadoc.io/badge/commons-net/commons-net/3.6.svg)](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 6109a75..4716b70 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
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>