diff options
author | Franklin Wei <frankhwei536@gmail.com> | 2016-11-20 15:16:41 -0500 |
---|---|---|
committer | Franklin Wei <me@fwei.tk> | 2016-12-18 18:13:22 +0100 |
commit | 1a6a8b52f7aa4e2da6f4c34a0c743c760b8cfd99 (patch) | |
tree | 8e7f2d6b0cbdb5d15c13457b2c3e1de69f598440 /apps/plugins/puzzles/README | |
parent | 3ee79724f6fb033d50e26ef37b33d3f8cedf0c5b (diff) | |
download | rockbox-1a6a8b52f7aa4e2da6f4c34a0c743c760b8cfd99.tar.gz rockbox-1a6a8b52f7aa4e2da6f4c34a0c743c760b8cfd99.zip |
Port of Simon Tatham's Puzzle Collection
Original revision: 5123b1bf68777ffa86e651f178046b26a87cf2d9
MIT Licensed. Some games still crash and others are unplayable due to
issues with controls. Still need a "real" polygon filling algorithm.
Currently builds one plugin per puzzle (about 40 in total, around 100K
each on ARM), but can easily be made to build a single monolithic
overlay (800K or so on ARM).
The following games are at least partially broken for various reasons,
and have been disabled on this commit:
Cube: failed assertion with "Icosahedron" setting
Keen: input issues
Mines: weird stuff happens on target
Palisade: input issues
Solo: input issues, occasional crash on target
Towers: input issues
Undead: input issues
Unequal: input and drawing issues (concave polys)
Untangle: input issues
Features left to do:
- In-game help system
- Figure out the weird bugs
Change-Id: I7c69b6860ab115f973c8d76799502e9bb3d52368
Diffstat (limited to 'apps/plugins/puzzles/README')
-rw-r--r-- | apps/plugins/puzzles/README | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/apps/plugins/puzzles/README b/apps/plugins/puzzles/README new file mode 100644 index 0000000000..890db56771 --- /dev/null +++ b/apps/plugins/puzzles/README | |||
@@ -0,0 +1,54 @@ | |||
1 | This is the README accompanying the source code to Simon Tatham's | ||
2 | puzzle collection. The collection's web site is at | ||
3 | <http://www.chiark.greenend.org.uk/~sgtatham/puzzles/>. | ||
4 | |||
5 | If you've obtained the source code by downloading a .tar.gz archive | ||
6 | from the Puzzles web site, you should find several Makefiles in the | ||
7 | source code. However, if you've checked the source code out from the | ||
8 | Puzzles git repository, you won't find the Makefiles: they're | ||
9 | automatically generated by `mkfiles.pl', so run that to create them. | ||
10 | |||
11 | The Makefiles include: | ||
12 | |||
13 | - `Makefile.am', together with the static `configure.ac', is intended | ||
14 | as input to automake. Run `mkauto.sh' to turn these into a | ||
15 | configure script and Makefile.in, after which you can then run | ||
16 | `./configure' to create an actual Unix Makefile. | ||
17 | |||
18 | - `Makefile.vc' should work under MS Visual C++ on Windows. Run | ||
19 | 'nmake /f Makefile.vc' in a Visual Studio command prompt. | ||
20 | |||
21 | - `Makefile.cyg' should work under Cygwin / MinGW. With appropriate | ||
22 | tweaks and setting of TOOLPATH, it should work for both compiling | ||
23 | on Windows and cross-compiling on Unix. | ||
24 | |||
25 | - `Makefile.osx' should work under Mac OS X, provided the Xcode | ||
26 | tools are installed. It builds a single monolithic OS X | ||
27 | application capable of running any of the puzzles, or even more | ||
28 | than one of them at a time. | ||
29 | |||
30 | - `Makefile.wce' should work under MS eMbedded Visual C++ on | ||
31 | Windows and the Pocket PC SDK; it builds Pocket PC binaries. | ||
32 | |||
33 | Many of these Makefiles build a program called `nullgame' in | ||
34 | addition to the actual game binaries. This program doesn't do | ||
35 | anything; it's just a template for people to start from when adding | ||
36 | a new game to the collection, and it's compiled every time to ensure | ||
37 | that it _does_ compile and link successfully (because otherwise it | ||
38 | wouldn't be much use as a template). Once it's built, you can run it | ||
39 | if you really want to (but it's very boring), and then you should | ||
40 | ignore it. | ||
41 | |||
42 | DO NOT EDIT THE MAKEFILES DIRECTLY, if you plan to send any changes | ||
43 | back to the maintainer. The makefiles are generated automatically by | ||
44 | the Perl script `mkfiles.pl' from the file `Recipe' and the various | ||
45 | .R files. If you need to change the makefiles as part of a patch, | ||
46 | you should change Recipe, *.R, and/or mkfiles.pl. | ||
47 | |||
48 | The manual is provided in Windows Help format for the Windows build; | ||
49 | in text format for anyone who needs it; and in HTML for the Mac OS X | ||
50 | application and for the web site. It is generated from a Halibut | ||
51 | source file (puzzles.but), which is the preferred form for | ||
52 | modification. To generate the manual in other formats, rebuild it, | ||
53 | or learn about Halibut, visit the Halibut website at | ||
54 | <http://www.chiark.greenend.org.uk/~sgtatham/halibut/>. | ||