shithub: aacdec

ref: 4b4241830d669436bff595a1deaa5148f9562d79
dir: /common/id3lib/NEWS/

View raw version
$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...