annotate src/libid3tag-0.15.1b/README @ 169:223a55898ab9 tip default

Add null config files
author Chris Cannam <cannam@all-day-breakfast.com>
date Mon, 02 Mar 2020 14:03:47 +0000
parents 545efbb81310
children
rev   line source
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