X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/puzzles/blobdiff_plain/e91825f8e43648bf129dae18809ee2e38af70d33..HEAD:/README diff --git a/README b/README index deded6b..efa7927 100644 --- a/README +++ b/README @@ -2,7 +2,13 @@ This is the README accompanying the source code to Simon Tatham's puzzle collection. The collection's web site is at . -You should find several Makefiles in the source code: +If you've obtained the source code by downloading a .tar.gz archive +from the Puzzles web site, you should find several Makefiles in the +source code. However, if you've checked the source code out from the +Puzzles Subversion repository, you won't find the Makefiles: they're +automatically generated by `mkfiles.pl', so run that to create them. + +The Makefiles include: - `Makefile' should work under GNU make on Linux, provided you have GTK installed to compile and link against. It builds GTK binaries @@ -14,7 +20,15 @@ You should find several Makefiles in the source code: tweaks and setting of TOOLPATH, it should work for both compiling on Windows and cross-compiling on Unix. -Each of these Makefiles builds a program called `nullgame' in + - `Makefile.osx' should work under Mac OS X, provided the Xcode + tools are installed. It builds a single monolithic OS X + application capable of running any of the puzzles, or even more + than one of them at a time. + + - `Makefile.wce' should work under MS eMbedded Visual C++ on + Windows and the Pocket PC SDK; it builds Pocket PC binaries. + +Many of these Makefiles build a program called `nullgame' in addition to the actual game binaries. This program doesn't do anything; it's just a template for people to start from when adding a new game to the collection, and it's compiled every time to ensure @@ -25,12 +39,14 @@ ignore it. DO NOT EDIT THE MAKEFILES DIRECTLY, if you plan to send any changes back to the maintainer. The makefiles are generated automatically by -the Perl script `mkfiles.pl' from the file `Recipe'. If you need to -change the makefiles as part of a patch, you should change Recipe -and/or mkfiles.pl. +the Perl script `mkfiles.pl' from the file `Recipe' and the various +.R files. If you need to change the makefiles as part of a patch, +you should change Recipe, *.R, and/or mkfiles.pl. -The manual, provided in Windows Help and text formats, is generated -from a Halibut source file (puzzles.but), which is the preferred form -for modification. To generate the manual in other formats, rebuild it, +The manual is provided in Windows Help format for the Windows build; +in text format for anyone who needs it; and in HTML for the Mac OS X +application and for the web site. It is generated from a Halibut +source file (puzzles.but), which is the preferred form for +modification. To generate the manual in other formats, rebuild it, or learn about Halibut, visit the Halibut website at .