- Minor changes to all 4 autogen.sh files (ao, off, vorbis, vorbis-tools) to

allow users to build with !(gcc && gmake) from CVS by adding the use of
the $AUTOMAKE_FLAGS environment variable.  (gcc && gmake) users will notice
no difference.
- Added HACKING file to all four projects that gives a brief description on
how to build the source from CVS.  Mainly: "cvs update.  ./autogen.sh.
./configure.  make.  Oongowa."

svn path=/trunk/ogg/; revision=1914

2 files changed, 49 insertions, 2 deletions

diff --git a/HACKING b/HACKING
new file mode 100644
index 0000000..f24284f
--- /dev/null
+++ b/HACKING
@@ -0,0 +1,47 @@
+Note that these instructions are *not* necessary for distribution
+tarballs; they have separate configure/build instructions.  
+
+Building this package from CVS is mainly intended for developers.
+General users should obtain office distribution packages; both source
+and binary distributions are available at http://www.vorbis.com/.
+
+-----
+
+These are *brief* instructions on how to build this package from CVS.
+Yes, there are details left out.
+
+There are generally four steps necessary when building from CVS (i.e.,
+a developer's copy):
+
+1. cvs checkout of the sources, or cvs update.  RTFM from your
+   favorite flavor of CVS documentation; information on the xiph.org
+   CVS repository can be found at http://www.xiph.org/cvs.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.  
+
+   *** IF YOU ARE NOT BUILDING WITH GNU MAKE *AND* GCC: you must set
+   the AUTOMAKE_FLAGS envirnoment 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
+following files are modified (either manually or by a cvs update):
+
+	  configure.in
+	  acinclude.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.
diff --git a/autogen.sh b/autogen.sh
index 20a18d4..4f92453 100755
--- a/autogen.sh
+++ b/autogen.sh
@@ -53,8 +53,8 @@ aclocal $ACLOCAL_FLAGS
 #autoheader
 echo "  libtoolize --automake"
 libtoolize --automake
-echo "  automake --add-missing"
-automake --add-missing 
+echo "  automake --add-missing $AUTOMAKE_FLAGS"
+automake --add-missing $AUTOMAKE_FLAGS 
 echo "  autoconf"
 autoconf