add a default BUILD target
[flac.git] / autogen.sh
index a666679..e3abe1f 100755 (executable)
@@ -1,22 +1,42 @@
 #!/bin/sh
 
-# 'hacks' is the place to put some commands you may need.  There are at
-# least two that seem to be necessary in some situations:
+# FLAC needs relatively recent versions of autotools for autogen.sh to
+# run properly.  For example, if your autoconf is too old, it will not
+# check for inttypes.h and compilation will fail later.  If you are
+# having problems with autogen.sh it is best to upgrade to at least the
+# following if possible:
 #
-# 1. Some (newer?) versions automake --add-missing --copy do not copy
-#    in ltmain.sh, maybe because this is now supposed to be done by
-#    libtoolize.
-# 2. FLAC uses iconv but not gettext.  iconv requires config.rpath which
+# - autoconf 2.59
+# - automake 1.8.5
+# - libtool 1.5.6
+#
+# You may need to specify -I /SOME_PATH/share/aclocal if the packages
+# FLAC relies on (autotools, libogg, libiconv) are installed in
+# non-standard places.
+#
+# If you don't have XMMS installed at all, you should comment out
+# AM_PATH_XMMS in configure.in.
+#
+# 'hacks' is the place to put some commands you may need.  There is one
+# that seems to be necessary in some situations:
+#
+#  * FLAC uses iconv but not gettext.  iconv requires config.rpath which
 #    is supplied by gettext, which is copied in by gettextize.  But we
 #    can't run gettextize since we do not fulfill all it's requirements
-#    (since we don't use it).
+#    (because we don't use it).
 #
-# If both these apply try:
+# If the default doesn't work, try:
 #
-#hacks="cp /usr/share/libtool/ltmain.sh . && cp /usr/share/gettext/config.rpath ."
+#hacks="cp /usr/share/gettext/config.rpath ."
 #
 # Otherwise, this is the no-op:
 hacks=true
 #
+# Also watchout, if you replace ltmain.sh, there is a bug in some
+# versions of libtool (or maybe autoconf) on some platforms where the
+# configure-generated libtool does not have $SED defined.  See also:
+#
+#   http://lists.gnu.org/archive/html/libtool/2003-11/msg00131.html
+#
 
-aclocal && autoconf && autoheader && $hacks && automake --foreign --include-deps --add-missing --copy
+aclocal && libtoolize && autoconf && autoheader && $hacks && automake --foreign --include-deps --add-missing --copy