chiark / gitweb /
Advertise user-configurable cmake-time config options.
authorSimon Tatham <anakin@pobox.com>
Sun, 4 Apr 2021 13:58:39 +0000 (14:58 +0100)
committerSimon Tatham <anakin@pobox.com>
Sun, 4 Apr 2021 13:58:39 +0000 (14:58 +0100)
commitc0c64dc1051bcbdd3ffe839f63d6c609ea5954e6
treec50ae63b962c511ec7b6b380f978d0109afb5f49
parentc212b4eda364ba17f2ff34f4958bfb49d0de258c
Advertise user-configurable cmake-time config options.

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.
cmake/platforms/unix.cmake
cmake/setup.cmake