MADHOUSE -- A wacky insane wrapper for MAD library

GENERAL
=======

Madhouse is a wrapper library to libmad, an MP3 decoder library.
It allows to build a package without the real libmad.  The resultant
binary can be installed and run even without libmad itself.  When any
libmad function is accessed, the function is automatically retrieved
from the real libmad shared library.  So, it's a kind of dynamic
linker to libmad.

When installing libmadhouse, a new libmad.so file is created as a
symlink to libmadhouse.so.*.  Also, mad.pc is installed to pkg-config
directory so that packages using libmad can be built without modifying
anything.  If you want to link explicitly with libmadhouse (or want to
install the real libmad-devel package together), just link with
-lmadhouse or use madhouse.pc for pkg-config.

The libmadhouse uses dlopen & co.  The libdl will be automatically
dragged in with libmadhouse as default.  If you need any special
linker setup, pass -ldl explicitly.


NEW FUNCTIONS
=============

There are the following two additional madhouse-specific functions:

- int madhouse_is_available(void);

  It returns 1 if libmad is really available, or 0 if not.  You can
  check this before actually using any MAD functions, e.g. indicating
  an error via a dialog window.

- int madhouse_set_path(const char *path);
  
  This specifies the path of libmad.so explicitly in case when it's 
  installed to any non-default path.  Passing NULL resets to the
  default path given or guessed by configure script.

LICENSE
=======

Distributed under GPL v2.0 or later, just like libmad itself.
See COPYING.

AUTHOR
======

Takashi Iwai <tiwai@suse.de>

Partly containing codes from libmad-0.15.2b,
