chiark / gitweb /
debug write out deduped.tsv.gz not deduped.tsv
[jarrg-ian.git] / README
diff --git a/README b/README
index 5f4d8111d19255ac7edf02e73ff3dd7b73bab0cb..c7528e3621d4003eb93273805ef139b663028232 100644 (file)
--- a/README
+++ b/README
@@ -1,34 +1,65 @@
-JPCTB - a client for uploading to Yarrg and PCTB
+JARRG - a client for uploading to Yarrg and PCTB
 ================================================
 
+See the YARRG website for more information:
+  http://yarrg.chiark.net/upload
+
 Linux
 -----
 
-To run on Linux run this command from wherever you unpacked the JPCTB
+To run on Linux run this command from wherever you unpacked the JARRG
 distribution:
 
-./jpctb /path/to/dir/with/PCTB*.jar /path/to/yohoho/yohoho
+./jarrg /path/to/yohoho/yohoho
+
 
 Windows
 -------
 
-On Windows, double-click windows-setup.vbs to install JPCTB.  It will do
+On Windows, double-click jarrg-setup.exe to install JARRG.  It will do
 one of two things:
 
 1) Just work, in which case you'll have a new icon on your desktop which
-   runs Puzzle Pirates with JPCTB integrated
+   runs Puzzle Pirates with JARRG integrated
 
 2) 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!)
 
+
 Source
 ------
 
 To build from source you will need a Java SDK, version 6, and Apache
-ant.
+ant, as well as NSIS to build the Windows installer package.
+
+You can run the script "build-sh" do to the build:
+  ./build-sh
+
+It will create in the current directory (the top level of the build)
+the .jar files for JARRG and also the two distribution files:
+  jarrg-setup.exe   the installer for windows users
+  jarrg.tar.gz      a filtered tarball of this whole directory, for linux users
+
+Currently the build only seems to work with the Sun JDK, so the script
+sets JAVA_HOME to /usr/lib/jvm/java-6-sun.  If that's not what you
+want, set JAVA_HOME yourself.
+
+To make shipping the files a bit easier it prints a rune for rsyncing
+the files to the test version on the distribution site.  You can set
+JARRG_PUBLISH_BASE and ..._DIR to control the exact output.
+
+If you want to clean out the build directory to make sure you get a
+rebuild from scratch, say
+  git-clean -x -f -d
+
+
+Bugs
+----
+
+Current known bugs include:
 
-cd src
-ant -f PCTB.xml
+* Does not work from the Booty Pillaged screen, even though that has a
+  buy/sell commodities interface.