1 2 libid3tag - ID3 tag manipulation library 3 Copyright (C) 2000-2003 Underbit Technologies, Inc. 4 5 $Id: README,v 1.4 2003/06/05 02:48:13 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