find_file.rst 1.3 KB

12345678910111213141516171819202122232425262728293031323334
  1. find_file
  2. ---------
  3. .. |FIND_XXX| replace:: find_file
  4. .. |NAMES| replace:: NAMES name1 [name2 ...]
  5. .. |SEARCH_XXX| replace:: full path to a file
  6. .. |SEARCH_XXX_DESC| replace:: full path to named file
  7. .. |prefix_XXX_SUBDIR| replace:: ``<prefix>/include``
  8. .. |entry_XXX_SUBDIR| replace:: ``<entry>/include``
  9. .. |CMAKE_PREFIX_PATH_XXX| replace::
  10. ``<prefix>/include/<arch>`` if :variable:`CMAKE_LIBRARY_ARCHITECTURE`
  11. is set, and |CMAKE_PREFIX_PATH_XXX_SUBDIR|
  12. .. |CMAKE_XXX_PATH| replace:: :variable:`CMAKE_INCLUDE_PATH`
  13. .. |CMAKE_XXX_MAC_PATH| replace:: :variable:`CMAKE_FRAMEWORK_PATH`
  14. .. |SYSTEM_ENVIRONMENT_PATH_XXX| replace:: Directories in ``INCLUDE``.
  15. On Windows hosts:
  16. ``<prefix>/include/<arch>`` if :variable:`CMAKE_LIBRARY_ARCHITECTURE`
  17. is set, and |SYSTEM_ENVIRONMENT_PREFIX_PATH_XXX_SUBDIR|, and the
  18. directories in ``PATH`` itself.
  19. .. |CMAKE_SYSTEM_PREFIX_PATH_XXX| replace::
  20. ``<prefix>/include/<arch>`` if :variable:`CMAKE_LIBRARY_ARCHITECTURE`
  21. is set, and |CMAKE_SYSTEM_PREFIX_PATH_XXX_SUBDIR|
  22. .. |CMAKE_SYSTEM_XXX_PATH| replace::
  23. :variable:`CMAKE_SYSTEM_INCLUDE_PATH`
  24. .. |CMAKE_SYSTEM_XXX_MAC_PATH| replace::
  25. :variable:`CMAKE_SYSTEM_FRAMEWORK_PATH`
  26. .. |CMAKE_FIND_ROOT_PATH_MODE_XXX| replace::
  27. :variable:`CMAKE_FIND_ROOT_PATH_MODE_INCLUDE`
  28. .. include:: FIND_XXX.txt