FindDoxygen: Add Doxygen_VERSION

This deprecates the DOXYGEN_VERSION result variable.

Issue: #27088
This commit is contained in:
Peter Kokot 2025-08-04 20:54:32 +02:00
parent 185a4e6c5d
commit 15ffe27752
No known key found for this signature in database
GPG Key ID: A94800907AA79B36
4 changed files with 18 additions and 5 deletions

View File

@ -2512,6 +2512,7 @@ syn keyword cmakeVariable contained
\ DOXYGEN_USE_PDFLATEX
\ DOXYGEN_VERBATIM_HEADERS
\ DOXYGEN_VERBATIM_VARS
\ Doxygen_VERSION
\ DOXYGEN_VERSION
\ DOXYGEN_WARNINGS
\ DOXYGEN_WARN_AS_ERROR

View File

@ -10,6 +10,9 @@ Find Modules
* The :module:`FindCups` module now provides a ``Cups_VERSION`` result
variable. The ``CUPS_VERSION_STRING`` result variable is deprecated.
* The :module:`FindDoxygen` module now provides a ``Doxygen_VERSION`` result
variable. The ``DOXYGEN_VERSION`` result variable is deprecated.
* The :module:`FindEXPAT` module now provides a ``EXPAT_VERSION`` result
variable. The ``EXPAT_VERSION_STRING`` result variable is deprecated.

View File

@ -11,7 +11,7 @@ for integrating Doxygen-based documentation into CMake projects:
.. code-block:: cmake
find_package(Doxygen [<version>] [...] [COMPONENTS <components>...] [...])
find_package(Doxygen [<version>] [COMPONENTS <components>...] [...])
Components
^^^^^^^^^^
@ -95,7 +95,9 @@ This module defines the following variables:
the ``DOXYGEN_FOUND`` variable is also set, except it has boolean value of
``YES`` or ``NO``.
``DOXYGEN_VERSION``
``Doxygen_VERSION``
.. versionadded:: 4.2
The version of Doxygen found (as reported by ``doxygen --version``).
Commands
@ -529,6 +531,12 @@ are also defined but they are deprecated and should no longer be used:
(i.e. without specifying components) it prevents this find module from
searching for Graphviz's ``dot`` utility.
``DOXYGEN_VERSION``
.. deprecated:: 4.2
Superseded by the ``Doxygen_VERSION``.
The version of Doxygen found.
Examples
^^^^^^^^
@ -765,7 +773,8 @@ macro(_Doxygen_find_doxygen)
mark_as_advanced(DOXYGEN_EXECUTABLE)
if(DOXYGEN_EXECUTABLE)
_Doxygen_get_version(DOXYGEN_VERSION _Doxygen_version_result "${DOXYGEN_EXECUTABLE}")
_Doxygen_get_version(Doxygen_VERSION _Doxygen_version_result "${DOXYGEN_EXECUTABLE}")
set(DOXYGEN_VERSION "${Doxygen_VERSION}")
if(_Doxygen_version_result)
if(NOT Doxygen_FIND_QUIETLY)
@ -959,7 +968,7 @@ unset(_comp)
find_package_handle_standard_args(
Doxygen
REQUIRED_VARS DOXYGEN_EXECUTABLE
VERSION_VAR DOXYGEN_VERSION
VERSION_VAR Doxygen_VERSION
HANDLE_VERSION_RANGE
HANDLE_COMPONENTS
)

View File

@ -115,7 +115,7 @@ foreach(
ALSA
BISON Boost BZip2 BZIP2
CUDA Cups
DOXYGEN
Doxygen DOXYGEN
EXPAT
FLEX Freetype
GIF GTK2