ref: 36ac51109224df99ad0e96609d37d126864f51ff
dir: /common/id3lib/NEWS/
$Id: NEWS,v 1.1 2002/01/21 08:16:20 menno Exp $
2000-05-28 Version 3.7.9
* Added new test programs in examples/ for creating example tag files
* Further improvements to compile on (Unix) systems that don't have zlib
* Fixed a bug when parsing compressed frames (thanks to Christian Becker for
the bug report and example file)
* Fixed several bugs when writing to files (thanks to Lothar Egger and Peter
Thorstenson for the bug reports)
* New delphi example code for use with id3com (thanks Michael Little)
* Bugfixes for id3com (thanks John Adcock)
* Changed behavior of Link() and Clear() in ID3_Tag: Clear() doesn't remove
file reference, and Link'ing to an already-linked tag just changes the file
reference
* Cleaned up the class interfaces to use size_t, flags_t, and index_t rather
than luint, so as to be more descriptive
* ID3_Tag::RemoveFrame() now returns the pointer to the frame removed (NULL if
not present), thus releasing the tag from its repsonsibility of managing that
frame's memory
* Cleaned up C interface so that appropriate function parameters are const
* Cleaned up implementation of ID3_Tag::Clear() to fix inconsistencies
* Deprecated ID3_Tag's HasV2Tag(), HasV1Tag(), and HasLyrics() methods in
favor of ID3_Tag::HasTagType() method
* All Render() methods now const
* Added GetUnsync() method to ID3_Tag
* Cleaned up internal class definitions (thereby destroying binary
compatibility)
* ID3v2 tag now won't render (and its reported size is 0) if there aren't any
frames (per the spec)
* Fixed a bug when copying frames that prevented rendering compressed frames in
certain situations
* Fixed a bug with resyncing that caused it to improperly handle the last byte
* Fixed a bug with recognizing certain sync signals
* Lots of other minor changes
2000-05-11 Version 3.7.8
* Major bug fix that caused all string frames to be written out as unicode, yet
with the wrong encoding information given
* Bug fix for stripping id3v2 tags that wouldn't remove enough data
* Bug fix for writing id3v1 tags that might add extraneous data to the tag
2000-05-10 Version 3.7.7
* As part of the major rewrite of underlying codebase started with previous
release, this release features near-complete reimplementation of most of the
ID3v2 parsing code - smaller, faster, and better organized
* Much imporved Lyrics3 v2 tag support, along with much improved synchronized
lyrics (SYLT) support (thanks Severino Delaurenti)
* Updated id3com to reflect changes to compression strategy introduced in last
release (thanks John Adcock)
* Cleaned up the parameters to several functions/methods with regards to
constness
* Several new methods to several classes
* A variety of bugfixes
2000-05-03 Version 3.7.6
* Beginning of major rewrite of underlying codebase to improve efficiency,
expandability; the interface will need minor updates through this endeavor
(sorry!)
* Major bugfix in ID3_Tag::Strip which was deleting too much info from a file
in certain circumstances
* Add descriptions to frames; can access either through a ID3_Frame method for
a frame object, or via the static method on the class (w/ ID3_FrameID param)
(thanks John Adcock for descriptions, Daryl Pawluk for spotting misorder)
* Frame compression is determined frame by frame, so deprecated
ID3_Tag::SetCompression() for ID3_Frame::SetCompression().
ID3_Tag::SetCompression() is now a no-op (updated C interface accordingly)
* New method ID3_Frame::Contains(ID3_FieldID) for determining if a frame
contains a particular field
* New static method ID3_Tag::IsV2Tag() deprecates ID3_IsTagHeader()
* Other minor bugfixes
2000-04-28 Version 3.7.5
* Fixed nasty bug with rewriting tags to windows files (thanks John Adcock)
* More fixes, improvements to id3com files (thanks John Adcock)
* Added parsing of Lyrics3 v1.00 tags (thanks Severino Delaurenti)
* Updated documentation, but still in flux
* Other minor bugfixes
2000-04-26 Version 3.7.4
* Fixed windows project files so that they all work correctly with new release
(thanks John Adcock, Robert Moon, and Lothar Egger)
* Added a simple VB app to test id3lib using id3com.dll (thanks John Adcock)
* Added better implementation of PRIV (Private) frame (thanks John Adcock)
* Fixed padding logic (thanks John Adcock)
* New "Spec Versioning" system under the hood produces minor interface change
- Defined new enum: ID3_V2Spec (ID3V2_2_0, ID3V2_2_1, ID3V2_3_0, etc.)
- {Get,Set}Spec now used in favor of deprected {Get,Set}Version, GetRevision
- Field definitions updated accordingly; now smaller and more exact
2000-04-24 Version 3.7.3
* C/C++ interface changes:
- Moved V1_LEN* constants into an enumeration so that they can be used as
array size initializers in C. Renamed the constants for consistency
(LEN_V1 -> ID3_V1_LEN, LEN_V1_TITLE -> ID3_V1_LEN_TITLE, etc.)
- Renamed ID3_TagType's enums to be more consistent with rest of library's
enums (V1_TAG -> ID3TT_ID3V1, V2_TAG -> ID3TT_ID3V2, etc.)
- ID3_Err enumeration now defines ID3E_NoError
* C++ interface changes:
- ID3_Frame now has a copy constructor
- ID3_Tag::AddNewFrame deprecated for AttachFrame (no other difference in
behavior)
- ID3_Tag::Link(char *, bool, bool) deprecated for
ID3_Tag::Link(char *, luint). Now accepts ID3_TagTypes to determine which
tags to parse. i.e, mytag.Link("myfile.mp3", ID3TT_ID3V2 | ID3TT_LYRICS);
- ID3_Tag::operator<<, ID3_Tag::AddFrame: relevant parameters now const
* C interface changes:
- ID3Tag_Parse, ID3Tag_Update, ID3Tag_Strip now return an ID3_Err
- Added functions ID3Tag_UpdateByTagType, ID3Frame_New, ID3Frame_NewID,
ID3Frame_Delete
* Implementation changes:
- AddFrame, AddFrames now add copies of the frames passed in.
- AttachFrame adds the actual frame passed to it.
- The tag takes responsibility for managing its frames' memory in all cases.
* Miscellaneous changes:
- Moved most enum and struct declarations to include/id3/globals.h so they
are accessible to C interface
- id3com.dsp file is 'fixed', but the project still doesn't compile w/o
errors
- Most doxygen comments moved from tag.h to respective files
- Fixed a bug in id3lib.spec which caused rpm binaries to be compiled without
exception handling
- examples, include/id3/* header files no longer include config.h
- Other minor bugfixes
2000-04-21 Version 3.7.2
* Implementation of C interface for all platforms (in src/c_wrapper.cpp, which
replaces dll_wrapper.cpp)
* Added examples/demo_simple.c which demonstrates basic use of C interface
* Auto-generated documentation no longer shipped with main tarball distribution
* mp3 example files no longer included (still available via CVS)
* Updated Windows project files so that they'll (hopefully) compile cleanly
again
2000-04-19 Version 3.7.1
* Interface changed: functions in version.{h,cpp} replaced with constants
defined in globals.h
* Added a spec file for creating rpm's
* C interface now defined in include/id3.h, replaces include/src/dll.h;
* Lots of file movement. src/id3/* to src/; src/examples to examples;
* Examples now compiled as installable binaries, rather than 'checks'
* Removed unnecessary files: externals.h, types.h, version.{h,cpp}, dll.h
2000-04-15 Version 3.7.0
* New project management: MusicMatch handed reigns over to Scott Haug
* New project licensing: LGPL (http://www.gnu.org/copyleft/lesser.html)
* New versioning: 3.7.x is unstable series leading up to 3.8.x stable
* Many bug fixes
* Better windows compatibility, with new windows project files
* Improved documentation, using the Doxygen documentation system
(http://www.stack.nl/~dimitri/doxygen/)
* Extended API, improved implementation
* More supported frames
* Now parses and rerenders unrecognized frame types
* Better version handling in configuration files, similar to the glib library
(http://www.gtk.org)
1999-12-02 Version 3.6.2
* Improved portability: another minor portability fixes, along with the
inclusion of zlib sources and project files for windows compilation.
1999-12-01 Version 3.6.1
* Code movement: moved the header files from src/id3 to include/id3 to allow
for easier windows compilation.
* Improved portability: made changes in several files to improve compilation
on windows. (thanks to elrod for the fixes)
* Random cleanup: some spelling errors fixed, some minor file administration,
etc.
1999-11-30 Version 3.6.0
* Code overhaul: more descriptive variable naming, streamlined implementation
logic, cleaner interface specification, generalization of magic numbers and
strings.
* Better documentation: transcribed the the "Documentation for ID3Lib 3.05"
document (written by Dirk Mahoney, 22 Nov 1998) into the actual source, using
javadoc-like tags so as to create documentation with the application doc++.
Using this program (and ones like it) allows for creating the documentation
in many different formats, including html, texinfo, man, latex, and the like.
* Added functionality: Added additional functions for simplified access to
common tags, such as artist, title, and album.
* More robust error checking: Improved upon the exception handling already in
place to better handle error conditions, such as invalid tags, unrecognized
frames, and the like. Work is still needed to ensure the library can handle
error situations gracefully.
* Improved portability: restructured the code into a GNU-like directory.
hierarchy. By making use of the GNU tools automake and autoconf, a wide
variety of platforms can be easily supported. This allows for a standard
"./configure; make; make install" installation process, as well as an
equally trivial method for uninstallation: "make uninstall". Likewise,
"make check" builds the example applications (see below).
* Enhanced examples: the src/examples/ subdirectory has both new and improved
examples demonstrating how to make use of id3lib. The original "id3convert"
example now can convert both ways between id3v1 and id3v2 tags, as well as
strip both types of tags off of files via command-line switches.
Additionally, an "id3info" app has been added for displaying id3v1/v2 tag
information about a file.
* Bug fixing: Fixes, fixes, and more fixes. A continual process.
* The zlib library files were removed from the project. The need for zlib
was instead made a requirement through the configuration process via autoconf
and automake.
* All of the id3lib library files were renamed by removing the "id3_" prefix.
Instead, the library files were placed in an id3 subdirectory in the src
directory. Likewise, when the library is installed on a system, an "id3"
subdirectory is created in the indicated include directory, and the header
files are placed there. Pragmatically, this means that code that makes use
of id3lib needs to "#include <id3/tag.h>" rather than "#include <id3_tag.h>".
This was done to create more structure and to avoid clutter in the include
directory.
* The versioning strategy has been updated to be more in line with the
"libtool" way. However, in order to be more compatible with how versions
progressed previously, I've taken the approach that many other libraries have
taken: I've "massaged" the version:revision:age numbers so that the resulting
compiled library shows up as id3lib.so.3.6.0 (or whatever the current release
is). This is /strongly/ advised against in the libtool documentation, so I'm
considering going to a more "traditional" libtool versioning approach (see
the libtool info page for more information).
There is yet much to do! Please see the TODO file for known bugs and lacking
features...