chiark / gitweb /
Make top-level Mason components executable
[ypp-sc-tools.main.git] / yarrg / web / docs
1 %# This is part of the YARRG website.  YARRG is a tool and website
2 %# for assisting players of Yohoho Puzzle Pirates.
3 %#
4 %# Copyright (C) 2009 Ian Jackson <ijackson@chiark.greenend.org.uk>
5 %# Copyright (C) 2009 Clare Boothby
6 %#
7 %#  YARRG's client code etc. is covered by the ordinary GNU GPL (v3 or later).
8 %#  The YARRG website is covered by the GNU Affero GPL v3 or later, which
9 %#   basically means that every installation of the website will let you
10 %#   download the source.
11 %#
12 %# This program is free software: you can redistribute it and/or modify
13 %# it under the terms of the GNU Affero General Public License as
14 %# published by the Free Software Foundation, either version 3 of the
15 %# License, or (at your option) any later version.
16 %#
17 %# This program is distributed in the hope that it will be useful,
18 %# but WITHOUT ANY WARRANTY; without even the implied warranty of
19 %# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20 %# GNU Affero General Public License for more details.
21 %#
22 %# You should have received a copy of the GNU Affero General Public License
23 %# along with this program.  If not, see <http://www.gnu.org/licenses/>.
24 %#
25 %# Yohoho and Puzzle Pirates are probably trademarks of Three Rings and
26 %# are used without permission.  This program is not endorsed or
27 %# sponsored by Three Rings.
28 %#
29 %#
30 %# This Mason component generates the documentation.
31 %#
32 <html><head><title>YARRG (Yet Another Revenue Research Gatherer)</title>
33 </head><body>
34 <& webcopyright &>
35
36 <h1>Introduction to YARRG</h1>
37 YARRG (Yet Another Revenue Research Gatherer) is inspired by PCTB.
38
39 <h1>Results</h1>
40
41 The <a href="lookup">lookup page</a> gives access to the uploaded data.
42
43 <h1>Obtaining the client</h1>
44 The current official version of YARRG for use as a client can browsed here:
45  <a href="/~ijackson/ypp-sc-tools/master/">http://www.chiark.greenend.org.uk/~ijackson/ypp-sc-tools/master/</a>
46
47 <p>
48 See particularly the
49 <a href="/~ijackson/ypp-sc-tools/master/yarrg/README">YARRG README</a>.
50
51 <p>
52 To install the client, install the `git' version control system
53 and the other dependencies listed in the `Installation requirements'
54 section of the README and then run:
55 <pre>
56 git-clone http://www.chiark.greenend.org.uk/~ijackson/ypp-sc-tools/master/.git ypp-sc-tools
57 cd ypp-sc-tools
58 cd yarrg
59 make
60 </pre>
61 this will download the code into the directory <code>ypp-sc-tools</code>,
62 and build the software.
63
64 <p>
65 When new versions are released, you can:
66 <pre>
67 cd .../ypp-sc-tools
68 git-pull
69 </pre>
70 to fetch the new version.  
71
72 <h1>Free Software (aka Open Source)</h1>
73
74 YARRG is Free Software - you may share and modify it.  See the
75 licences for details.
76
77 <p>
78
79 Not only the client but also the webserver code is Free.  The website
80 code can be found in the same tree as above, in the <code>web</code>
81 directory.
82
83 <p>
84
85 But in case we have made changes but not yet pushed them
86 (perhaps because we haven't done a release), and to make it easy for
87 anyone else who runs a copy of the website to provide everyone with
88 the source for their version, you can download an up-to-date
89 <a href="source.tar.gz">tarball</a> of the
90 actually-running website code.
91
92 <p>
93
94 If you would like to run a (perhaps modified) copy of the YARRG
95 website it would be very easy for us to send you copies of updates
96 submitted by users of the official YARRG client, in the format
97 expected by the code you'll be running.  Please just ask us.
98
99 </html>
100
101 <& footer, isdocs => 1 &>