chiark / gitweb /
configure.ac, acinclude.m4, lib/regexp.[ch]: Support `libpcre2'.
[disorder] / README
diff --git a/README b/README
index a8f88c2b0c8d7ac63c4c6c5dfdad08118c5e78d6..1be8298aedcaf9160462d7c0653dbdeebf27164f 100644 (file)
--- a/README
+++ b/README
@@ -28,13 +28,13 @@ Build dependencies:
   libdb            4.5.20      not 4.6; 4.[78] seem to be ok
   libgc            6.8
   libvorbisfile    1.2.0
-  libpcre          7.6         need UTF-8 support
+  libpcre          10.22 or 7.6 need UTF-8 support
   libmad           0.15.1b
   libgcrypt        1.4.1
   libasound        1.0.16
   libFLAC          1.2.1
-  libsamplerate    0.1.4       currently optional
-  GStreamer        0.10        currently optional
+  libsamplerate    0.1.4       currently optional but strongly recommended
+  GStreamer        1.10.4 or 0.10.36 currently optional
   GNU C            4.2.1       }
   GNU Make         3.81        } Non-GNU versions will NOT work
   GNU Sed          4.1.5       }
@@ -45,6 +45,15 @@ Build dependencies:
 "Tested" means I've built against that version; earlier or later versions will
 often work too.
 
+If you don't have libsamplerate then DisOrder will try to run sox(1) to do
+sample-rate and channel conversion.  Unfortunately, sox has a tendency to
+change its command-line options incompatibly every few years.  Rather than
+chase this moving target by supporting the new options introduced in 14.2,
+I'm declaring DisOrder's sox support to be deprecated -- though (unlike
+sox's policy) it won't actually go away until the next major version.
+Alternatives include building against libsamplerate, or using GStreamer's
+audio decoding instead of DisOrder's built-in decoders.
+
 For the web interface to work you will additionally need a web server.  I've
 had both Apache 1.3.x and 2.x working.  Anything that supports CGI should be
 OK.