Ninja.rst 1.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. Ninja
  2. -----
  3. Generates build.ninja files.
  4. A ``build.ninja`` file is generated into the build tree. Use the ninja
  5. program to build the project through the ``all`` target and install the
  6. project through the ``install`` (or ``install/strip``) target.
  7. For each subdirectory ``sub/dir`` of the project, additional targets
  8. are generated:
  9. ``sub/dir/all``
  10. Depends on all targets required by the subdirectory.
  11. ``sub/dir/install``
  12. Runs the install step in the subdirectory, if any.
  13. ``sub/dir/install/strip``
  14. Runs the install step in the subdirectory followed by a ``CMAKE_STRIP`` command,
  15. if any.
  16. The ``CMAKE_STRIP`` variable will contain the platform's ``strip`` utility, which
  17. removes symbols information from generated binaries.
  18. ``sub/dir/test``
  19. Runs the test step in the subdirectory, if any.
  20. ``sub/dir/package``
  21. Runs the package step in the subdirectory, if any.
  22. Fortran Support
  23. ^^^^^^^^^^^^^^^
  24. The ``Ninja`` generator conditionally supports Fortran when the ``ninja``
  25. tool has the required features. As of this version of CMake the needed
  26. features have not been integrated into upstream Ninja. Kitware maintains
  27. a branch of Ninja with the required features on `github.com/Kitware/ninja`_.
  28. .. _`github.com/Kitware/ninja`: https://github.com/Kitware/ninja/tree/features-for-fortran#readme