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="d...@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