From 881746789a489fad85aae8317555f73dbe261556 Mon Sep 17 00:00:00 2001 From: Franklin Wei Date: Sat, 29 Apr 2017 18:21:56 -0400 Subject: puzzles: refactor and resync with upstream This brings puzzles up-to-date with upstream revision 2d333750272c3967cfd5cd3677572cddeaad5932, though certain changes made by me, including cursor-only Untangle and some compilation fixes remain. Upstream code has been moved to its separate subdirectory and future syncs can be done by simply copying over the new sources. Change-Id: Ia6506ca5f78c3627165ea6791d38db414ace0804 --- apps/plugins/puzzles/src/README | 54 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 apps/plugins/puzzles/src/README (limited to 'apps/plugins/puzzles/src/README') diff --git a/apps/plugins/puzzles/src/README b/apps/plugins/puzzles/src/README new file mode 100644 index 0000000000..890db56771 --- /dev/null +++ b/apps/plugins/puzzles/src/README @@ -0,0 +1,54 @@ +This is the README accompanying the source code to Simon Tatham's +puzzle collection. The collection's web site is at +. + +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. + +The Makefiles include: + + - `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 + on Windows and cross-compiling on Unix. + + - `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 +that it _does_ compile and link successfully (because otherwise it +wouldn't be much use as a template). Once it's built, you can run it +if you really want to (but it's very boring), and then you should +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' 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 +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 +. -- cgit v1.2.3