blob: 1eca3da63cadce74645c85922d678f930f127495 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
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.
-->
<!--
This file is also used by the maven-changes-plugin to generate the release notes.
Useful ways of finding items to add to this file are:
1. Add items when you fix a bug or add a feature (this makes the
release process easy :-).
2. Do a JIRA search for tickets closed since the previous release.
3. Use the report generated by the maven-changelog-plugin to see all
SVN commits. TBA how to use this with SVN.
To generate the release notes from this file:
mvn changes:announcement-generate -Prelnotes
mv target/announcement/release-notes.vm RELEASE-NOTES.txt
then tweak the formatting if necessary and commit
The <action> type attribute can be add,update,fix,remove.
-->
<document>
<properties>
<title>commons-compress</title>
</properties>
<body>
<release version="1.4" date="unreleased"
description="Release 1.4">
<action issue="COMPRESS-179" type="fix" date="2012-02-23">
TarUtils.formatLongOctalOrBinaryBytes() assumes the field will be 12 bytes long
</action>
<action issue="COMPRESS-175" type="fix" date="2012-02-22">
GNU Tar sometimes uses binary encoding for UID and GID
</action>
<action issue="COMPRESS-171" type="fix" date="2012-01-29">
ArchiveStreamFactory.createArchiveInputStream would claim
short text files were TAR archives.
</action>
<action issue="COMPRESS-156" type="add" date="2011-11-02">
Support for the XZ format has been added.
</action>
<action issue="COMPRESS-146" type="update" date="2011-11-07">
BZip2CompressorInputStream now optionally supports reading of
concatenated .bz2 files.
</action>
<action issue="COMPRESS-154" type="update" date="2011-11-09">
GZipCompressorInputStream now optionally supports reading of
concatenated .gz files.
</action>
<action issue="COMPRESS-164" type="fix" date="2011-12-05">
ZipFile didn't work properly for archives using unicode extra
fields rather than UTF-8 filenames and the EFS-Flag.
</action>
<action issue="COMPRESS-16" type="update" date="2011-12-07">
The tar package can now read archives that use star/GNU/BSD
extensions for files that are longer than 8 GByte as well as
archives that use the POSIX/PAX variant.
</action>
<action issue="COMPRESS-165" type="update" date="2011-12-08">
The tar package can now write archives that use star/GNU/BSD
extensions for files that are longer than 8 GByte as well as
archives that use the POSIX/PAX variant.
</action>
<action issue="COMPRESS-166" type="update" date="2011-12-08">
The tar package can now use the POSIX/PAX variant for writing
entries with names longer than 100 characters.
</action>
<action issue="COMPRESS-169" type="fix" date="2011-12-22">
For corrupt archives ZipFile would throw a RuntimeException in
some cases and an IOException in others. It will now
consistently throw an IOException.
</action>
</release>
<release version="1.3" date="2011-11-01"
description="Release 1.3 - API compatible to 1.2 but requires Java5 at runtime">
<action issue="COMPRESS-142" type="add" date="2011-09-14">
Support for the Pack200 format has been added.
</action>
<action issue="COMPRESS-132" type="add" date="2011-08-17">
Read-only support for the format used by the Unix dump(8) tool
has been added.
</action>
<action issue="COMPRESS-36" type="update" date="2011-08-15">
The ZIP package now supports Zip64 extensions.
</action>
<action issue="COMPRESS-144" type="update" date="2011-08-08">
The AR package now supports the BSD dialect of storing file
names longer than 16 chars (both reading and writing).
</action>
<action type="fix" date="2011-08-08">
BZip2CompressorInputStream's getBytesRead method always
returned 0.
</action>
<action issue="COMPRESS-152" type="fix" date="2011-08-03">
ZipArchiveInputStream and ZipArchiveOutputStream could leak
resources on some JDKs.
</action>
<action issue="COMPRESS-160" type="fix" date="2011-10-23">
TarArchiveOutputStream's getBytesWritten method didn't count
correctly.
</action>
</release>
<release version="1.2" date="2011-07-31"
description="Release 1.2 - a bugfix release, the last release expected to be compatible with Java 1.4">
<action issue="COMPRESS-129" type="fix" date="2011-07-26">
ZipArchiveInputStream could fail with a "Truncated ZIP" error
message for entries between 2 GByte and 4 GByte in size.
</action>
<action issue="COMPRESS-145" type="fix" date="2011-07-23"
due-tue="Patrick Dreyer">
TarArchiveInputStream now detects sparse entries using the
oldgnu format and properly reports it cannot extract their
contents.
</action>
<action issue="COMPRESS-123" type="add" date="2011-07-23">
ZipArchiveEntry has a new method getRawName that provides the
original bytes that made up the name. This may allow user
code to detect the encoding.
</action>
<action issue="COMPRESS-130" type="fix" date="2011-07-20">
The Javadoc for ZipArchiveInputStream#skip now matches the
implementation, the code has been made more defensive.
</action>
<action issue="COMPRESS-140" type="fix" date="2011-07-20"
due-to="Trejkaz">
ArArchiveInputStream fails if entries contain only blanks for
userId or groupId.
</action>
<action issue="COMPRESS-139" type="fix" date="2011-07-13">
ZipFile may leak resources on some JDKs.
</action>
<action type="update" date="2011-04-18">
ZipFile now implements finalize which closes the underlying
file.
</action>
<action issue="COMPRESS-117" type="update" date="2011-03-23">
Certain tar files not recognised by ArchiveStreamFactory.
</action>
<action issue="COMPRESS-125" type="fix" date="2011-03-23">
BZip2CompressorInputStream throws IOException if underlying stream returns available() == 0.
Removed the check.
</action>
<action issue="COMPRESS-127" type="fix" date="2011-03-23">
Calling close() on inputStream returned by CompressorStreamFactory.createCompressorInputStream()
does not close the underlying input stream.
</action>
<action issue="COMPRESS-122" type="add" date="2010-10-29">
TarArchiveEntry provides access to the flags that determine
whether it is an archived symbolic link, pipe or other
"uncommon" file system object.
</action>
<action issue="COMPRESS-119" type="fix" date="2010-10-26">
TarArchiveOutputStream#finish now writes all buffered data to the stream
</action>
</release>
<release version="1.1" date="2010-08-13" description="Release 1.1">
<action issue="COMPRESS-72" type="fix" date="2010-06-02">
Move acknowledgements from NOTICE to README
</action>
<action issue="COMPRESS-113" type="fix" date="2010-06-02">
TarArchiveEntry.parseTarHeader() includes the trailing space/NUL when parsing the octal size
</action>
<action issue="COMPRESS-108" type="add" date="2010-05-23">
Command-line interface to list archive contents.
Usage: java -jar commons-compress-n.m.jar archive-name [zip|tar|etc]
</action>
<action issue="COMPRESS-118" type="fix" date="2010-05-17">
TarUtils.parseName does not properly handle characters outside the range 0-127
</action>
<action issue="COMPRESS-112" type="update" date="2010-05-13">
ArArchiveInputStream does not handle GNU extended filename records (//)
</action>
<action issue="COMPRESS-109" type="add" date="2010-05-10">
Tar implementation does not support Pax headers
Added support for reading pax headers.
Note: does not support global pax headers
</action>
<action issue="COMPRESS-107" type="fix" date="2010-05-10">
ArchiveStreamFactory does not recognise tar files created by Ant
</action>
<action issue="COMPRESS-110" type="fix" date="2010-05-09">
Support "ustar" prefix field, which is used when file paths are longer
than 100 characters.
</action>
<action type="update" date="2010-04-19" issue="COMPRESS-105">
Document that the name of an ZipArchiveEntry determines whether
an entry is considered a directory or not.
If you don't use the constructor with the File argument the entry's
name must end in a "/" in order for the entry to be known as a directory.
</action>
<action type="add" date="2010-03-19" issue="COMPRESS-103">
ZipArchiveInputStream can optionally extract data that used
the STORED compression method and a data descriptor.
Doing so in a stream is not safe in general, so you have to
explicitly enable the feature. By default the stream will
throw an exception if it encounters such an entry.
</action>
<action type="fix" date="2010-03-12" issue="COMPRESS-100">
ZipArchiveInputStream will throw an exception if it detects an
entry that uses a data descriptor for a STORED entry since it
cannot reliably find the end of data for this "compression"
method.
</action>
<action type="fix" date="2010-03-12" issue="COMPRESS-101">
ZipArchiveInputStream should now properly read archives that
use data descriptors but without the "unofficial" signature.
</action>
<action type="add" date="2010-03-09" issue="COMPRESS-98">
The ZIP classes will throw specialized exceptions if any
attempt is made to read or write data that uses zip features
not supported (yet).
</action>
<action type="add" date="2010-03-08" issue="COMPRESS-99">
ZipFile#getEntries returns entries in a predictable order -
the order they appear inside the central directory.
A new method getEntriesInPhysicalOrder returns entries in
order of the entry data, i.e. the order ZipArchiveInputStream
would see.
</action>
<action type="add" date="2010-02-19">
The Archive*Stream and ZipFile classes now have
can(Read|Write)EntryData methods that can be used to check
whether a given entry's data can be read/written.
The method currently returns false for ZIP archives if an
entry uses an unsupported compression method or encryption.
</action>
<action type="add" date="2010-02-19" issue="COMPRESS-89">
The ZIP classes now detect encrypted entries.
</action>
<action type="update" date="2010-02-18" issue="COMPRESS-79">
Move DOS/Java time conversions into Zip utility class.
</action>
<action type="fix" date="2010-02-18" issue="COMPRESS-74">
ZipArchiveInputStream failed to update the number of bytes
read properly.
</action>
<action type="fix" date="2010-02-18">
ArchiveInputStream has a new method getBytesRead that should
be preferred over getCount since the later may truncate the
number of bytes read for big archives.
</action>
<action type="fix" date="2010-02-18" issue="COMPRESS-85">
The cpio archives created by CpioArchiveOutputStream couldn't
be read by many existing native implementations because the
archives contained multiple entries with the same inode/device
combinations and weren't padded to a blocksize of 512 bytes.
</action>
<action type="fix" date="2010-02-16" issue="COMPRESS-73">
ZipArchiveEntry, ZipFile and ZipArchiveInputStream are now
more lenient when parsing extra fields.
</action>
<action issue="COMPRESS-75" type="update" date="2010-02-12">
ZipArchiveInputStream does not show location in file where a problem occurred.
</action>
<action type="fix" date="2010-02-12" issue="COMPRESS-82">
cpio is terribly slow.
Documented that buffered streams are needed for performance
</action>
<action type="add" date="2010-02-12" issue="COMPRESS-97">
Added autodetection of compression format to
CompressorStreamFactory.
</action>
<action type="fix" date="2010-02-12">
Improved exception message if the extra field data in ZIP
archives cannot be parsed.
</action>
<action type="fix" date="2010-02-11" issue="COMPRESS-17">
Tar format unspecified - current support documented.
</action>
<action type="add" issue="COMPRESS-95" date="2010-01-29"
due-to="Joerg Bellmann">
Improve ExceptionMessages in ArchiveStreamFactory
</action>
<action type="fix" issue="COMPRESS-94" date="2010-01-07"
due-to="Anon Devs">
ZipArchiveEntry's equals method was broken for entries created
with the String-arg constructor. This lead to broken ZIP
archives if two different entries had the same hash code.
</action>
<action type="fix" issue="COMPRESS-87" date="2009-10-30"
due-to="Antoni Mylka">
ZipArchiveInputStream could repeatedly return 0 on read() when
the archive was truncated.
</action>
<action type="fix" issue="COMPRESS-86" date="2009-10-08">
Tar archive entries holding the file name for names longer
than 100 characters in GNU longfile mode didn't properly
specify they'd be using the "oldgnu" extension.
</action>
<action type="add" date="2009-08-25">
A new constructor of TarArchiveEntry can create entries with
names that start with slashes - the default is to strip
leading slashes in order to create relative path names.
</action>
<action issue="COMPRESS-83" type="fix" date="2009-08-01">
Delegate all read and write methods in GZip stream in order to
speed up operations.
</action>
<action type="add" date="2009-08-01">
ArchiveEntry now has a getLastModifiedDate method.
</action>
<action type="fix" date="2009-08-01">
The ar and cpio streams now properly read and write last
modified times.
</action>
<action issue="COMPRESS-81" type="fix" date="2009-06-30">
TarOutputStream can leave garbage at the end of the archive
</action>
<action issue="COMPRESS-78" type="add" date="2009-06-30"
due-to="Jukka Zitting">
Add a BZip2Utils class modelled after GZipUtils
</action>
</release>
<release version="1.0" date="2009-05-21" description="First Public Release">
<action dev="all" type="add" date="2009-05-21">
Initial release
</action>
<action dev="sgoeschl" type="fix">
Updating the pom.xml for preparing a move to commons-proper
</action>
</release>
</body>
</document>