README
1@(#)README 1.3 01/04/13
2
3CDDB "classic" library for xmcd
4---------------------------------------------------------------------
5
6This directory contains source files for libcddb, which is a partial
7implementation of the Gracenote CDDB� API for UNIX. Internally this
8library uses the "classic" CDDB servers/protocol and therefore provides
9only a subset of the newer CDDB� features.
10
11This is the default CDDB library included with the xmcd/cda source
12code distribution. For those OS and platforms that an official
13Gracenote CDDB� library is available, a CDDB� support kit can be
14downloaded from the official xmcd web site. See the docs_d/INSTALL
15and docs_d/CDDB files for details.
16
17For the official xmcd/cda pre-compiled binary distributions, the
18Gracenote CDDB� library is used if it is available for your OS and
19platform. Otherwise, the xmcd/cda executables are statically
20linked with this library.
21
22Note that this library is compiled in archive (.a) form, while the
23official Gracenote CDDB� library is likely to be a shared library (.so).
24This means that once an xmcd/cda executable is linked to use this
25library, it will not use the Gracenote CDDB� shared library unless it is
26re-linked to dynamically use the latter.
27
28This library only implements a subset of the CDDB� API, enough to
29support xmcd/cda, but not enough to be a general purpose substitute for
30Gracenote's CDDB� library. This means that attempts at linking this
31library with other CDDB�-enabled applications would probably fail.
32
33Since xmcd/cda's use of the CDDB� API may change from version to
34version, this library is matched and supplied with each xmcd/cda
35release.
36
37The author of xmcd/cda <xmcd@amb.org> provides support for this library.
38However, please contact Gracenote <support@gracenote.com> for all issues
39with their official CDDB� library.
40
41