README.rst 979 B

12345678910111213141516171819202122232425262728293031
  1. CMake Tests Directory
  2. *********************
  3. This directory contains the CMake test suite.
  4. See also the `CMake Source Code Guide`_.
  5. .. _`CMake Source Code Guide`: ../Help/dev/source.rst
  6. Many tests exist as immediate subdirectories, but some tests
  7. are organized as follows.
  8. * ``CMakeLib/``:
  9. Source code, used for tests, that links to the ``CMakeLib`` library
  10. defined over in ``Source/``.
  11. * ``CMakeOnly/``:
  12. Deprecated. Tests that run CMake to generate a project but not build it.
  13. Superseded by ``Tests/RunCMake/``.
  14. * ``Find*/``:
  15. Tests for specific find modules that can only be run on machines with
  16. the corresponding packages installed. They are enabled in
  17. ``CMakeLists.txt`` by undocumented options used on CI builds.
  18. * ``Module/``:
  19. Tests for specific CMake modules.
  20. * ``RunCMake/``:
  21. Tests that run CMake and/or other tools while precisely checking
  22. their return code and stdout/stderr content. Useful for testing
  23. error cases and diagnostic output.