CDman MUSIC CATALOG
-------------------

This directory contains music catalog files for CDman(1) and
cdplayer(1) [See note 1].  The music catalog stores titles, artists and
program information for Compact Discs.  When a CD is inserted in the
CD-ROM drive, CDman searches the music catalog for an entry containing
catalog information for that recording.  If it finds one, it displays
the information in its large display panel.  Data from the recording's
table of contents is used as the key for searching the music catalog.

See CDman(1) for details.

We recommend you install this catalog in the directory /usr/lib/cddb
and have your users put the following line in their .Xresources file:
[See Note 1]

	DATman*databasePath:	/usr/lib/cddb
	DATman*databaseCDir:	/usr/lib/cddb

If you want to keep the catalog write protected your users should put
the following lines in their .Xresources file so your users can add new
entries:

	DATman*databasePath:	${HOME}/.cddb:/usr/lib/cddb
	DATman*databaseCDir:	${HOME}/.cddb

[**IMPORTANT NOTICE: All versions of CDman prior to that in IRIX 5.0,
have a bug that makes the databasePath resource (and the CDDB_PATH
environment variable) useless.  Nothing in the path will be searched.
Only databaseCDir is searched.]

With a write protected catalog, you will have to periodically gather
the new entries from your users' private catalogs and add them to the
public database.

A user who simply wants his own private database would also use these
latter X resource settings.

The catalog consists of a set of ASCII files, with one file per catalog
entry.  The catalog is distributed as a compressed tar file
cd-catalog.tar.Z.  The distribution is updated on the 1st of each
month.  The file cd-catalog.changes.tar.Z contains entries added during
the past month.  The paths of the files in the tar archives are
relative to the parent directory "cddb".

New entries, in the same format as the distribution, (a uuencoded,
optionally compressed, tar file), can be emailed to
cd-catalog@sgi.sgi.com for inclusion in the master database.

Suggested Format for Entries
----------------------------

Most music genres are relative easy to catalog.  Our only
recommendation here is to follow the artist's lead in capitalization
and spelling of titles.  Classical music presents some unique problems
and is the focus of this section.  Our recommended format is:

    Title: <Title> '<Popular name>' [<key>, <opus or K number>]
    Artist: <composer>/<conductor>,<orchestra>,<recording year>/<soloist>,...
    Track Title: <movement>. <Title>

Examples:

   Title:
	Symphony No. 9 'Choral' [D-minor, op 125]
   Artist:
	Beethoven/Schmidt,Wiener Phil,1986/Sutherland,Horne,King
   Track Titles:
	I. Allegro ma non troppo, un poco maestoso
	II. Molto Vivace


[Note 1] A version of cdplayer that works correctly with this database
	 is available for ftp from sgi in the file
	 ~ftp/sgi/cd-catalog/cdplayer.tar.  The only previous version
	 of cdplayer that would work with this database was released in
	 IRIX 4.0.5MM (Media Mosaic).  Unfortunately, when Media Mosaic
	 was folded into 4.0.5F, the wrong version of cdplayer was put
	 in. The correct version will be released in IRIX 5.0.

	 The Media Mosaic version of cdplayer(1) does not understand
	 the X resource to locate the CD catalog and it has a couple of
	 other bugs related to handling the database.  Please install
	 the new version available for ftp as described above.

	 Earlier cdplayer(1) catalogs can be converted to the new
	 format.  using cddbcvt(1). See CDman(1) for details.

[Note 2] The catalog format allows for a different artist for each
	 track but the user interfaces do not yet let you enter more
	 than one artist per CD.

[Note To SGI Employees]
	 If you have access to the SGI network, don't make your own copy
	 of this catalog.  Instead NFS mount the master catalog from
	 newmedia.engr:/usr/local/lib/cddb so that we will automatically
	 collect your additions.