mirror of
git://git.tartarus.org/simon/puzzles.git
synced 2025-04-22 16:32:13 -07:00
c0c64dc105
Various cmake variables that I was informally expecting users to set on the cmake command line (e.g. cmake -DSTRICT=ON, or cmake -DPUZZLES_GTK_VERSION=2) are now labelled explicitly with the CACHE tag, and provided with a documentation string indicating what they're for. One effect of this is that GUI-like interfaces to your cmake build directory, such as ccmake or cmake-gui, will show those variables explicitly to give you a hint that you might want to change them. Another is that when you do change them, cmake will recognise that it needs to redo the rest of its configuration. Previously, if you sat in an existing cmake build directory and did 'cmake -DSTRICT=ON .' followed by 'cmake -DSTRICT=OFF .', nothing would happen, even though you obviously meant it to.
This is the README accompanying the source code to Simon Tatham's puzzle collection. The collection's web site is at <https://www.chiark.greenend.org.uk/~sgtatham/puzzles/>. The puzzle collection is built using CMake <https://cmake.org/>. To compile in the simplest way (on any of Linux, Windows or Mac), run these commands in the source directory: cmake . cmake --build . 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 <https://www.chiark.greenend.org.uk/~sgtatham/halibut/>.