mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 21:59:54 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
22 lines
828 B
ReStructuredText
22 lines
828 B
ReStructuredText
CMP0009
|
|
-------
|
|
|
|
FILE GLOB_RECURSE calls should not follow symlinks by default.
|
|
|
|
In CMake 2.6.1 and below, :command:`file(GLOB_RECURSE)` calls would follow
|
|
through symlinks, sometimes coming up with unexpectedly large result sets
|
|
because of symlinks to top level directories that contain hundreds of
|
|
thousands of files.
|
|
|
|
This policy determines whether or not to follow symlinks encountered
|
|
during a :command:`file(GLOB_RECURSE)` call. The ``OLD`` behavior for this
|
|
policy is to follow the symlinks. The ``NEW`` behavior for this policy is not
|
|
to follow the symlinks by default, but only if ``FOLLOW_SYMLINKS`` is given
|
|
as an additional argument to the ``FILE`` command.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 2.6.2
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|