playrtp junks old sample data in fill_buffer()

[disorder] / README

diff --git a/README b/README
index 193aaf94b9872bbdd46501f3d67876d937417284..414e8f57ea9e63f031390e6ba74ee57aa22794dc 100644 (file)
--- a/README
+++ b/README
@@ -41,6 +41,11 @@ Development dependencies (only developers will need these):
   Libtool          1.5.6               1.4 not good enough
   Bazaar (bzr)
 
+On Debian you might ensure you have the required packages as follows:
+  apt-get install gcc libc-dev automake autoconf libtool libgtk2.0-dev \
+                  libgc-dev libgcrypt-dev libpcre3-dev libvorbis-dev \
+                  libao-dev libmad0-dev libasound2-dev libdb-dev
+
 Mailing lists:
   http://www.chiark.greenend.org.uk/mailman/listinfo/sgo-software-discuss
    - discussion of DisOrder (and other software), bug reports, etc
@@ -113,6 +118,9 @@ NOTE: If you are upgrading from an earlier version, see README.upgrades.
 
    See disorder_config(5) for more details.
 
+   See README.raw for details on setting up "raw format" players, which allow
+   for pausing and gapless play.
+
 5. Create /etc/disorder/config.private.  This should be readable only by the
    jukebox group:
 
@@ -130,10 +138,20 @@ NOTE: If you are upgrading from an earlier version, see README.upgrades.
 
    See disorderd(8) and disorder_config(5) for more details.
 
-6. Make sure the server is started at boot time.  On many Linux systems,
-   examples/disorder.init should be more or less suitable; install it in
-   /etc/init.d, adapting it as necessary, and make appropriate links from
-   /etc/rc[0-6].d.  If you have a BSD style init then you are on your own.
+6. Make sure the server is started at boot time.
+
+   On many Linux systems, examples/disorder.init should be more or less
+   suitable; install it in /etc/init.d, adapting it as necessary, and make
+   appropriate links from /etc/rc[0-6].d.
+
+   For Mac OS X 10.4, a suitable plist file is automatically installed.  The
+   command:
+
+    sudo launchctl list
+
+   ...should show "uk.org.greenend.rjk.disorder" (among other things).
+
+   If you have a some other init system then you are on your own.
 
 7. Make sure the state directory (/var/disorder or /usr/local/var/disorder or
    as determined by configure) exists and is writable by the jukebox user.
@@ -141,10 +159,19 @@ NOTE: If you are upgrading from an earlier version, see README.upgrades.
      mkdir -m 755 /var/disorder
      chown disorder:root /var/disorder
 
-8. Start the server, for instance:
+   If you want to use some other directory you must put use the 'home' command
+   in the configuration file.
+
+8. Start the server.
+
+   On Linux systems with sysv-style init:
 
      /etc/init.d/disorder start
 
+   On Mac OS X 10.4:
+
+     sudo launchctl start uk.org.greenend.rjk.disorder
+
    By default disorderd logs to daemon.*; check your syslog.conf to see where
    this ends up and look for log messages from disorderd there.  If it didn't
    start up correctly there should be an error message.  Correct the problem