| BUILD_TESTING | |
| ------------- | |
| Control whether the :module:`CTest` module invokes :command:`enable_testing`. | |
| The :module:`CTest` module, when loaded by ``include(CTest)``, | |
| runs code of the form: | |
| .. code-block:: cmake | |
| option(BUILD_TESTING "..." ON) | |
| if (BUILD_TESTING) | |
| # ... | |
| enable_testing() | |
| # ... | |
| endif() | |
| This creates a ``BUILD_TESTING`` option that controls whether the | |
| :command:`enable_testing` command is invoked to enable generation | |
| of tests to run using :manual:`ctest(1)`. See the :command:`add_test` | |
| command to create tests. | |
| .. note:: | |
| Call ``include(CTest)`` in the top-level source directory since | |
| :manual:`ctest(1)` expects to find a test file in the top-level | |
| build directory. |