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 2011/04/04 01:53:26 UTC

svn commit: r1088445 - in /commons/proper/net/trunk: RELEASE-NOTES.txt src/changes/changes.xml

Author: sebb
Date: Sun Apr  3 23:53:26 2011
New Revision: 1088445

URL: http://svn.apache.org/viewvc?rev=1088445&view=rev
Log:
Make a start on RN summary

Modified:
    commons/proper/net/trunk/RELEASE-NOTES.txt
    commons/proper/net/trunk/src/changes/changes.xml

Modified: commons/proper/net/trunk/RELEASE-NOTES.txt
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/RELEASE-NOTES.txt?rev=1088445&r1=1088444&r2=1088445&view=diff
==============================================================================
--- commons/proper/net/trunk/RELEASE-NOTES.txt (original)
+++ commons/proper/net/trunk/RELEASE-NOTES.txt Sun Apr  3 23:53:26 2011
@@ -1,13 +1,43 @@
 
               Apache Commons Net 3.0-SNAPSHOT RELEASE NOTES
 
-TBA
+The Commons Net team is pleased to announce the release of commons-net-3.0-SNAPSHOT
+  
+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 release fixes many bugs (see below), and adds new functionality:
+ - basic support for IMAP and IMAPS
+ - support for SMTPS and POP3S
+
+
+This release is binary-compatible with 2.2, but there are some minor changes to source compatibility:
+ - telnet.TelnetClient#addOptionHandler(TelnetOptionHandler) now additionally throws IOException
+ - telnet.TelnetClient#deleteOptionHandler() now additionally throws IOException
+ - ftp.FTPSClient ctors no longer throw NoSuchAlgorithmException
+ All users are recommended to upgrade.
 
 Changes in this version include:
 
 New features:
+o NET-333:  would you provide a class used for imap protocol? Thanks to Bogdan Drozdowski. 
+o NET-326:  A KeyManager is required when the protection level is set to 'P' with FTPSClient on active mode.
+            Added KeyManagerUtils class to simplify provision of client certificates. 
+o NET-273:  FEAT response parsing. Added FTPClient methods: boolean hasFeature(feature [,option]),
+            String fetaureValue(feature), String[] featureValues(feature) 
+o NET-379:  FTPClient - support for processing arbitrary commands that only use the control channel 
+o NET-378:  FTP listing should support MLST and MLSD. 
+o NET-372:  FTPSClient: java.security.cert.CertificateException: No X509TrustManager implementation available if trustManager == null 
+o NET-371:  Create TrustManagerFactory to provide custom TrustManagers. 
+o NET-327:  "Unconnected sockets not implemented" when using FTPSClient
+            Added disconnect() override which resets the socket factories to their defaults Thanks to Bogdan Drozdowski. 
+o NET-350:  "java.net.SocketException: Broken pipe" when calling "TelnetClient.sendAYT()"
+            Added SocketClient#isAvailable() method to perform additional checks on a socket. Thanks to Bogdan Drozdowski. 
+o NET-237:  Add streaming methods (corresponding to array methods) to NNTPClient. 
+o NET-314:  The FTP client should autodetect the control encoding. Thanks to Bogdan Drozdowski. 
 o NET-361:  Implement Telnet Command sender. 
 o NET-343:  Telnet client: Support Client-initiated Subnegotiation Messages. Thanks to Archie Cobbs. 
+o NET-344:  Telnet client: Support Listener Notification of Incoming Data. Thanks to Archie Cobbs. 
 o NET-352:  SASL PLAIN and CRAM-MD5 authentication. Thanks to Bogdan Drozdowski. 
 o NET-357:  The POP3 client does not support SSL/TLS connections. Thanks to Bogdan Drozdowski. 
 o NET-229:  Use properties file to handle new OS-type auto-detection. 
@@ -22,6 +52,23 @@ o NET-351:  APOP authentication fails mo
             Fix by adding leading 0 if necessary. Thanks to Bogdan Drozdowski. 
 
 Fixed Bugs:
+o NET-268:  Better handling of CIDR/31 and CIDR/32 where isInclusive = false.
+            Return 0 for address count, and 0.0.0.0 for each of the addresses 
+o NET-389:  Unix parser should ignore "total nnn" lines. 
+o NET-367:  ntp.TimeStamp uses incorrect lazy initialisation of static fields simpleFormatter and utcFormatter. 
+o NET-388:  VMSVersioningFTPEntryParser#preParse should not call super.preParse(). 
+o NET-362:  TelnetInputStream has various threading bugs. 
+o NET-89:  TelnetClient use of FromNetASCIIInputStream and ToNetASCIIOutputStream breaks binary mode.
+            See also NET-387. 
+o NET-354:  FTPSClient not properly supporting CCC and PROT P. Thanks to Leif John Korshavn. 
+o NET-365:  FTPClient.listFiles() does not work properly, if remote server speaks German.
+            Match non-space{3} instead of A-Za-z{3} 
+o NET-366:  FTPClientConfig: setServerLanguageCode and setShortMonthNames do not work.
+            Ensure that config is passed to all parsers that can use it. 
+o NET-276:  NNTPClient has problems with group listings for large groups. 
+o NET-185:  Possible NPE in Threader.java 
+o NET-364:  nntp.Article is very inefficient and incorrect. 
+o NET-363:  Can't connect to a server behind firewall in passive mode. Thanks to daniel damon. 
 o NET-348:  Queue is full TelnetInputStream. 
 o NET-345:  Telnet client: not properly handling IAC bytes within subnegotiation messages:
             - failing to double IACs on output
@@ -38,8 +85,33 @@ o NET-360:  DefaultFTPFileEntryParserFac
 o NET-359:  CopyStreamAdapter unconditionally resets the CopyStreamEvent source and is inefficient. 
 o NET-355:  examples.nntp.NNTPUtils does not compile 
 
+Changes:
+o NET-269:  Remove semi-redundant check in SubnetUtils.calculate(). 
+o NET-396:  POP3.setState() should not be public.
+            Deprecated, and changed to do nothing. Added package-private method for use by POP3 classes. 
+o NET-219:  Should Telnet class Exception blocks write to System.err?
+            Catch blocks removed, and throws clauses added to allow caller to more easily detect and recover. 
+o NET-397:  FTPSClient does not handle AUTH or ADAT and only partially handles PBSZ. FTPSCommand should be deprecated. Thanks to Bogdan Drozdowski. 
+o NET-395:  Move ProtocolCommandSupport to SocketClient. 
+o NET-393:  Should the sendCommandWithID() methods be public?
+            Made methods private, and deleted currently unused ones. 
+o NET-394:  Are the sendUntaggedCommand() methods needed?
+            Renamed the method as sendData(), as it's not a command. 
+o NET-392:  Use enum for IMAPCommand. 
+o NET-390:  FTPFile.toString() should return formatted version of its fields, not the unformatted original 
+o NET-381:  Parsing is inefficient, as it parses everything twice. 
+o NET-385:  FTP does not apply timeout to initial responses. 
+o NET-384:  KeyManagerUtils - the KeyManager is not efficient. 
+o NET-383:  KeyManagerUtils - allow alias to be omitted when there is only one private key in the store 
+o NET-377:  NLST does not take notice of HiddenFiles setting. 
+o NET-373:  NNTP Listgroups not working - broken server implementation. 
+o NET-375:  DotTerminatedMessageReader should extend BufferedReader, rather than Reader. 
+o NET-374:  ParserInitializationException doesn't use standard JDK exception chaining 
+o NET-368:  Threader.thread should accept an Iterable rather than a List. 
 
 Removed:
+o NET-369:  Article.addHeaderField() is currently write-only - there is no way to retrieve the headers - is it needed?
+            Method was removed, along with the field. 
 o           Removed deprecated unused fields from FTPSClient:
             - KEYSTORE_ALGORITHM, PROVIDER, STORE_TYPE, TRUSTSTORE_ALGORITHM
             Removed deprecated methods FTPClient.getSystemName(), FTPListParseEngine.readServerList(InputStream stream),

Modified: commons/proper/net/trunk/src/changes/changes.xml
URL: http://svn.apache.org/viewvc/commons/proper/net/trunk/src/changes/changes.xml?rev=1088445&r1=1088444&r2=1088445&view=diff
==============================================================================
--- commons/proper/net/trunk/src/changes/changes.xml (original)
+++ commons/proper/net/trunk/src/changes/changes.xml Sun Apr  3 23:53:26 2011
@@ -56,7 +56,17 @@ The <action> type attribute can be add,u
      -->
 
     <body>
-        <release version="3.0" date="TBA" description="TBA">
+        <release version="3.0" date="TBA" description="
+This release fixes many bugs (see below), and adds new functionality:
+  - basic support for IMAP and IMAPS
+  - support for SMTPS and POP3S
+    
+This release is binary-compatible with 2.2, but there are some minor changes to source compatibility:
+  - telnet.TelnetClient#addOptionHandler(TelnetOptionHandler) now additionally throws IOException
+  - telnet.TelnetClient#deleteOptionHandler() now additionally throws IOException
+  - ftp.FTPSClient ctors no longer throw NoSuchAlgorithmException
+  All users are recommended to upgrade.
+">
             <action issue="NET-269" dev="sebb" type="update">
             Remove semi-redundant check in SubnetUtils.calculate().
             </action>