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