Chris@0: 
Chris@0:  libid3tag - ID3 tag manipulation library
Chris@0:  Copyright (C) 2000-2004 Underbit Technologies, Inc.
Chris@0: 
Chris@0:  $Id: README,v 1.5 2004/01/23 09:41:32 rob Exp $
Chris@0: 
Chris@0: ===============================================================================
Chris@0: 
Chris@0: INTRODUCTION
Chris@0: 
Chris@0:   libid3tag is a library for reading and (eventually) writing ID3 tags, both
Chris@0:   ID3v1 and the various versions of ID3v2.
Chris@0: 
Chris@0:   See the file `id3tag.h' for the current library interface.
Chris@0: 
Chris@0:   This package uses GNU libtool to arrange for zlib to be linked
Chris@0:   automatically when you link your programs with this library. If you aren't
Chris@0:   using GNU libtool, in some cases you may need to link with zlib
Chris@0:   explicitly:
Chris@0: 
Chris@0:       ${link_command} ... -lid3tag -lz
Chris@0: 
Chris@0: ===============================================================================
Chris@0: 
Chris@0: BUILDING AND INSTALLING
Chris@0: 
Chris@0:   Note that this library depends on zlib 1.1.4 or later. If you don't have
Chris@0:   zlib already, you can obtain it from:
Chris@0: 
Chris@0:       http://www.gzip.org/zlib/
Chris@0: 
Chris@0:   You must have zlib installed before you can build this package.
Chris@0: 
Chris@0: Windows Platforms
Chris@0: 
Chris@0:   libid3tag can be built under Windows using either MSVC++ or Cygwin. A
Chris@0:   MSVC++ project file can be found under the `msvc++' subdirectory.
Chris@0: 
Chris@0:   To build libid3tag using Cygwin, you will first need to install the Cygwin
Chris@0:   tools:
Chris@0: 
Chris@0:       http://www.cygwin.com/
Chris@0: 
Chris@0:   You may then proceed with the following POSIX instructions within the
Chris@0:   Cygwin shell.
Chris@0: 
Chris@0:   Note that by default Cygwin will build a library that depends on the
Chris@0:   Cygwin DLL. You can use MinGW to build a library that does not depend on
Chris@0:   the Cygwin DLL. To do so, give the option --host=mingw32 to `configure'.
Chris@0:   Be certain you also link with a MinGW version of zlib.
Chris@0: 
Chris@0: POSIX Platforms (including Cygwin)
Chris@0: 
Chris@0:   The code is distributed with a `configure' script that will generate for
Chris@0:   you a `Makefile' and a `config.h' for your platform. See the file
Chris@0:   `INSTALL' for generic instructions.
Chris@0: 
Chris@0:   The specific options you may want to give `configure' are:
Chris@0: 
Chris@0:       --disable-debugging       do not compile with debugging support, and
Chris@0:                                 use more optimizations
Chris@0: 
Chris@0:       --disable-shared          do not build a shared library
Chris@0: 
Chris@0:   By default the package will build a shared library if possible for your
Chris@0:   platform. If you want only a static library, use --disable-shared.
Chris@0: 
Chris@0:   If zlib is installed in an unusual place or `configure' can't find it, you
Chris@0:   may need to indicate where it is:
Chris@0: 
Chris@0:       ./configure ... CPPFLAGS="-I${include_dir}" LDFLAGS="-L${lib_dir}"
Chris@0: 
Chris@0:   where ${include_dir} and ${lib_dir} are the locations of the installed
Chris@0:   header and library files, respectively.
Chris@0: 
Chris@0: Experimenting and Developing
Chris@0: 
Chris@0:   Further options for `configure' that may be useful to developers and
Chris@0:   experimenters are:
Chris@0: 
Chris@0:       --enable-debugging        enable diagnostic debugging support and
Chris@0:                                 debugging symbols
Chris@0: 
Chris@0:       --enable-profiling        generate `gprof' profiling code
Chris@0: 
Chris@0: ===============================================================================
Chris@0: 
Chris@0: COPYRIGHT
Chris@0: 
Chris@0:   Please read the `COPYRIGHT' file for copyright and warranty information.
Chris@0:   Also, the file `COPYING' contains the full text of the GNU GPL.
Chris@0: 
Chris@0:   Send inquiries, comments, bug reports, suggestions, patches, etc. to:
Chris@0: 
Chris@0:       Underbit Technologies, Inc. <support@underbit.com>
Chris@0: 
Chris@0:   See also the MAD home page on the Web:
Chris@0: 
Chris@0:       http://www.underbit.com/products/mad/
Chris@0: 
Chris@0: ===============================================================================
Chris@0: