Installation instructions for cdcd
----------------------------------

 This file explains how to install cdcd from its sources.

   Note: If your system have a packaging system (rpm, deb, etc.), it
   is suggested that you use a cdcd package, in order to keep your
   system cleaner.  If there is no package corresponding to the latest
   version of cdcd, then you can (politely) ask the cdcd package
   maintainer to make it.  But the maintainers are, in general,
   volunteers: don't assume they will work as soon as you ask.
 
 This package is designed to be built with libcdaudio 0.99.1 or later.
 Previous versions of libcdaudio could work, but it is advised to
 upgrade.

 libcdaudio must be obtained seperately.  If you have not already
 downloaded it you may get it from the following location:

 http://libcdaudio.sourceforge.net/

 The latest version of libcdaudio, at the time of this writing, is
 0.99.5.

 You will need the Readline library, version 4.2 or higher, too.

================================================================
IMPORTANT NOTE ABOUT LIBRARIES:

 On the GNU/Linux system, and in some others, when a library is put on
 the filesystem, the dynamic loader must be told about that in order
 to make use of the library.  If there is a file /etc/ld.so.conf, then
 it is the case.

 Telling the new libraries information to the dynamic loader (ld) is
 done in two steps (the root rights are usually required, so use
 "su"):

 1. add the directory where the library resides in the /etc/ld.so.conf
    file (e.g. /usr/local/lib), if it is not already there.

 2. run ldconfig with no arguments.
================================================================

 Here are the steps required to install cdcd.

Step 1.

  Run the configuration script.  This script will configure the build
  for your compiler.

  Simply run:

  ./configure

  For systems using a different shell than bash or sh (e.g. csh), you
  will need to run:

  sh ./configure

  Be sure to watch the output from configure for anything abnormal.

Step 2.

  Run `make'.  This will build cdcd.

Step 3.

  Run `make install' as the super-user.  This will install cdcd under
  /usr/local/bin.  Make sure /usr/local/bin is in your PATH before
  running cdcd.

Step 4. (optional)

  Run `make clean'.  This will remove all object and binary files,
  leaving the source.  If you have no need for the source, you may
  simply delete it.  Note that you have to keep the source to be able
  to do a `make uninstall'.

That should do it.  You should be able to run cdcd just fine now.
