X-Git-Url: https://git.distorted.org.uk/~mdw/disorder/blobdiff_plain/1a208f3f41946d9aa3477570d8053dfd33845c31..ae2d64753ac4424c8e9172eb5be23e16aff0b530:/README

diff --git a/README b/README
index a8f88c2..92a3774 100644
--- a/README
+++ b/README
@@ -33,7 +33,7 @@ Build dependencies:
   libgcrypt        1.4.1
   libasound        1.0.16
   libFLAC          1.2.1
-  libsamplerate    0.1.4       currently optional
+  libsamplerate    0.1.4       currently optional but strongly recommended
   GStreamer        0.10        currently optional
   GNU C            4.2.1       }
   GNU Make         3.81        } Non-GNU versions will NOT work
@@ -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.