X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?a=blobdiff_plain;f=README;h=00830126e85a7f62775f28596a3bf272563ae240;hb=db313b3948d27244dd7c34c2609c66d6204d8931;hp=6b78774b0dec280f328f805fd474168c86cdc49f;hpb=a88d1a459c32efdff253364434fe3d5f91a90852;p=sgt-puzzles.git diff --git a/README b/README index 6b78774..0083012 100644 --- a/README +++ b/README @@ -1,14 +1,22 @@ 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 git repository, you won't find the Makefiles: they're +automatically generated by `mkfiles.pl', so run that to create them. - - `Makefile' should work under GNU make on Linux, provided you have - GTK installed to compile and link against. It builds GTK binaries - of the puzzle games. +The Makefiles include: - - `Makefile.vc' should work under MS Visual C++ on Windows. + - `Makefile.am', together with the static `configure.ac', is intended + as input to automake. Run `mkauto.sh' to turn these into a + configure script and Makefile.in, after which you can then run + `./configure' to create an actual Unix Makefile. + + - `Makefile.vc' should work under MS Visual C++ on Windows. Run + 'nmake /f Makefile.vc' in a Visual Studio command prompt. - `Makefile.cyg' should work under Cygwin / MinGW. With appropriate tweaks and setting of TOOLPATH, it should work for both compiling @@ -19,6 +27,9 @@ You should find several Makefiles in the source code: 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 @@ -30,9 +41,9 @@ 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 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 @@ -40,4 +51,4 @@ 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 -. +.