|
| 1 | +<?xml version="1.0"?> |
| 2 | +<!-- |
| 3 | +Licensed to the Apache Software Foundation (ASF) under one or more |
| 4 | +contributor license agreements. See the NOTICE file distributed with |
| 5 | +this work for additional information regarding copyright ownership. |
| 6 | +The ASF licenses this file to You under the Apache License, Version 2.0 |
| 7 | +(the "License"); you may not use this file except in compliance with |
| 8 | +the License. You may obtain a copy of the License at |
| 9 | +
|
| 10 | + http://www.apache.org/licenses/LICENSE-2.0 |
| 11 | +
|
| 12 | +Unless required by applicable law or agreed to in writing, software |
| 13 | +distributed under the License is distributed on an "AS IS" BASIS, |
| 14 | +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 15 | +See the License for the specific language governing permissions and |
| 16 | +limitations under the License. |
| 17 | +--> |
| 18 | +<document> |
| 19 | + <properties> |
| 20 | + <title>Upgrade from 2.4 to 2.5</title> |
| 21 | + <author email="dev@commons.apache.org">Commons Documentation Team</author> |
| 22 | + </properties> |
| 23 | + <body> |
| 24 | + |
| 25 | + <section name="Upgrade"> |
| 26 | + <p> |
| 27 | + These are the release notes and advice for upgrading Commons-IO from |
| 28 | + version 2.4 to version 2.5 |
| 29 | + <source> |
| 30 | + Commons IO is a package of Java utility classes like java.io. |
| 31 | + Classes in this package are considered to be so standard and of such high |
| 32 | + reuse as to justify existence in java.io. |
| 33 | + |
| 34 | + The Commons IO library contains utility classes, stream implementations, file filters, |
| 35 | + file comparators, endian transformation classes, and much more. |
| 36 | + |
| 37 | + ============================================================================== |
| 38 | + Apache Commons IO Version 2.4-SNAPSHOT |
| 39 | + ============================================================================== |
| 40 | + |
| 41 | + Changes in this version include: |
| 42 | + |
| 43 | + New features: |
| 44 | + o IO-269: Tailer locks file from deletion/rename on Windows. Thanks to sebb. |
| 45 | + o IO-333: Export OSGi packages at version 1.x in addition to 2.x. Thanks to fmeschbe. |
| 46 | + o IO-320: Add XmlStreamReader support for UTF-32. Thanks to ggregory. |
| 47 | + o IO-331: BOMInputStream wrongly detects UTF-32LE_BOM files as UTF-16LE_BOM files in method |
| 48 | + getBOM(). Thanks to ggregory. |
| 49 | + o IO-327: Add byteCountToDisplaySize(BigInteger). Thanks to ggregory. |
| 50 | + o IO-326: Add new FileUtils.sizeOf[Directory] APIs to return BigInteger. Thanks to ggregory. |
| 51 | + o IO-325: Add IOUtils.toByteArray methods to work with URL and URI. Thanks to raviprak. |
| 52 | + o IO-324: Add missing Charset sister APIs to method that take a String charset name. Thanks to |
| 53 | + raviprak. |
| 54 | + |
| 55 | + Fixed Bugs: |
| 56 | + o IO-279: Tailer erroneously considers file as new. Thanks to Sergio Bossa, Chris Baron. |
| 57 | + o IO-335: Tailer#readLines - incorrect CR handling. |
| 58 | + o IO-334: FileUtils.toURLs throws NPE for null parameter; document the behavior. |
| 59 | + o IO-332: Improve tailer's reading performance. Thanks to liangly. |
| 60 | + o IO-279: Improve Tailer performance with buffered reads (see IO-332). |
| 61 | + o IO-329: FileUtils.writeLines uses unbuffered IO. Thanks to tivv. |
| 62 | + o IO-319: FileUtils.sizeOfDirectory follows symbolic links. Thanks to raviprak. |
| 63 | + |
| 64 | + Compatibility with 2.3: |
| 65 | + Binary compatible: Yes. |
| 66 | + Source compatible: Yes. |
| 67 | + Semantic compatible: Yes. |
| 68 | + |
| 69 | + Compatibility with 2.2 and 1.4: |
| 70 | + Binary compatible: Yes. |
| 71 | + Source compatible: No, see the rare case in https://issues.apache.org/jira/browse/IO-318. |
| 72 | + Semantic compatible: No, see the rare case in https://issues.apache.org/jira/browse/IO-318. |
| 73 | + |
| 74 | + Commons IO 2.5 requires JDK 1.6 or later. |
| 75 | + Commons IO 2.4 requires JDK 1.6 or later. |
| 76 | + Commons IO 2.3 requires JDK 1.6 or later. |
| 77 | + Commons IO 2.2 requires JDK 1.5 or later. |
| 78 | + Commons IO 1.4 requires JDK 1.3 or later. |
| 79 | + </source> |
| 80 | + </p> |
| 81 | + </section> |
| 82 | + |
| 83 | + </body> |
| 84 | +</document> |
0 commit comments