HACKING

Note that these instructions are *not* necessary for distribution
tarballs; they have separate configure/build instructions.  

Building this package from SVN is mainly intended for developers.
General users should obtain official distribution packages; both
source and binary distributions are available at
http://www.icecast.org/

-----

These are *brief* instructions on how to build this package from SVN.

There are generally four steps necessary when building from SVN (i.e.,
a developer's copy):

1. svn checkout of the sources, or svn update.  RTFM from your
   favorite flavor of SVN documentation; information on the xiph.org
   SVN repository can be found at http://www.xiph.org/svn.html.

2. [re-]generate files such as "configure" and "Makefile.in" with the
   GNU autoconf/automake tools.  Run the "autogen.sh" script to
   perform this step.  

3. Run configure.  There are several options available; see
   "./configure --help" for more information.

4. Run "make" to build the source.  

In general, steps 2 and 3 need to be re-run every time any of the
following files are modified (either manually or by a svn update):

    configure.in
    m4/*.m4

Running "make clean" after running steps 2 and 3 is generally also
advisable before running step 4.  It isn't *always* necessary, but
unless you understand the workings of autoconf/automake, it's safest
to just do it.

Note that the make allows for supplying compiler flags as well. eg
make CFLAGS='-static' will try the build linking against any static
libraries available. Also specific CPU optimisations can be supplied
this way.