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>