diff --git a/plugins/ladspa_effect/caps/Makefile.am b/plugins/ladspa_effect/caps/Makefile.am
index 97eb9dbb6..5b3bf6887 100644
--- a/plugins/ladspa_effect/caps/Makefile.am
+++ b/plugins/ladspa_effect/caps/Makefile.am
@@ -30,4 +30,4 @@ depend: $(SOURCES)
 
 all: caps.so
 
-EXTRA_DIST = $(SOURCES) $(HDRS)
+EXTRA_DIST = $(SOURCES) $(HDRS) $(wildcard README*)
diff --git a/plugins/ladspa_effect/caps/README.ardour b/plugins/ladspa_effect/caps/README.ardour
new file mode 100644
index 000000000..fcfa8e683
--- /dev/null
+++ b/plugins/ladspa_effect/caps/README.ardour
@@ -0,0 +1,41 @@
+
+Ardour Users: Notice and WARNING
+================================
+
+ALL the plugins in caps have been renamed as of caps-0.3.0. While this is 
+clearly within the bounds of the LADSPA specification, ardour will fail to 
+load caps plugins from earlier releases referenced in your existing session 
+files should you install caps-0.3.0 over a previous release.
+
+As a quick workaround, you can install caps with 
+
+# make alt-install
+
+which will install the plugins as 'caps-ng.so', leaving your existing 
+installation of caps intact so you can manually update your sessions within
+ardour to use the latest versions of the caps plugins.
+
+The downside is you're now stuck with two implementations of identical 
+plugins, and some hosts will (quite sensibly) complain about this. So after
+you're done updating your ardour sessions, installing caps under its rightful
+name of 'caps.so' is a good idea.
+
+As an alternative, you can also run a search-and-replace on your ardour
+session files. I'll be happy to help you there should you require 
+assistance, just drop me a mail.
+
+
+RDF metadata
+============
+
+Pete Leigh has graciously provided a RDF file that refines the user interface
+of the Cabinet and SweepVF plugins within ardour (adding labels to the SweepVF
+filter modes and the Cabinet speaker models to be precise). I have dabbled
+with these files so if they fail to work for you, it's all my fault.
+
+You should be able install the file on your system with
+
+# make rdf-install
+
+but be warned that I have set this up blindly. Tell me if it works for you.
+
diff --git a/plugins/ladspa_effect/caps/README.dist b/plugins/ladspa_effect/caps/README.dist
new file mode 100644
index 000000000..0f6d75b65
--- /dev/null
+++ b/plugins/ladspa_effect/caps/README.dist
@@ -0,0 +1,18 @@
+
+Distribution Notice for the caps audio plugin suite
+===================================================
+
+If you intend to package caps for redistribution PLEASE include the html 
+and pdf documentation files, and make clear to your users that they exist 
+and where to find them. 
+
+caps 0.3 Notice and WARNING
+===========================
+
+The 0.3 release has relabelled the SweepVF, Cabinet, Chorus, StereoChorus
+and Phaser plugins (appending an 'I' to their label to be precise). 
+Unfortunately, this might break some hosts' session files. Sorry about that.
+
+Ardour users are well-advised to read the file 'README.ardour' in this
+directory before installing caps 0.3.0.
+