non-semantic changes to configure.ac to tidy up --help output, show d…

…efault settings clearly, update TODO (hah!) clean up and rename QUICK-INSTALL as BUILDING_FOR_LINUX_2.4_KERNEL since that is all it really is

git-svn-id: svn+ssh://jackaudio.org/trunk/jack@3116 0c269be4-1314-0410-8aa9-9f06e86f4224

AUTHORS

@@ -10,7 +10,7 @@ contributions to those discussions came from (in alphabetical order):
 Many other members of LAD contributed ideas to JACK, particularly
 Richard Guenther.
 
-CONTRIBUTORS
+CONTRIBUTORS (in rough chronological order)
 
 Paul Davis 
 	the principal author of the JACK API and of the
@@ -41,7 +41,9 @@ Melanie Thielker
 	aspects of both POSIX and System V APIs.  
 
 Stephane Letz 
-	ported JACK to Mac OS X.  
+	ported JACK to Mac OS X and Windows, reimplemented
+	JACK in C++ to give Jackdmp/JACK 2, lots of design
+	work, bug fixes and testing.
 
 Jussi Laako 
 	wrote the OSS driver interface.  
@@ -58,7 +60,7 @@ Rui Nuno Capela
 
 Karsten Wiese 
 	(with Rui) added US-X2Y USB device support to the
-	ALSA backend.  
+	ALSA backend, added read/write lock support.
 
 Lee Revell 
 	contributed statistical interfaces and much low-latency realtime testing.
@@ -87,5 +89,8 @@ Jacob Meuser
 Marc-Olivier Barre
 	help with netjack integration and cleanup
 
+Torben Hohn
+       wrote netjack, implemented mixed 64/32 bit support and bug fixes.
+
 Many others have contributed patches and/or test results, and we thank
 them all.

QUICK-INSTALL → BUILDING-FOR-LINUX-2.4-KERNEL

@@ -1,6 +1,9 @@
+Specific Instructions for a 2.4 Linux kernel
+--------------------------------------------
 
- Quick Install Guide
----------------------
+Before using JACK in realtime mode with a 2.4 kernel, you may
+need or want to take the following steps. A better choice is
+to use a 2.6 kernel.
 
 1) in /usr/src/linux/include/linux/capability.h find these lines
 
@@ -25,13 +28,8 @@
    ftp://ftp.kernel.org/pub/linux/libs/security/linux-privs/kernel-2.4/
 
 3) if you're using a journalling filesystem, mount some directory with
-   -t tmpfs and tell configure about it with --with-default-tmpdir
+   -t tmpfs and use this with JACK's configure step as the
+   argument to --with-default-tmpdir.
 
-4) configure with --enable-optimize --enable-capabilities and
-   --with-default-tmpdir=/where/ever
+4) use --enable-capabilities with JACK's configure step
 
-5) make
-
-6) as root, do 
-
-       make install

TODO

@@ -34,7 +34,6 @@ TODO before-1.0
 TODO post-1.0
 
 - jack session handling (taybin)
-- handle mixed-mode 64bit and 32bit clients (joq)
 - first client run without jackd becomes jackd (joq)
 - TBD
 
@@ -60,6 +59,7 @@ TO THINK ABOUT - no agreed timeline
 
 CLOSED (date,who,comment)
 
+- handle mixed-mode 64bit and 32bit clients (2008/10, done by torben)
 - don't build static libraries of drivers and ip-clients (2003/10/07,paul)
 - API to change buffer size (joq) (2003/10/07)
 - added code to enforce the 'bufsize==2^x' rule (taybin) (2003/8/28)

configure.ac

@@ -193,7 +193,7 @@ fi
 
 # look for system support for POSIX shm API
 AC_ARG_ENABLE(posix-shm,
-	AC_HELP_STRING([--enable-posix-shm], [use POSIX shm API]),
+	AC_HELP_STRING([--enable-posix-shm], [use POSIX shm API (default=auto)]),
 	[TRY_POSIX_SHM=$enableval])
 if test "x$TRY_POSIX_SHM" = "xyes"
 then
@@ -297,21 +297,21 @@ elif echo $target_cpu | egrep '(i.86|x86_64)' >/dev/null; then
     fi
 
     AC_ARG_ENABLE(optimization-by-compiler,
-	[  --enable-optimization-by-compiler  use compiler (NOT processor) capabilities to determine optimization flags],,
+	AC_HELP_STRING([--enable-optimization-by-compiler],[use compiler (NOT processor) capabilities to determine optimization flags (default=no)]),,
 	optimization_by_compiler=no
     )
 
     AC_ARG_ENABLE(optimization-by-cpu,
-	[  --enable-optimization-by-cpu  use processor capabilities to determine optimization flags],,
+	AC_HELP_STRING([--enable-optimization-by-cpu],[use processor capabilities to determine optimization flags (default=yes)]),,
 	optimization_by_cpu=yes
     )
 
     AC_ARG_ENABLE(mmx,
-	[  --enable-mmx            enable MMX support (default=auto)],,
+	AC_HELP_STRING([--enable-mmx],[enable MMX support (default=auto)]),,
 	enable_mmx=yes)
 
     AC_ARG_ENABLE(sse,
-	[  --enable-sse            enable SSE support (default=auto)],,
+	AC_HELP_STRING([--enable-sse],[enable SSE support (default=auto)]),,
 	enable_sse=$enable_mmx)
 
     if test "x$enable_mmx" = xyes; then
@@ -387,7 +387,7 @@ elif echo $target_cpu | egrep '(i.86|x86_64)' >/dev/null; then
 fi
 
 AC_ARG_ENABLE(dynsimd,
-    [  --enable-dynsimd        enable dynamic SIMD selection (default=no)],,
+	AC_HELP_STRING([--enable-dynsimd],[enable dynamic SIMD selection (default=no)]),,
     enable_dynsimd=no)
 
 if test "x$enable_dynsimd" = xyes; then
@@ -399,7 +399,7 @@ fi
 
 AC_ARG_ENABLE(optimize,
     AC_HELP_STRING([--enable-optimize],
-	[ask the compiler for its best optimizations]),
+	[optimize code, based on CPU or compiler, as separately selected (default=no)]),
     [ if test x$enable_optimize != xno ; then
 	JACK_CFLAGS="$JACK_CORE_CFLAGS $JACK_OPT_CFLAGS"
 	AC_MSG_WARN([optimization in use.........................])
@@ -422,21 +422,21 @@ CFLAGS=$JACK_CFLAGS
 # allow buffer resizing unless --disable-resize specified
 buffer_resizing=yes
 AC_ARG_ENABLE(resize,
-	AC_HELP_STRING([--enable-resize], [enable buffer resizing feature]),
+	AC_HELP_STRING([--enable-resize], [enable buffer resizing feature (default=yes)]),
         [ 
 	  if test x$enable_resize = xno ; then
 	  	buffer_resizing=no
 	  fi
-
-	  if test x$buffer_resizing != xno; then 
-	  	AC_DEFINE(DO_BUFFER_RESIZE,,[Enable buffer resizing])
-          fi
-         ]
+	 ]
 )
 
+if test x$buffer_resizing != xno; then 
+   AC_DEFINE(DO_BUFFER_RESIZE,,[Enable buffer resizing])
+fi
+
+
 AC_ARG_ENABLE(ensure-mlock,
-	AC_HELP_STRING([--enable-ensure-mlock],
-		[fail if unable to lock memory]),
+	AC_HELP_STRING([--enable-ensure-mlock], [server should fail if unable to lock memory (default=no)]),
         [ 
 	  if test x$enable_ensure_mlock != xno ; then
 	  	AC_DEFINE(ENSURE_MLOCK,,[Ensure that memory locking succeeds])
@@ -446,7 +446,7 @@ AC_ARG_ENABLE(ensure-mlock,
 
 AC_ARG_ENABLE(debug,
 	AC_HELP_STRING([--enable-debug],
-		[enable debugging messages in jackd and libjack]),
+		[enable debugging messages in jackd and libjack (default=no)]),
         [ 
 	  if test x$enable_debug != xno ; then
 	     AC_DEFINE(DEBUG_ENABLED,,[Enable debugging messages])
@@ -456,7 +456,7 @@ AC_ARG_ENABLE(debug,
 
 AC_ARG_ENABLE(timestamps,
 	AC_HELP_STRING([--enable-timestamps],
-		[allow clients to use the JACK timestamp API]),
+		[allow clients to use the JACK timestamp API (JACK developers only) (default=no)]),
         [ 
 	  if test x$enable_timestamps != xno ; then
 	  	AC_DEFINE(WITH_TIMESTAMPS,,[Enable JACK timestamp API])
@@ -466,7 +466,7 @@ AC_ARG_ENABLE(timestamps,
 
 AC_ARG_ENABLE(preemption-check,
 	AC_HELP_STRING([--enable-preemption-check],
-		[check for inappropriate realtime preemption]),
+		[check for inappropriate realtime preemption (requires a specially built Linux kernel) (default=no)]),
 		[
 		  if test x$enable_preemption_check != xno ; then
 			echo checking for realtime preemption bugs
@@ -478,7 +478,7 @@ AC_ARG_ENABLE(preemption-check,
 USE_CAPABILITIES=false
 
 AC_ARG_ENABLE(capabilities,
-              [  --enable-capabilities   !!! LINUX 2.4 KERNELS ONLY !!! use libcap to gain realtime scheduling priviledges],
+	AC_HELP_STRING([--enable-capabilities],[!!! LINUX 2.4 KERNELS ONLY !!! use libcap to gain realtime scheduling priviledges]),
               [ if test "x$enable_capabilities" != "xno" ; then
                     AC_CHECK_LIB(cap, capgetp,
                                  [AC_CHECK_HEADER(sys/capability.h,
@@ -506,7 +506,7 @@ AC_ARG_ENABLE(capabilities,
 
 with_oldtrans=yes
 AC_ARG_ENABLE(oldtrans,
-              [  --disable-oldtrans      remove old transport interfaces],
+	AC_HELP_STRING([--disable-oldtrans],[remove old transport interfaces (default=yes)]),
               [ if test "x$enable_oldtrans" = "xno" ; then
 		    with_oldtrans=no
 		fi 
@@ -518,13 +518,13 @@ fi
 
 STRIPPED_JACKD=false
 AC_ARG_ENABLE(stripped-jackd,
-              [  --enable-stripped-jackd strip jack before computing its md5 sum ],
-              [ if test "x$USE_CAPABILITIES" != "xtrue" ; then
+	AC_HELP_STRING([--enable-stripped-jackd],[strip jack before computing its md5 sum (useful only with Linux 2.4 kernel)]),
+              [ if test "x$USE_CAPABILITIES" != "xtrue" ; then	    
                     AC_MSG_WARN([*** capabilities not enabled, stripped jackd has no effect])
                 elif test "x$enable_stripped_jackd" != "xno"; then
-                    STRIPPED_JACKD=true
-                fi
-              ]
+                    STRIPPED_JACKD=true		    
+                fi  
+              ]	
 )
 
 # plugins go in the addon dir.
@@ -535,7 +535,7 @@ AS_AC_EXPAND(ADDON_DIR_EXPANDED,${libdir}/jack)
 AC_DEFINE_UNQUOTED(ADDON_DIR,"$ADDON_DIR_EXPANDED",[Directory for plugins])
 
 AC_ARG_WITH(html-dir,
-            [  --with-html-dir=PATH    where to install the html documentation])
+		AC_HELP_STRING([--with-html-dir=PATH],[where to install the html documentation]))
 
 if test "x$with_html_dir" = "x" ; then
     HTML_DIR='${pkgdatadir}'
@@ -548,7 +548,7 @@ AC_SUBST(HTML_DIR)
 
 # allow specifying default tmpdir
 AC_ARG_WITH(default-tmpdir,
-            [  --with-default-tmpdir=PATH    where jackd and clients will put tmp files (/dev/shm)])
+            AC_HELP_STRING([--with-default-tmpdir],[where jackd and clients will put tmp files (default=/dev/shm)]))
 
 if test "x$with_default_tmpdir" = "x" ; then
 	DEFAULT_TMP_DIR=$HOST_DEFAULT_TMP_DIR
@@ -564,7 +564,7 @@ AC_DEFINE_UNQUOTED(DEFAULT_TMP_DIR,"$DEFAULT_TMP_DIR",[Default tmp directory])
 test "x$USE_BARRIER" = "x" && USE_BARRIER="yes"
 AC_ARG_WITH(barrier,
 	AC_HELP_STRING([--without-barrier],
-		       [avoid using pthread barrier functions]),
+		       [avoid using pthread barrier functions (only used by OSS driver)]),
 	[ USE_BARRIER=$withval ])
 if test "x$USE_BARRIER" = "xyes"; then
 	AC_CHECK_LIB([pthread], [pthread_barrier_init],
@@ -599,8 +599,10 @@ fi
 
 JACK_DEFAULT_DRIVER=\"dummy\"
 
-AC_ARG_ENABLE(portaudio, [  --disable-portaudio     ignore PortAudio driver ],
-			TRY_PORTAUDIO=$enableval , TRY_PORTAUDIO=no ) 
+AC_ARG_ENABLE(portaudio,
+	AC_HELP_STRING([--enable-portaudio],[build PortAudio driver]),
+   TRY_PORTAUDIO=$enableval , TRY_PORTAUDIO=no)
+
 HAVE_PA="false"
 if test "x$TRY_PORTAUDIO" = "xyes"
 then
@@ -616,8 +618,8 @@ then
 fi
 AM_CONDITIONAL(HAVE_PA, $HAVE_PA)
 
-AC_ARG_ENABLE(coreaudio, [  --disable-coreaudio     ignore CoreAudio driver ],
-			TRY_COREAUDIO=$enableval , TRY_COREAUDIO=yes ) 
+AC_ARG_ENABLE(coreaudio, AC_HELP_STRING([--disable-coreaudio], [ignore CoreAudio driver]),
+			TRY_COREAUDIO=$enableval , TRY_COREAUDIO=yes )
 HAVE_COREAUDIO="false"
 if test "x$TRY_COREAUDIO" = "xyes"
 then
@@ -629,7 +631,7 @@ then
 fi
 AM_CONDITIONAL(HAVE_COREAUDIO, $HAVE_COREAUDIO)
 
-AC_ARG_ENABLE(oss, [  --disable-oss           ignore OSS driver ],
+AC_ARG_ENABLE(oss, AC_HELP_STRING([--disable-oss],[ignore OSS driver ]),
 			TRY_OSS=$enableval , TRY_OSS=yes ) 
 HAVE_OSS="false"
 if test "x$TRY_OSS" = "xyes"
@@ -641,7 +643,7 @@ then
 fi
 AM_CONDITIONAL(HAVE_OSS, $HAVE_OSS)
 
-AC_ARG_ENABLE(sun, [  --disable-sun           ignore Sun driver ],
+AC_ARG_ENABLE(sun, AC_HELP_STRING([--disable-sun],[ignore Sun driver ]),
 			TRY_SUN=$enableval , TRY_SUN=yes ) 
 HAVE_SUN="false"
 if test "x$TRY_SUN" = "xyes"
@@ -653,7 +655,7 @@ then
 fi
 AM_CONDITIONAL(HAVE_SUN, $HAVE_SUN)
 
-AC_ARG_ENABLE(freebob, [  --disable-freebob          ignore FreeBob driver ],
+AC_ARG_ENABLE(freebob, AC_HELP_STRING([--disable-freebob],[ignore FreeBob driver ]),
 			TRY_FREEBOB=$enableval , TRY_FREEBOB=yes ) 
 HAVE_FREEBOB="false"
 if test "x$TRY_FREEBOB" = "xyes"
@@ -670,7 +672,7 @@ then
 fi
 AM_CONDITIONAL(HAVE_FREEBOB,$HAVE_FREEBOB)
 
-AC_ARG_ENABLE(firewire, [  --disable-firewire          ignore FireWire driver (FFADO) ],
+AC_ARG_ENABLE(firewire, AC_HELP_STRING([--disable-firewire],[ignore FireWire driver (FFADO)]),
 			TRY_FIREWIRE=$enableval , TRY_FIREWIRE=yes ) 
 HAVE_FIREWIRE="false"
 if test "x$TRY_FIREWIRE" = "xyes"
@@ -687,7 +689,7 @@ then
 fi
 AM_CONDITIONAL(HAVE_FIREWIRE,$HAVE_FIREWIRE)
 
-AC_ARG_ENABLE(alsa, [  --disable-alsa          ignore ALSA driver ],
+AC_ARG_ENABLE(alsa, AC_HELP_STRING([--disable-alsa],[ignore ALSA driver ]),
 			TRY_ALSA=$enableval , TRY_ALSA=yes ) 
 HAVE_ALSA="false"
 if test "x$TRY_ALSA" = "xyes"
@@ -807,6 +809,7 @@ echo \| Build with Sun audio support.......................... : $HAVE_SUN
 echo \| Build with CoreAudio support.......................... : $HAVE_COREAUDIO
 echo \| Build with PortAudio support.......................... : $HAVE_PA
 echo \| Build with NetJack support............................ : $HAVE_SAMPLERATE
+echo \| Build with dynamic buffer size support................ : $buffer_resizing
 echo \| Compiler optimization flags........................... : $JACK_OPT_CFLAGS
 echo \| Compiler full flags................................... : $CFLAGS
 echo \| Install dir for libjack + backends.................... : $libdir/jack