You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ni...@apache.org on 2010/12/23 04:32:59 UTC
svn commit: r1052167 - in /commons/proper/io/trunk: RELEASE-NOTES.txt
build.xml pom.xml src/site/site.xml src/site/xdoc/building.xml
src/site/xdoc/download_io.xml src/site/xdoc/index.xml
src/site/xdoc/upgradeto2_0_1.xml
Author: niallp
Date: Thu Dec 23 03:32:58 2010
New Revision: 1052167
URL: http://svn.apache.org/viewvc?rev=1052167&view=rev
Log:
prepare for IO 2.0.1 release
Added:
commons/proper/io/trunk/src/site/xdoc/upgradeto2_0_1.xml (with props)
Modified:
commons/proper/io/trunk/RELEASE-NOTES.txt
commons/proper/io/trunk/build.xml
commons/proper/io/trunk/pom.xml
commons/proper/io/trunk/src/site/site.xml
commons/proper/io/trunk/src/site/xdoc/building.xml
commons/proper/io/trunk/src/site/xdoc/download_io.xml
commons/proper/io/trunk/src/site/xdoc/index.xml
Modified: commons/proper/io/trunk/RELEASE-NOTES.txt
URL: http://svn.apache.org/viewvc/commons/proper/io/trunk/RELEASE-NOTES.txt?rev=1052167&r1=1052166&r2=1052167&view=diff
==============================================================================
--- commons/proper/io/trunk/RELEASE-NOTES.txt (original)
+++ commons/proper/io/trunk/RELEASE-NOTES.txt Thu Dec 23 03:32:58 2010
@@ -1,7 +1,7 @@
$Id$
Commons IO Package
- Version 2.0
+ Version 2.0.1
Release Notes
@@ -15,8 +15,8 @@ Commons IO contains utility classes, str
file comparators and endian transformation classes.
-Compatibility with 1.4
-----------------------
+Compatibility with 2.0 and 1.4
+------------------------------
Binary compatible - Yes
Source compatible - Yes
@@ -24,112 +24,21 @@ Source compatible - Yes
Semantic compatible - Yes
Check the bug fixes section for semantic bug fixes
-Commons IO 2.0 requires a minimum of JDK 1.5
+Commons IO 2.0.1 requires a minimum of JDK 1.5
(Commons IO 1.4 had a minimum of JDK 1.3)
-Deprecations from 1.4
+Enhancements from 2.0
---------------------
-- IOUtils
- - write(StringBuffer, Writer) in favour of write(CharSequence, Writer)
- - write(StringBuffer, OutputStream) in favour of write(CharSequence, OutputStream)
- - write(StringBuffer, OutputStream, String) in favour of write(CharSequence, OutputStream, String)
-
-- FileFilterUtils
- - andFileFilter(IOFileFilter, IOFileFilter) in favour of and(IOFileFilter...)
- - orFileFilter(IOFileFilter, IOFileFilter) in favour of or(IOFileFilter...)
-
-
-Enhancements from 1.4
----------------------
+ * [IO-256] - Provide thread factory for FileAlternationMonitor
- * [IO-140] Move minimum Java requirement from JDK 1.3 to JDK 1.5
- - use Generics
- - add new CharSequence write() flavour methods to IOUtils and FileUtils
- - replace StringBuffer with StringBuilder, where appropriate
- - add new Reader/Writer methods to ProxyReader and ProxyWriter
- - Annotate with @Override and @Deprecated
-
- * [IO-178] New BOMInputStream and ByteOrderMark implementations - to detect and optionally exclude an initial Byte Order mark (BOM)
- * [IO-197] New BoundedInputStream (copied from from Apache JackRabbit)
- * [IO-193] New Broken Input and Output streams
- * [IO-132] New File Listener/Monitor facility
- * [IO-158] New ReaderInputStream and WriterOutputStream implementations
- * [IO-139] New StringBuilder Writer implementation
- * [IO-192] New Tagged Input and Output streams
- * [IO-177] New Tailer class - simple implementation of the Unix "tail -f" functionality
- * [IO-162] New XML Stream Reader/Writer implementations (from ROME via plexus-utils)
-
- * [IO-142] Comparators - add facility to sort file lists/arrays
- * [IO-186] Comparators - new Composite and Directory File Comparator implementations
- * [IO-176] DirectoryWalker - add filterDirectoryContents() callback method for filtering directory contents
- * [IO-210] FileFilter - new Magic Number FileFilter
- * [IO-221] FileFilterUtils - add methods for suffix and prefix filters which take an IOCase object
- * [IO-232] FileFilterUtils - add method for name filters which take an IOCase object
- * [IO-229] FileFilterUtils - add varargs and() and or() methods
- * [IO-198] FileFilterUtils - add ability to apply file filters to collections and arrays
- * [IO-156] FilenameUtils - add normalize() and normalizeNoEndSeparator() methods which allow the separator character to be specified
- * [IO-194] FileSystemUtils - add freeSpaceKb() method with no input arguments
- * [IO-185] FileSystemUtils - add freeSpaceKb() methods that take a timeout parameter - fixes freeSpaceWindows() blocks
- * [IO-155] FileUtils - use NIO to copy files
- * [IO-168] FileUtils - add new isSymlink() method
- * [IO-219] FileUtils - throw FileExistsException when moving a file or directory if the destination already exists
- * [IO-234] FileUtils - add Methods for retrieving System User/Temp directories/paths
- * [IO-208] FileUtils - add timeout (connection and read) support for copyURLToFile() method
- * [IO-238] FileUtils - add sizeOf(File) method
- * [IO-181] LineIterator now implements Iterable
- * [IO-224] IOUtils - add closeQuietly(Closeable) and closeQuietly(Socket) methods
- * [IO-203] IOUtils - add skipFully() method for InputStreams
- * [IO-137] IOUtils and ByteArrayOutputStream - add toBufferedInputStream() method to avoid unnecessary array allocation/copy
- * [IO-195] Proxy streams/Reader/Writer - provide exception handling methods
- * [IO-211] Proxy Input/Output streams - add pre/post processing support
- * [IO-242] Proxy Reader/Writer - add pre/post processing support
-
-Bug fixes from 1.4
+Bug fixes from 2.0
------------------
- * [IO-214] ByteArrayOutputStream - fix inconsistent synchronization of fields
- * [IO-201] Counting Input/Output streams - fix inconsistent synchronization
- * [IO-159] FileCleaningTracker - fix remove() never returns null
- * [IO-220] FileCleaningTracker - fix Vector performs badly under load
- * [IO-167] FilenameUtils - fix case-insensitive string handling in FilenameUtils and FilesystemUtils
- * [IO-179] FilenameUtils - fix StringIndexOutOfBounds exception in getPathNoEndSeparator()
- * [IO-248] FilenameUtils - fix getFullPathNoEndSeparator() returns empty while path is a one level directory
- * [IO-246] FilenameUtils - fix wildcardMatch gives incorrect results
- * [IO-187] FileSystemUtils - fix freeSpaceKb() doesn't work with relative paths on Linux
- * [IO-160] FileSystemUtils - fix freeSpace() fails on solaris
- * [IO-209] FileSystemUtils - fix freeSpaceKb() fails to return correct size for a windows mount point
- * [IO-163] FileUtils - fix toURLs() using deprecated method of conversion to URL
- * [IO-168] FileUtils - fix Symbolic links followed when deleting directory
- * [IO-231] FileUtils - fix wrong exception message generated in isFileNewer() method
- * [IO-207] FileUtils - fix race condition in forceMkdir() method
- * [IO-217] FileUtils - fix copyDirectoryToDirectory() makes infinite loops
- * [IO-166] FileUtils - fix URL decoding in toFile(URL)
- * [IO-190] FileUtils - fix copyDirectory not preserving lastmodified date on sub-directories
- * [IO-240] FileFilterUtils - ensure cvsFilter and svnFilter are only created once.
- * [IO-175] IOUtils - fix copyFile() issues with very large files
- * [IO-191] Improvements from static analysis
- * [IO-216] LockableFileWriter - delete files quietly when an exception is thrown during initialization
- * [IO-243] SwappedDataInputStream - fix readBoolean is inverted
- * [IO-235] Tests - remove unused YellOnFlushAndCloseOutputStream from CopyUtilsTest
- * [IO-161] Tests - fix FileCleaningTrackerTestCase hanging
-
-
-Documentation changes from 1.4
-------------------------------
- * [IO-183 FilenameUtils.getExtension() method documentation improvements
- * [IO-226 FileUtils.byteCountToDisplaySize() documentation corrections
- * [IO-205 FileUtils.forceMkdir() documentation improvements
- * [IO-215 FileUtils copy file/directory improve documentation regarding preserving the last modified date
- * [IO-189 HexDump.dump() method documentation improvements
- * [IO-171 IOCase document that it assumes there are only two OSes: Windows and Unix
- * [IO-223 IOUtils.copy() documentation corrections
- * [IO-247 IOUtils.closeQuietly() improve documentation with examples
- * [IO-202 NotFileFilter documentation corrections
- * [IO-206 ProxyInputStream - fix misleading parameter names
- * [IO-212 ProxyInputStream.skip() documentation corrections
+ * [IO-257] - BOMInputStream.read(byte[]) can return 0 which it should not
+ * [IO-258] - XmlStreamReader consumes the stream during encoding detection
Feedback
--------
Modified: commons/proper/io/trunk/build.xml
URL: http://svn.apache.org/viewvc/commons/proper/io/trunk/build.xml?rev=1052167&r1=1052166&r2=1052167&view=diff
==============================================================================
--- commons/proper/io/trunk/build.xml (original)
+++ commons/proper/io/trunk/build.xml Thu Dec 23 03:32:58 2010
@@ -56,7 +56,7 @@
<property name="component.title" value="Commons IO"/>
<!-- The current version number of this component -->
- <property name="component.version" value="2.1-SNAPSHOT"/>
+ <property name="component.version" value="2.0.1-SNAPSHOT"/>
<!-- The base directory for component sources -->
<property name="source.home" value="src/main/java"/>
Modified: commons/proper/io/trunk/pom.xml
URL: http://svn.apache.org/viewvc/commons/proper/io/trunk/pom.xml?rev=1052167&r1=1052166&r2=1052167&view=diff
==============================================================================
--- commons/proper/io/trunk/pom.xml (original)
+++ commons/proper/io/trunk/pom.xml Thu Dec 23 03:32:58 2010
@@ -24,7 +24,7 @@
<modelVersion>4.0.0</modelVersion>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
- <version>2.1-SNAPSHOT</version>
+ <version>2.0.1-SNAPSHOT</version>
<name>Commons IO</name>
<inceptionYear>2002</inceptionYear>
@@ -211,7 +211,7 @@
<maven.compile.source>1.5</maven.compile.source>
<maven.compile.target>1.5</maven.compile.target>
<commons.componentid>io</commons.componentid>
- <commons.release.version>2.0</commons.release.version>
+ <commons.release.version>2.0.1</commons.release.version>
<commons.release.desc>(requires JDK 1.5+)</commons.release.desc>
<commons.release.2.version>1.4</commons.release.2.version>
<commons.release.2.desc>(requires JDK 1.3+)</commons.release.2.desc>
@@ -272,9 +272,9 @@
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>clirr-maven-plugin</artifactId>
- <version>2.2.2</version>
+ <version>2.2.3</version>
<configuration>
- <comparisonVersion>1.4</comparisonVersion>
+ <comparisonVersion>2.0</comparisonVersion>
<minSeverity>info</minSeverity>
</configuration>
</plugin>
Modified: commons/proper/io/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/commons/proper/io/trunk/src/site/site.xml?rev=1052167&r1=1052166&r2=1052167&view=diff
==============================================================================
--- commons/proper/io/trunk/src/site/site.xml (original)
+++ commons/proper/io/trunk/src/site/site.xml Thu Dec 23 03:32:58 2010
@@ -28,7 +28,7 @@
<item name="Download" href="http://commons.apache.org/io/download_io.cgi"/>
<item name="User guide" href="/description.html"/>
<item name="Best practices" href="/bestpractices.html"/>
- <item name="Javadoc (2.0)" href="api-release/index.html"/>
+ <item name="Javadoc (2.0.1)" href="api-release/index.html"/>
<item name="Javadoc (1.4)" href="api-1.4/index.html"/>
</menu>
Modified: commons/proper/io/trunk/src/site/xdoc/building.xml
URL: http://svn.apache.org/viewvc/commons/proper/io/trunk/src/site/xdoc/building.xml?rev=1052167&r1=1052166&r2=1052167&view=diff
==============================================================================
--- commons/proper/io/trunk/src/site/xdoc/building.xml (original)
+++ commons/proper/io/trunk/src/site/xdoc/building.xml Thu Dec 23 03:32:58 2010
@@ -28,10 +28,11 @@ limitations under the License.
<a href="http://ant.apache.org">Ant</a> as a build system.
</p>
<p>
- IO 2.0 requires a minimum of JDK 1.5 to build.
+ Commons IO requires a minimum of JDK 1.5 to build.
</p>
<p>
You may also be interested in the upgrade notes:<br />
+ Upgrade <a href="upgradeto2_0_1.html">from 2.0 to 2.0.1</a><br />
Upgrade <a href="upgradeto2_0.html">from 1.4 to 2.0</a><br />
Upgrade <a href="upgradeto1_4.html">from 1.3.2 to 1.4</a><br />
Upgrade <a href="upgradeto1_3_2.html">from 1.3, or 1.3.1 to 1.3.2</a><br />
Modified: commons/proper/io/trunk/src/site/xdoc/download_io.xml
URL: http://svn.apache.org/viewvc/commons/proper/io/trunk/src/site/xdoc/download_io.xml?rev=1052167&r1=1052166&r2=1052167&view=diff
==============================================================================
--- commons/proper/io/trunk/src/site/xdoc/download_io.xml (original)
+++ commons/proper/io/trunk/src/site/xdoc/download_io.xml Thu Dec 23 03:32:58 2010
@@ -95,32 +95,32 @@ limitations under the License.
</p>
</subsection>
</section>
- <section name="Commons IO 2.0 (requires JDK 1.5+)">
+ <section name="Commons IO 2.0.1 (requires JDK 1.5+)">
<subsection name="Binaries">
<table>
<tr>
- <td><a href="[preferred]/commons/io/binaries/commons-io-2.0-bin.tar.gz">commons-io-2.0-bin.tar.gz</a></td>
- <td><a href="http://www.apache.org/dist/commons/io/binaries/commons-io-2.0-bin.tar.gz.md5">md5</a></td>
- <td><a href="http://www.apache.org/dist/commons/io/binaries/commons-io-2.0-bin.tar.gz.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/io/binaries/commons-io-2.0.1-bin.tar.gz">commons-io-2.0.1-bin.tar.gz</a></td>
+ <td><a href="http://www.apache.org/dist/commons/io/binaries/commons-io-2.0.1-bin.tar.gz.md5">md5</a></td>
+ <td><a href="http://www.apache.org/dist/commons/io/binaries/commons-io-2.0.1-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/io/binaries/commons-io-2.0-bin.zip">commons-io-2.0-bin.zip</a></td>
- <td><a href="http://www.apache.org/dist/commons/io/binaries/commons-io-2.0-bin.zip.md5">md5</a></td>
- <td><a href="http://www.apache.org/dist/commons/io/binaries/commons-io-2.0-bin.zip.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/io/binaries/commons-io-2.0.1-bin.zip">commons-io-2.0.1-bin.zip</a></td>
+ <td><a href="http://www.apache.org/dist/commons/io/binaries/commons-io-2.0.1-bin.zip.md5">md5</a></td>
+ <td><a href="http://www.apache.org/dist/commons/io/binaries/commons-io-2.0.1-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a href="[preferred]/commons/io/source/commons-io-2.0-src.tar.gz">commons-io-2.0-src.tar.gz</a></td>
- <td><a href="http://www.apache.org/dist/commons/io/source/commons-io-2.0-src.tar.gz.md5">md5</a></td>
- <td><a href="http://www.apache.org/dist/commons/io/source/commons-io-2.0-src.tar.gz.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/io/source/commons-io-2.0.1-src.tar.gz">commons-io-2.0.1-src.tar.gz</a></td>
+ <td><a href="http://www.apache.org/dist/commons/io/source/commons-io-2.0.1-src.tar.gz.md5">md5</a></td>
+ <td><a href="http://www.apache.org/dist/commons/io/source/commons-io-2.0.1-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/io/source/commons-io-2.0-src.zip">commons-io-2.0-src.zip</a></td>
- <td><a href="http://www.apache.org/dist/commons/io/source/commons-io-2.0-src.zip.md5">md5</a></td>
- <td><a href="http://www.apache.org/dist/commons/io/source/commons-io-2.0-src.zip.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/io/source/commons-io-2.0.1-src.zip">commons-io-2.0.1-src.zip</a></td>
+ <td><a href="http://www.apache.org/dist/commons/io/source/commons-io-2.0.1-src.zip.md5">md5</a></td>
+ <td><a href="http://www.apache.org/dist/commons/io/source/commons-io-2.0.1-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
Modified: commons/proper/io/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/commons/proper/io/trunk/src/site/xdoc/index.xml?rev=1052167&r1=1052166&r2=1052167&view=diff
==============================================================================
--- commons/proper/io/trunk/src/site/xdoc/index.xml (original)
+++ commons/proper/io/trunk/src/site/xdoc/index.xml Thu Dec 23 03:32:58 2010
@@ -47,17 +47,27 @@ There are six main areas included:
<!-- ================================================== -->
<section name="Releases">
-<subsection name="Commons IO 2.0 (requires JDK 1.5+)">
+<subsection name="Commons IO 2.0.1 (requires JDK 1.5+)">
<p>
-Commons IO 2.0 is the latest version and requires a minimum of JDK 1.5 -
+Commons IO 2.0.1 is the latest version and requires a minimum of JDK 1.5 -
<a href="http://commons.apache.org/io/download_io.cgi">Download now!</a>
</p>
<p>
-View the <a href="upgradeto2_0.html">Release Notes</a> and
+View the <a href="upgradeto2_0_1.html">Release Notes</a> and
<a href="api-release/index.html">JavaDoc API documents</a>
</p>
</subsection>
+<subsection name="Commons IO 2.0 (requires JDK 1.5+)">
+<p>
+Commons IO 2.0 was the first release that required a minimum of JDK 1.5.
+</p>
+<p>
+View the <a href="upgradeto2_0.html">Release Notes</a> and
+<a href="api-2.0/index.html">JavaDoc API documents</a>
+</p>
+</subsection>
+
<subsection name="Commons IO 1.4 (requires JDK 1.3+)">
<p>
Commons IO 1.4 requires a minimum of JDK 1.3 -
Added: commons/proper/io/trunk/src/site/xdoc/upgradeto2_0_1.xml
URL: http://svn.apache.org/viewvc/commons/proper/io/trunk/src/site/xdoc/upgradeto2_0_1.xml?rev=1052167&view=auto
==============================================================================
--- commons/proper/io/trunk/src/site/xdoc/upgradeto2_0_1.xml (added)
+++ commons/proper/io/trunk/src/site/xdoc/upgradeto2_0_1.xml Thu Dec 23 03:32:58 2010
@@ -0,0 +1,67 @@
+<?xml version="1.0"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<document>
+ <properties>
+ <title>Upgrade from 2.0 to 2.0.1</title>
+ <author email="dev@commons.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+
+<section name="Upgrade">
+<p>
+These are the release notes and advice for upgrading Commons-IO from
+version 2.0 to version 2.0.1
+<source>
+Commons IO is a package of Java utility classes for java.io's hierarchy.
+Classes in this package are considered to be so standard and of such high
+reuse as to justify existence in java.io.
+
+Commons IO contains utility classes, stream implementations, file filters,
+file comparators and endian transformation classes.
+
+
+Compatibility with 2.0 and 1.4
+------------------------------
+Binary compatible - Yes
+
+Source compatible - Yes
+
+Semantic compatible - Yes
+ Check the bug fixes section for semantic bug fixes
+
+Commons IO 2.0.1 requires a minimum of JDK 1.5
+ (Commons IO 1.4 had a minimum of JDK 1.3)
+
+
+Enhancements from 2.0
+---------------------
+
+ * [IO-256] - Provide thread factory for FileAlternationMonitor
+
+
+Bug fixes from 2.0
+------------------
+
+ * [IO-257] - BOMInputStream.read(byte[]) can return 0 which it should not
+ * [IO-258] - XmlStreamReader consumes the stream during encoding detection
+</source>
+</p>
+</section>
+
+</body>
+</document>
Propchange: commons/proper/io/trunk/src/site/xdoc/upgradeto2_0_1.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: commons/proper/io/trunk/src/site/xdoc/upgradeto2_0_1.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL