summaryrefslogtreecommitdiff
path: root/Help/release/3.9.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-08-08 11:22:17 -0400
committerBrad King <brad.king@kitware.com>2017-08-08 11:52:28 -0400
commit578d95f87d2c77498d1bbdd46bf5c1ad8095c31d (patch)
tree574f50edde4397174ee61b54ce91824212417632 /Help/release/3.9.rst
parent4a207116908c20caba4969120b1148adff391348 (diff)
downloadcmake-578d95f87d2c77498d1bbdd46bf5c1ad8095c31d.tar.gz
find_*: Disable the PACKAGE_ROOT search path group for CMake 3.9
Disable the feature added by commit v3.9.0-rc1~71^2~2 (find_*: Add a new PackageRoot search path group, 2017-05-03) and remove documentation added by commit v3.9.0-rc1~71^2 (find_*: Add docs for PackageRoot search path group, 2017-05-03). Unfortunately the name `<pkg>_ROOT` may already be set by projects for their own incompatible purposes. Disable the behavior change for now to fix the regression for CMake 3.9. We can restore it later with a policy. In order to keep the implementation and tests working, add an undocumented variable we can use in the tests to enable the behavior before the policy is introduced. Fixes: #17144
Diffstat (limited to 'Help/release/3.9.rst')
-rw-r--r--Help/release/3.9.rst19
1 files changed, 13 insertions, 6 deletions
diff --git a/Help/release/3.9.rst b/Help/release/3.9.rst
index 14e8699b43..ae55105c53 100644
--- a/Help/release/3.9.rst
+++ b/Help/release/3.9.rst
@@ -42,12 +42,6 @@ Commands
* The :command:`add_library` command ``IMPORTED`` option learned to support
:ref:`Object Libraries`.
-* All ``find_`` commands now have a ``PACKAGE_ROOT`` search path group that
- is first in the search heuristics. If a ``find_`` command is called from
- inside a find module, then the CMake variable and environment variable named
- ``<PackageName>_ROOT`` are used as prefixes and are the first set of paths
- to be searched.
-
* The :command:`find_library` command learned to search ``libx32`` paths
when the build targets the ``x32`` ABI. See the
:prop_gbl:`FIND_LIBRARY_USE_LIBX32_PATHS` global property.
@@ -326,3 +320,16 @@ Other Changes
a change to the ``v140`` toolset made by a VS 2015 update. VS changed
the set of values it understands for the ``GenerateDebugInformation``
linker setting that produces the ``-DEBUG`` linker flag variants.
+
+Updates
+=======
+
+Changes made since CMake 3.9.0 include the following.
+
+3.9.1
+-----
+
+* The ``find_`` command ``PACKAGE_ROOT`` search path group added by
+ CMake 3.9.0 has been removed for the 3.9 series due to regressions
+ caused by new use of ``<PackageName>_ROOT`` variables. The behavior
+ may be re-introduced in the future in a more-compatible way.