summaryrefslogtreecommitdiffstats
path: root/audio/caps/UPGRADE.txt
diff options
context:
space:
mode:
Diffstat (limited to 'audio/caps/UPGRADE.txt')
-rw-r--r--audio/caps/UPGRADE.txt62
1 files changed, 43 insertions, 19 deletions
diff --git a/audio/caps/UPGRADE.txt b/audio/caps/UPGRADE.txt
index b7d3b27e5c..206028d4db 100644
--- a/audio/caps/UPGRADE.txt
+++ b/audio/caps/UPGRADE.txt
@@ -1,32 +1,56 @@
+Upgrade notes:
-0.9.24 upgrade notes:
+It's a terrible idea to upgrade plugins while running programs are
+still using them. Make sure you exit any application(s) that use the
+caps plugins before upgrading.
-Some of the plugin names and/or their parameters have changed since the
-old (0.9.7 or 0.9.20) SlackBuild.
-
-If you're upgrading from 0.9.7, be aware that any of your scripts
+Plugin names and parameters can and do change, between caps releases. If
+you're upgrading from an older version, be aware that any of your scripts
or projects that use caps (e.g. Ardour sessions, or jack-rack presets)
-will need updating. For Ardour 2.x, if the changes prevent your session
-from loading, try:
+might need updating, especially if you're upgrading from a really old
+version.
+
+For Ardour, if the changes prevent your session from loading, try:
- Make a backup of your session directory (done with cp or tar, whatever).
-- Start ardour2 with the -d (or --disable-plugins) option, load the session.
+- Start ardour3 with the -d (or --disable-plugins) option.
+- Load the session.
- Remove the offending plugins from their tracks or busses.
-- Save and exit
-- Start ardour2 normally, load the session.
-- Add the plugins back.
+- Save the session.
+- Exit Ardour.
+- Start ardour3 normally.
+- Load the session again.
+- Add the plugins back. Manually.
-If all else fails and you want to downgrade back to 0.9.7, you can
-still build it with this SlackBuild. Upstream removed the 0.9.7
-source from their site, but there's a copy here:
+If all else fails and you want to downgrade back to an older version,
+you can still build many of them with this SlackBuild. Upstream removes
+the old sources from their site, but there are several versions archived
+here:
http://urchlay.naptime.net/~urchlay/src/caps_0.9.7.tar.bz2
-
-Build with: VERSION=0.9.7 DOCS=no ./caps.SlackBuild
-
-You can still build 0.9.20 as well:
+[no documentation available for 0.9.7; package won't contain docs]
http://urchlay.naptime.net/~urchlay/src/caps_0.9.20.tar.bz2
http://urchlay.naptime.net/~urchlay/src/caps-doc-unofficial_0.9.20.tar.bz2
-Build with: VERSION=0.9.20 ./caps.SlackBuild
+http://urchlay.naptime.net/~urchlay/src/caps_0.9.24.tar.bz2
+http://urchlay.naptime.net/~urchlay/src/caps-doc-unofficial_0.9.24.tar.bz2
+
+Build with a command like:
+
+ root@box:caps# VERSION=0.9.7 ./caps.SlackBuild
+
+md5sums of the above files:
+
+7eea7c1f30363cca78f600544de271f4 caps-doc-unofficial_0.9.20.tar.bz2
+58eec76a6db744e13539101dd1f7c647 caps-doc-unofficial_0.9.24.tar.bz2
+0bb3935f6747a7087ca32a67bd0d8793 caps_0.9.20.tar.bz2
+c1d634038dcb54702306c0e30cb1c626 caps_0.9.24.tar.bz2
+d74582d3ae7a4244d3a77501693bbdf3 caps_0.9.7.tar.bz2
+
+Other old versions not listed here may work, but haven't been tested.
+
+At some point, I may be forced to change the SlackBuild in a way that
+will break compatibility with old versions. If that happens, and you
+still need an old version, please let me know (at the email address in
+the .info file).