1cdb3e4f |
1 | This is the README accompanying the source code to Simon Tatham's |
e91825f8 |
2 | puzzle collection. The collection's web site is at |
3 | <http://www.chiark.greenend.org.uk/~sgtatham/puzzles/>. |
1cdb3e4f |
4 | |
5 | You should find several Makefiles in the source code: |
6 | |
8d79d5d9 |
7 | - `Makefile' should work under GNU make on Linux, provided you have |
8 | GTK installed to compile and link against. It builds GTK binaries |
9 | of the puzzle games. |
1cdb3e4f |
10 | |
11 | - `Makefile.vc' should work under MS Visual C++ on Windows. |
12 | |
13 | - `Makefile.cyg' should work under Cygwin / MinGW. With appropriate |
14 | tweaks and setting of TOOLPATH, it should work for both compiling |
15 | on Windows and cross-compiling on Unix. |
16 | |
8a771ea7 |
17 | - `Makefile.osx' should work under Mac OS X, provided the Xcode |
18 | tools are installed. It builds a single monolithic OS X |
19 | application capable of running any of the puzzles, or even more |
20 | than one of them at a time. |
21 | |
22 | Many of these Makefiles build a program called `nullgame' in |
1cdb3e4f |
23 | addition to the actual game binaries. This program doesn't do |
24 | anything; it's just a template for people to start from when adding |
25 | a new game to the collection, and it's compiled every time to ensure |
26 | that it _does_ compile and link successfully (because otherwise it |
27 | wouldn't be much use as a template). Once it's built, you can run it |
28 | if you really want to (but it's very boring), and then you should |
29 | ignore it. |
30 | |
31 | DO NOT EDIT THE MAKEFILES DIRECTLY, if you plan to send any changes |
32 | back to the maintainer. The makefiles are generated automatically by |
33 | the Perl script `mkfiles.pl' from the file `Recipe'. If you need to |
34 | change the makefiles as part of a patch, you should change Recipe |
35 | and/or mkfiles.pl. |
e91825f8 |
36 | |
8a771ea7 |
37 | The manual is provided in Windows Help format for the Windows build; |
38 | in text format for anyone who needs it; and in HTML for the Mac OS X |
39 | application and for the web site. It is generated from a Halibut |
40 | source file (puzzles.but), which is the preferred form for |
41 | modification. To generate the manual in other formats, rebuild it, |
e91825f8 |
42 | or learn about Halibut, visit the Halibut website at |
43 | <http://www.chiark.greenend.org.uk/~sgtatham/halibut/>. |