X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~yarrgweb/git?p=jarrg-ian.git;a=blobdiff_plain;f=README;h=c7528e3621d4003eb93273805ef139b663028232;hp=5f4d8111d19255ac7edf02e73ff3dd7b73bab0cb;hb=fdf8031c1556b47f0e3e4cefb9f49b1ea247f32b;hpb=9a81a4cb4eb8cf5b8f0a781f3f1c6c14c79c44ac diff --git a/README b/README index 5f4d811..c7528e3 100644 --- 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.