update to snapshot spandsp-20090128

git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@11535 d0543943-73ff-0310-b7d9-9358b9ac24b2

INSTALL

@@ -1,3 +1,76 @@
+Building and installing spandsp
+===============================
+
+A number of distributions include spandsp, but they usually use older versions
+of the library, which lack a lot of the features of the current version. Before
+installing spandsp, make sure there are no older versions already on your
+machine. Make sure libtiff is installed on your machine. Versions 3.5.7,
+3.6.0, 3.7.1 and 3.8.2 seem to work OK. There have been several bugs related
+to FAX document handling in some versions of libtiff. Also, some people have
+had trouble using spandsp because they had more than one version of libtiff
+on their machine. Take care with this. If you are using an RPM based system,
+such as RedHat or Fedora, you will need the libtiff and libtiff-devel RPMs
+installed to be able to build spandsp.
+
+You can use the usual:
+
+    ./configure
+    make
+    make install
+
+process to build the spandsp library. Note that if you use configure in this
+way, the software will be installed in /usr/local. In this case make sure your
+/etc/ld.so.conf file has an entry for /usr/local/lib. If you wish the software
+to be installed in /usr, you should build it with the commands.
+
+    ./configure --prefix=/usr
+    make
+    make install
+
+
+Building the programming documentation
+======================================
+
+If you wish to build the programming documentation for spandsp, configure
+spandsp with:
+
+    ./configure --enable-doc
+
+You need doxygen installed on your machine.
+
+
+Building the test suite
+=======================
+
+Most sections of the spandsp library have an accompanying test program in the
+test directory. If you wish to build these test programs, configure spandsp
+with:
+
+    ./configure --enable-tests
+
+To build these tests you will need libaudiofile installed on your machine. To
+build the modem tests, with the GUI monitoring feature you will need Fltk 1.1.4
+or later, an audio meter module and a cartesian plotting module. Fltk may be
+obtained from http://www.fltk.org. The audio meter module may be obtained from
+http://www.soft-switch.org/downloads/Fl_Audio_Meter.tgz . The cartesian plotting
+module may be obtained from http://134.226.68.29/fltk. However, there is no
+suitable makefile supplied with that. You can find a version at
+http://www.soft-switch.org/downloads/Fl_Cartesian.tgz which will build as a
+Linux library. The actual code in both these versions is identical.
+You need to have Fltk 1.1.4 or later installed before building the plotting
+library.
+
+
+Applications
+============
+
+Applications support for spandsp is built into packages such as Callweaver,
+FreeSwitch and iaxmodem. Code to add spandsp based FAX support to Asterisk may
+be found at http://sourceforge.net/projects/agx-ast-addons.
+
+
+
+
 Basic Installation
 ==================
 

Makefile.am

@@ -16,7 +16,7 @@
 ## License along with this program; if not, write to the Free Software
 ## Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 ##
-## $Id: Makefile.am,v 1.44 2008/09/28 14:36:25 steveu Exp $
+## $Id: Makefile.am,v 1.45 2008/11/28 12:41:25 steveu Exp $
 
 AM_CFLAGS = $(COMP_VENDOR_CFLAGS)
 AM_LDFLAGS = $(COMP_VENDOR_LDFLAGS)
@@ -28,6 +28,7 @@ MAINTAINERCLEANFILES = Makefile.in
 EXTRA_DIST = autogen.sh \
              DueDiligence \
              README.testdata \
+             spandsp.pc \
              spandsp.spec \
              wrapper.xsl \
              unpack_g722_data.sh \
@@ -60,6 +61,9 @@ SUBDIRS = src $(MAYBE_DOC) $(MAYBE_TESTS) $(MAYBE_TESTDATA)
 
 DIST_SUBDIRS = src doc spandsp-sim tests test-data
 
+pkgconfigdir = $(libdir)/pkgconfig
+pkgconfig_DATA = spandsp.pc
+
 faq: faq.xml
 	cd faq ; xsltproc ../wrapper.xsl ../faq.xml
 

README

@@ -1,4 +1,4 @@
-spandsp 0.0.4 - A DSP library for telephony
+spandsp 0.0.5 - A DSP library for telephony
 -------------------------------------------
 
 SpanDSP is a library of DSP functions for telephony, in the 8000 sample per
@@ -26,8 +26,8 @@ libaudiofile (and libaudiofile-devel) is required to build the test suite
 fftw (and fftw-devel) is required to build the test suite. Version 2 or 3 of
 FFTW may be used. Spandsp adapts to the differences between them.
 
-fltk (and fltk-devel), Fl_Cartesian and Fl_Audio_Meter are required to build the
-test suite with GUI interfaces for some of the tests. The tests will build
+fltk (and fltk-devel), Fl_Cartesian and Fl_Audio_Meter are required to build
+the test suite with GUI interfaces for some of the tests. The tests will build
 without these packages, but the GUI features will not be available.
 Fl_Cartesian and Fl_Audio_Meter can be downloaded from
 http://www.soft-switch.org/downloads.

configure.ac

@@ -16,7 +16,7 @@
 # License along with this program; if not, write to the Free Software
 # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 #
-# $Id: configure.ac,v 1.59 2008/09/16 15:21:52 steveu Exp $
+# $Id: configure.ac,v 1.64 2009/01/17 08:16:08 steveu Exp $
 
 # @start 1
 
@@ -30,7 +30,7 @@ m4_include(config/ax_c99_features.m4)
 
 SPANDSP_MAJOR_VERSION=0
 SPANDSP_MINOR_VERSION=0
-SPANDSP_MICRO_VERSION=5
+SPANDSP_MICRO_VERSION=6
 
 SPANDSP_LT_CURRENT=1
 SPANDSP_LT_REVISION=0
@@ -49,7 +49,7 @@ AC_CONFIG_HEADERS([src/config.h:config-h.in])
 AM_INIT_AUTOMAKE($PACKAGE, $VERSION)
 
 AC_CANONICAL_HOST
-AC_CANONICAL_BUILD
+#AC_CANONICAL_BUILD
 AC_PROG_CC
 AC_PROG_CXX
 AC_PROG_GCC_TRADITIONAL
@@ -237,7 +237,11 @@ if test "${build}" == "${host}"
 then
     case "${host}" in
     x86_64-*)
+        # X86_64 Linux machines may have both 64 bit and 32 bit libraries. We need to choose the right set
         AX_CHECK_REAL_FILE([${prefix}/lib64], libdir='$(exec_prefix)/lib64')
+        AX_CHECK_REAL_FILE([/usr/X11R6/lib64], [TESTLIBS="$TESTLIBS -L/usr/X11R6/lib64"], AC_CHECK_FILE([/usr/X11R6/lib], [TESTLIBS="$TESTLIBS -L/usr/X11R6/lib"]))
+        # The very oldest AMD 64 bit chips support SSE2, SSE and MMX
+        enable_sse2="yes"
         ;;
     esac
 fi
@@ -258,16 +262,6 @@ AC_SEARCH_LIBS([expf], [m], AC_DEFINE([HAVE_EXPF], [1], [Define to 1 if you have
 AC_SEARCH_LIBS([logf], [m], AC_DEFINE([HAVE_LOGF], [1], [Define to 1 if you have the logf() function.]))
 AC_SEARCH_LIBS([log10f], [m], AC_DEFINE([HAVE_LOG10F], [1], [Define to 1 if you have the log10f() function.]))
 
-if test "${build}" == "${host}"
-then
-    case "${host}" in
-    x86_64-*)
-        # X86_64 Linux machines may have both 64 bit and 32 bit libraries. We need to choose the right set
-        AX_CHECK_REAL_FILE([/usr/X11R6/lib64], [TESTLIBS="$TESTLIBS -L/usr/X11R6/lib64"], AC_CHECK_FILE([/usr/X11R6/lib], [TESTLIBS="$TESTLIBS -L/usr/X11R6/lib"]))
-        ;;
-    esac
-fi
-
 # Checks for libraries.
 AC_CHECK_LIB([tiff], [TIFFOpen], , AC_MSG_ERROR("Can't build without libtiff (does your system require a libtiff-devel package?)"), -lm)
 
@@ -373,57 +367,37 @@ AX_MISALIGNED_ACCESS_FAILS([$host],
     [AC_DEFINE([SPANDSP_MISALIGNED_ACCESS_FAILS], [1], [Do not expect a misaligned memory access to work correctly])
     SPANDSP_MISALIGNED_ACCESS_FAILS="#define SPANDSP_MISALIGNED_ACCESS_FAILS 1"],
     [SPANDSP_MISALIGNED_ACCESS_FAILS="#undef SPANDSP_MISALIGNED_ACCESS_FAILS"])
-if test "$enable_mmx" = "yes" ; then
-    AC_DEFINE([SPANDSP_USE_MMX], [1], [Use the MMX instruction set (i386 and x86_64 only).])
+
+if test "$enable_sse5" = "yes" ; then
+    AC_DEFINE([SPANDSP_USE_SSE5], [1], [Use the SSE5 instruction set (i386 and x86_64 only).])
+    enable_sse4a="yes"
 fi
-if test "$enable_sse" = "yes" ; then
-    AC_DEFINE([SPANDSP_USE_MMX], [1], [Use the MMX instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE], [1], [Use the SSE instruction set (i386 and x86_64 only).])
+if test "$enable_sse4a" = "yes" ; then
+    AC_DEFINE([SPANDSP_USE_SSE4A], [1], [Use the SSE4A instruction set (i386 and x86_64 only).])
+    enable_sse4_2="yes"
 fi
-if test "$enable_sse2" = "yes" ; then
-    AC_DEFINE([SPANDSP_USE_MMX], [1], [Use the MMX instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE], [1], [Use the SSE instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE2], [1], [Use the SSE2 instruction set (i386 and x86_64 only).])
+if test "$enable_sse4_2" = "yes" ; then
+    AC_DEFINE([SPANDSP_USE_SSE4_2], [1], [Use the SSE4.2 instruction set (i386 and x86_64 only).])
+    enable_sse4_1="yes"
 fi
-if test "$enable_sse3" = "yes" ; then
-    AC_DEFINE([SPANDSP_USE_MMX], [1], [Use the MMX instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE], [1], [Use the SSE instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE2], [1], [Use the SSE2 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE3], [1], [Use the SSE3 instruction set (i386 and x86_64 only).])
+if test "$enable_sse4_1" = "yes" ; then
     AC_DEFINE([SPANDSP_USE_SSE4_1], [1], [Use the SSE4.1 instruction set (i386 and x86_64 only).])
+    enable_sse3="yes"
 fi
-if test "$enable_sse4_1" = "yes" ; then
-    AC_DEFINE([SPANDSP_USE_MMX], [1], [Use the MMX instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE], [1], [Use the SSE instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE2], [1], [Use the SSE2 instruction set (i386 and x86_64 only).])
+if test "$enable_sse3" = "yes" ; then
     AC_DEFINE([SPANDSP_USE_SSE3], [1], [Use the SSE3 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE4_1], [1], [Use the SSE4.1 instruction set (i386 and x86_64 only).])
+    enable_sse2="yes"
 fi
-if test "$enable_sse4_2" = "yes" ; then
-    AC_DEFINE([SPANDSP_USE_MMX], [1], [Use the MMX instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE], [1], [Use the SSE instruction set (i386 and x86_64 only).])
+if test "$enable_sse2" = "yes" ; then
     AC_DEFINE([SPANDSP_USE_SSE2], [1], [Use the SSE2 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE3], [1], [Use the SSE3 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE4_1], [1], [Use the SSE4.1 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE4_2], [1], [Use the SSE4.2 instruction set (i386 and x86_64 only).])
+    enable_sse="yes"
 fi
-if test "$enable_sse4a" = "yes" ; then
-    AC_DEFINE([SPANDSP_USE_MMX], [1], [Use the MMX instruction set (i386 and x86_64 only).])
+if test "$enable_sse" = "yes" ; then
     AC_DEFINE([SPANDSP_USE_SSE], [1], [Use the SSE instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE2], [1], [Use the SSE2 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE3], [1], [Use the SSE3 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE4_1], [1], [Use the SSE4.1 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE4_2], [1], [Use the SSE4.2 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE4A], [1], [Use the SSE4A instruction set (i386 and x86_64 only).])
+    enable_mmx="yes"
 fi
-if test "$enable_sse5" = "yes" ; then
+if test "$enable_mmx" = "yes" ; then
     AC_DEFINE([SPANDSP_USE_MMX], [1], [Use the MMX instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE], [1], [Use the SSE instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE2], [1], [Use the SSE2 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE3], [1], [Use the SSE3 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE4_1], [1], [Use the SSE4.1 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE4_2], [1], [Use the SSE4.2 instruction set (i386 and x86_64 only).])
-    AC_DEFINE([SPANDSP_USE_SSE5], [1], [Use the SSE5 instruction set (i386 and x86_64 only).])
 fi
 
 AC_SUBST(CC_FOR_BUILD)
@@ -451,6 +425,7 @@ AC_CONFIG_FILES([Makefile
                  test-data/itu/fax/Makefile
                  test-data/local/Makefile
                  tests/Makefile
+                 spandsp.pc
                  spandsp.spec])
 
 AC_OUTPUT