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