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