1
2 libid3tag - ID3 tag manipulation library
3 Copyright (C) 2000-2004 Underbit Technologies, Inc.
4
5 $Id: README,v 1.5 2004/01/23 09:41:32 rob Exp $
6
7===============================================================================
8
9INTRODUCTION
10
11  libid3tag is a library for reading and (eventually) writing ID3 tags, both
12  ID3v1 and the various versions of ID3v2.
13
14  See the file `id3tag.h' for the current library interface.
15
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
19  explicitly:
20
21      ${link_command} ... -lid3tag -lz
22
23===============================================================================
24
25BUILDING AND INSTALLING
26
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:
29
30      http://www.gzip.org/zlib/
31
32  You must have zlib installed before you can build this package.
33
34Windows Platforms
35
36  libid3tag can be built under Windows using either MSVC++ or Cygwin. A
37  MSVC++ project file can be found under the `msvc++' subdirectory.
38
39  To build libid3tag using Cygwin, you will first need to install the Cygwin
40  tools:
41
42      http://www.cygwin.com/
43
44  You may then proceed with the following POSIX instructions within the
45  Cygwin shell.
46
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.
51
52POSIX Platforms (including Cygwin)
53
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.
57
58  The specific options you may want to give `configure' are:
59
60      --disable-debugging       do not compile with debugging support, and
61                                use more optimizations
62
63      --disable-shared          do not build a shared library
64
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.
67
68  If zlib is installed in an unusual place or `configure' can't find it, you
69  may need to indicate where it is:
70
71      ./configure ... CPPFLAGS="-I${include_dir}" LDFLAGS="-L${lib_dir}"
72
73  where ${include_dir} and ${lib_dir} are the locations of the installed
74  header and library files, respectively.
75
76Experimenting and Developing
77
78  Further options for `configure' that may be useful to developers and
79  experimenters are:
80
81      --enable-debugging        enable diagnostic debugging support and
82                                debugging symbols
83
84      --enable-profiling        generate `gprof' profiling code
85
86===============================================================================
87
88COPYRIGHT
89
90  Please read the `COPYRIGHT' file for copyright and warranty information.
91  Also, the file `COPYING' contains the full text of the GNU GPL.
92
93  Send inquiries, comments, bug reports, suggestions, patches, etc. to:
94
95      Underbit Technologies, Inc. <support@underbit.com>
96
97  See also the MAD home page on the Web:
98
99      http://www.underbit.com/products/mad/
100
101===============================================================================
102
103