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