============
I. Compiling

The libsndfile library has been successfully compiled under Linux and
Windows XP. It should work without problems on any Unix-like system (also on
MacOS X). Building for Windows works by means of the MinGW toolset.

To compile liba8cas, you'll need the libsndfile library installed (along
with header files). Homepage: http://www.mega-nerd.com/libsndfile/

You'll also need pkg-config, as it is used by the configure script to detect
the installation of libsndfile.

-------------------------------------------------------------
I.1 Compiling under Linux (and other POSIX-compliant systems)

1. Go to the liba8cas/ directory.

2. Check whether there's a file named "configure" in this directory. If not
(as in the case of getting the sources straight from the repository), you'll
have to create it yourself. For this operation you'll need Autoconf and
Automake. Get them at http://www.gnu.org/software/autoconf/ and
http://www.gnu.org/software/automake/ . Now run

    autoreconf -i

3. Run configure:

    ./configure

4. Run:

    make

A library should be built.

---------------------------
I.2 Compiling under Windows

liba8cas can be compiled using the MinGW and MSYS environment, much the same
way as under Linux. However a few peculiarities must be pointed out:

1. To install the sndfile library in MinGW, get a Win32 or Win64 installation
package from the libsndfile homepage. After installing go to the installation
directory and:
a) Copy sndfile.h to /mingw/include/ .
b) Copy libsndfile-1.dll to /mingw/bin AND to /mingw/lib/libsndfile.dll (note
the name change in the latter case).

2. To install pkg-config in MinGW, go to
http://www.gtk.org/download-windows.html and get the GLib runtime,
gettext-runtime and the pkg-config tool. Copy contents of these three archives'
bin/ and share/ directries to the equivalent directories under /mingw/ .

3. All of the steps in the Linux installation instructions also apply here,
although you'll probably want to add the "--prefix=/mingw" parameter when
calling configure, if you want to use the library for further developing in
MinGW (such as, building a8cas-tools).

================
II. Installation

1. To install the library and its header file, after compiling run:

    make install

Typically you'll need superuser privileges to run that command.
This will cause the libsndfile and header files to be installed.

Alternatively, run

    make install-strip

to install the library with debugging symbols removed.

2. To make the installed library available to programs intending to use it,
typically some additional actions are needed, like:
- running ldconfig, or
- adding LIBDIR to the LD_LIBRARY_PATH environment variable during program
  execution, or
- adding LIBDIR to the LD_RUN_PATH environment variable during program linking.
Also, make sure that the a8cas.m4 file installed with the library is
accessible for Automake (see "dirlist" at
http://www.gnu.org/s/hello/manual/automake/Macro-Search-Path.html ).

III. Uninstallation

Remove the library and header files from your system by invoking in the
liba8cas compilation directory:

    make uninstall
