-this will download the code into the directory <code>ypp-sc-tools</code>,
-and build the software. (If your Linux is very up to date you may
-find that it complains that it doesn't know the command <kbd>git-core</kbd>.
-In that case, use <kbd>git core</kbd>, with a space, instead.)
+where <code>/path/to/yohoho/yohoho</code> is the location of the
+ordinary Puzzle Pirates startup script, which is normally
+<code>yohoho/yohoho</code> in your home directory.
+
+<h3>Installing on Windows</h3>
+
+Download
+<a href="http://www.greenend.org.uk/owen/free/jpctb-linkfarmer/jpctp-setup.exe">http://www.greenend.org.uk/owen/free/jpctb-linkfarmer/jpctp-setup.exe</a>
+and double-click on it. It will either:
+<nl>
+<li>Just work, in which case you'll have a new icon on your desktop which
+ runs Puzzle Pirates with JPCTB integrated.
+<li>Fail, and tell you what to do next. Usually this means installing a
+ Java Runtime Environment (or JVM) and then uninstalling and re-
+ installing Puzzle Pirates. (Don't worry about reinstalling; you
+ won't lose any of your pirates or pieces of eight!)
+</nl>
+
+<h3>Installing on Macs</h3>
+
+We believe that it should be straightforward for a MacOS developer or
+expert to get YARRG JPCTB working properly on MacOS but we have not
+been able to test this ourselves. The Linux installation method is
+probably the best starting point.
+
+<h2>How does it work? Is it a violation of the Terms of Service?</h2>
+
+YARRG JPCTB uses the Java Accessibility API, which is a part of the
+Java platform. It's an interface provided for making applications
+available to users with disabilities, for example for hooking in
+screen readers. This approach was helpfully suggested by a Ringer in
+the forums (to another developer of a third-party tool, wanting help
+getting information out of Duty Reports).