--- a/README
+++ b/README
@@ -12,10 +12,10 @@
   dssi/dssi.h -- DSSI header file -- the comments define those parts
   of the spec dealing with host/plugin interaction (not covered in RFC)
+  dssi-jack-host/dssi-jack-host.c -- a simple JACK/ALSA-sequencer plugin host
   examples/dssi_osc_update.c -- simple DSSI OSC test programs
-  examples/dssi_example_host.c -- a basic example host implementation
   examples/trivial_synth.c -- a quite useless but fairly clear
   illustrative synth plugin
@@ -38,29 +38,39 @@
   ALSA 0.9/1.0.x
-  liblo-0.5 or above: http://www.plugin.org.uk/liblo/
+  liblo-0.9 or above: http://www.plugin.org.uk/liblo/
   pkgconfig with PKG_CONFIG_PATH set appropriately to pick up liblo
 To build the less_trivial_synth Qt GUI, you will need:
-  Qt 3 with QTDIR set appropriately
+  Qt 3
 To build the fluidsynth-dssi plugin and GUI, you will need:
-  FluidSynth 1.0.3 (libraries, headers, and source code)
+  FluidSynth 1.0.3 or newer (libraries, headers, and source code)
   GTK+ 1.2.x
-So long as PKG_CONFIG_PATH and QTDIR are set appropriately, a "make"
-and "make install" in the top level directory should install the
-dssi.h header file and dssi.pc pkgconfig file, plus build and
-install everything in the examples directory.
+Run "make" from the top-level directory.  There is no configure script.
-To build FluidSynth-DSSI, you must first edit the Makefile in the
-fluidsynth-dssi directory.  Then "make" and "make install" will
-build and install it.
+You will need to ensure PKG_CONFIG_PATH is set correctly to locate the
+liblo.pc pkgconfig file.  You may also need to set the QTDIR and/or
+QTINCDIR variables, and FLUID for the location of the Fluidsynth
+sources if you want to build fluidsynth-dssi.  (FLUID should not be a
+relative path, and you _must_ build against the same version of
+fluidsynth as you have the library for installed.)
+For example, to build on Debian with my local fluidsynth source
+installation I use
+  FLUID=`pwd`/../fluidsynth-1.0.4-2 QTDIR=/usr QTINCDIR=/usr/include/qt3 make
+After compiling, optionally test the host and example plugins (see
+below) and then run "make install" from the top-level directory to
+install the dssi header, dssi.pc pkgconfig file, and the host and
+examples.  The default install prefix is /usr/local.
@@ -68,7 +78,7 @@
 Make sure JACK is running, cd to ./examples and run:
   $ export DSSI_PATH=`pwd`
-  $ ./dssi_example_host less_trivial_synth.so
+  $ ../jack-dssi-host/jack-dssi-host less_trivial_synth.so
 A synth GUI should pop up, with an ALSA sequencer input and JACK
 output (connected by default to the first alsa_pcm out).  If you
@@ -78,20 +88,20 @@
 73, 75 and 79 control release, attack, decay and sustain respectively
 (some keyboards already have controls set up for these values).
-What has actually happened (if it worked) is that the host process has
+What has actually happened (if it worked) is that the host has
 been started, has loaded the first synth plugin (labelled LTS) found
 in the given .so file, has located the GUI executable that the make
 procedure installed into examples/less_trivial_synth/LTS_qt,
 instantiated the plugin, started the GUI and is now managing the MIDI
 input from ALSA, control changes from the GUI and audio out to JACK.
-You may also run multiple synth instances simultaneously with the
-example host.  If you have built both the examples and
-FluidSynth-DSSI, and installed them to /usr/local, you may run:
+You may also run multiple synth instances simultaneously with this
+host.  If you have built both the examples and FluidSynth-DSSI, and
+installed them to /usr/local, you may run:
   $ export DSSI_PATH=/usr/local/lib/dssi
   $ export PATH=$PATH:/usr/local/bin     # if it's not there already
-  $ dssi_example_host -2 less_trivial_synth.so -3 fluidsynth-dssi.so
+  $ jack-dssi-host -2 less_trivial_synth.so -3 fluidsynth-dssi.so
 This will create two less_trivial_synth instances and three
 FluidSynth-DSSI instances.  Note that the instances are assigned
@@ -104,10 +114,15 @@
 The DSSI API itself (dssi.h) is licensed under the GNU Lesser General
 Public License.  See COPYING for details.
+The jack-dssi-host is provided under a BSD-style license.  This means
+you can do anything you want with it so long as you retain the
+copyright attribution and license information.  See the source files
+for details.
+FluidSynth-DSSI is provided under the GNU General Public License.  See
+fluidsynth-dssi/COPYING for details.
 Licensing for the files in the examples directory may vary: please
 check the individual files for details.  Most of them are in the
 public domain, which means you can use them for anything you want.
-FluidSynth-DSSI is licensed under the GNU General Public License.
-See fluidsynth-dssi/COPYING for details.