HACKING 1.69 KB
Newer Older
1 2 3
Note that these instructions are *not* necessary for distribution
tarballs; they have separate configure/build instructions.  

4
Building this package from subversion is mainly intended for developers.
5 6 7 8 9 10
General users should obtain official distribution packages; both
source and binary distributions are available at
http://www.icecast.org/

-----

11
These are *brief* instructions on how to build this package from subversion.
12 13
Yes, there are details left out.

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

17 18 19
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/.
20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39

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.  

   *** IF YOU ARE NOT BUILDING WITH GNU MAKE *AND* GCC: you must set
   the AUTOMAKE_FLAGS environment variable to "--include-deps"
   before running autogen.sh.  For example:

   csh% setenv AUTOMAKE_FLAGS --include-deps
   csh% ./autogen.sh
     or
   sh% AUTOMAKE_FLAGS=--include-deps ./autogen.sh

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
40
following files are modified (either manually or by a svn update):
41 42

	  configure.in
brendan's avatar
brendan committed
43
	  m4/*
44 45 46 47 48

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.