find-windows-no-PATH-prefixes.rst 940 B

1234567891011121314151617
  1. find-windows-no-PATH-prefixes
  2. -----------------------------
  3. * The :command:`find_library`, :command:`find_path`, and :command:`find_file`
  4. commands no longer search in installation prefixes derived from the ``PATH``
  5. environment variable. This behavior was added in CMake 3.3 to support
  6. MSYS and MinGW (``MSYSTEM``) development environments on Windows, but
  7. it can search undesired prefixes that happen to be in the ``PATH`` for
  8. unrelated reasons. Users that keep some ``<prefix>/bin`` directories in
  9. the ``PATH`` just for their tools do not necessarily want any corresponding
  10. ``<prefix>/lib`` or ``<prefix>/include`` directories searched.
  11. The behavior was reverted for non-Windows platforms by CMake 3.6.
  12. Now it has been reverted on Windows platforms too.
  13. One may set the ``CMAKE_PREFIX_PATH`` environment variable with a
  14. :ref:`semicolon-separated list <CMake Language Lists>` of prefixes
  15. that are to be searched.