mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-04 04:40:56 -06:00
Code Issues Packages Projects Releases Wiki Activity

FindGDAL: Document as deprecated in favor of upstream CMake package

Browse Source 
Issue: #26471
This commit is contained in:
SunBlack
2024-11-26 16:38:12 +01:00
committed by Brad King
parent 467d6f00cc
commit 7e2aee4458
2 changed files with 26 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
Help/release/dev/FindGDAL-deprecate.rst Normal file
View File

@@ -0,0 +1,8 @@
FindGDAL-deprecate
------------------
* The :module:`FindGDAL` module is now deprecated in favor of upstream
GDAL's official CMake package configuration file. Port projects to
the latter by calling ``find_package(GDAL CONFIG)``. For further
details, see `GDAL's documentation on CMake integration
<https://gdal.org/en/latest/development/cmake.html>`_.

18
Modules/FindGDAL.cmake
View File

@@ -7,6 +7,12 @@ FindGDAL
Find Geospatial Data Abstraction Library (GDAL). Find Geospatial Data Abstraction Library (GDAL).
.. deprecated:: 3.32
GDAL 3.5 and above provide a ``GDALConfig.cmake`` package configuration file.
Call ``find_package(GDAL CONFIG)`` to find it directly and avoid using this
find module. For further details, see `GDAL's documentation on CMake
integration <https://gdal.org/en/latest/development/cmake.html>`_.
IMPORTED Targets IMPORTED Targets
^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^
@@ -184,6 +190,18 @@ else ()
set(GDAL_VERSION GDAL_VERSION-NOTFOUND) set(GDAL_VERSION GDAL_VERSION-NOTFOUND)
endif () endif ()
if (GDAL_FIND_VERSION VERSION_GREATER_EQUAL 3.5)
message(DEPRECATION
"The FindGDAL module is deprecated. "
"GDAL 3.5 and above provide a CMake package configuration file. "
"Since at least version ${GDAL_FIND_VERSION} is requested, this "
"project can be ported to find GDAL's CMake package directly:\n"
" find_package(GDAL CONFIG)\n"
"For further details, see:\n"
" https://gdal.org/en/latest/development/cmake.html\n"
)
endif()
include(${CMAKE_CURRENT_LIST_DIR}/FindPackageHandleStandardArgs.cmake) include(${CMAKE_CURRENT_LIST_DIR}/FindPackageHandleStandardArgs.cmake)
FIND_PACKAGE_HANDLE_STANDARD_ARGS(GDAL FIND_PACKAGE_HANDLE_STANDARD_ARGS(GDAL
VERSION_VAR GDAL_VERSION VERSION_VAR GDAL_VERSION