</%doc>
<& docshead &>
+<%perl>
+my $url_base_base= 'http://yarrg.chiark.net/download/jpctb';
+my $download_version= 'test';
+my $url_base= "$url_base_base/$download_version";
+</%perl>
<h1>Uploading to YARRG</h1>
<p>
You will need to upload data yourself if there is no data for your
ocean or island, or the data that is there is too old. You should
-also upload when preparing trade run, as market conditions change and
+also upload when preparing a trade run, as market conditions change and
you want a plan based on recent data.
<p>
<p>
The JPCTB integration is done via fully supported Java Accessibility
-interfaces and without modifying the Puzzle Pirates client, and should
-not disturb the normal running of Puzzle Pirates. However, please
-make sure that if your YPP client misbehaves at all, you try running
-it in the vanilla way (without JPCTB integration) before asking for
-help. In particular, if the JPCTB startup does not work, but the
-ordinary Puzzle Pirates startup does, report the problem to us, not to
-Three Rings.
+interfaces, and should not disturb the normal running of Puzzle
+Pirates. However, please make sure that if your YPP client misbehaves
+at all, you try starting it in the vanilla way (without JPCTB
+integration) before asking for help. In particular, if the JPCTB
+startup does not work, but the ordinary Puzzle Pirates startup does,
+report the problem to us, not to Three Rings.
<h3>Installing and running on Linux</h3>
Download
-<a href="http://www.greenend.org.uk/owen/free/jpctb.tar.gz">http://www.greenend.org.uk/owen/free/jpctb.tar.gz</a>
-and unpack it. You run it from the command line. Change
-to the directory where you unpacked the tarball above, and then run
+<a href="<% $url_base %>/jpctb.tar.gz"><% $url_base %>/jpctb.tar.gz</a>
+and unpack it. You run jpctb from the command line. Change
+(<code>cd</code>) to the top level <code>jpctb</code> directory
+which was created when you unpacked the tarball, and then run
<pre>
./jpctb /path/to/yohoho/yohoho
</pre>
<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>
+<a href="<% $url_base %>/jpctb-setup.exe"><% $url_base %>/jpctb-setup.exe</a>
and double-click on it. It will either:
-<nl>
+<ol>
<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>
+</ol>
<h3>Installing on Macs</h3>
<p>
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).
+Java platform. It's a facility in Java, available for all Java
+programs, intended to help make applications available to users with
+disabilities: for example, it permits hooking in screen readers. The
+use of the Java Accessibility API 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).
<p>
<p>
-JPCTB works by running any unmodified copy of the YPP client but with
-a separate JVM (Java Virtual Machine) configured to use the
-appropriate accessibility plugin. We do this (rather than configuring
-the computer's main JVM to use the JPCTB accessibility plugin) so that
-it is still possible to launch Puzzle Pirates <em>without</em> JPCTB
-(for example, in case the JPCTB client should cause any kind of
-problem).
+JPCTB runs the unmodified Puzzle Pirates game, but with a separate
+copy of your system's JVM (Java Virtual Machine); that copy of the JVM
+is configured to use the JPCTB accessibility plugin. We do this
+(rather than configuring the computer's main JVM to use the
+accessibility plugin) to avoid interfering with other uses of Java on
+your computer - in particular, so that it is always possible to launch
+Puzzle Pirates <em>without</em> JPCTB (for example, in case the plugin
+should cause any kind of problem).
-<h2>Authorship and source code</h2>
+<h2>Authorship, source code and other versions</h2>
Thanks to Burninator for writing the core of the JPCTB client. Ian
Jackson and Owen Dunn adapted it to improve the installation setup (in
-particular, to more completely avoid modifying the YPP client's
-startup files, which Three Rings unsurprisingly objected to). Owen
-Dunn added support for uploading to YARRG and a Windows installer.
+particular, to avoid modifying any of the YPP client's startup files).
+Owen Dunn added support for uploading to YARRG, updated the build
+system, and wrote a Windows installer.
<p>
<p>
+The download directory can contains other versions (eg unreleased test
+versions), which you can see here:
+ <a href="<% $url_base_base %>/"><% $url_base_base %>/</a> .
+
+<p>
+
The source code for the downloadable released binaries is in the
-<a href="http://www.greenend.org.uk/owen/free/jpctb.tar.gz">Linux
+<a href="<% $url_base %>/jpctb.tar.gz">Linux
tarball</a>. We maintain YARRG JPCTB in git, and you can get
-recent and perhaps unreleased versions from
-<code>git://git.yarrg.chiark.net/jpctb.git</code>.
+source code for recent and perhaps unreleased versions from
+<code>git://git.yarrg.chiark.net/jpctb.git</code> and/or
+<code>git://git.chiark.greenend.org.uk/~ijackson/jpctb.git</code> .
</div>