Files
CMake/Modules/FindMotif.cmake
Peter Kokot 0fedf1592c Find*: Update *_FOUND variables
This marks all `<PACKAGENAME>_FOUND` result variables as deprecated
where possible (for `<PackageName>` find modules) to make it clearer
which variable to use.

In CMake 3.3, the FindPackageHandleStandardArgs module was refactored to
set both `<PackageName>_FOUND` and uppercase `<PACKAGENAME>_FOUND`
result variables to the same values. Before that, the FOUND_VAR argument
could be used to set the result variable.

* FindMatlab: Uppercased MATLAB_FOUND is not mentioned as it was never
  documented.
* Documentation for FindPythonInterp and FindPythonLibs modules synced
  accordingly to their deprecation (3.12 instead of 4.2).
* OPENGL_FOUND: deprecation version synced with other find modules.
* DevIL_FOUND was introduced in CMake 3.8. The uppercased variant not
  mentioned as it was previously never documented.

Fixes: #27242
2025-09-23 21:40:58 +02:00

89 lines
1.9 KiB
CMake

# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
# file LICENSE.rst or https://cmake.org/licensing for details.
#[=======================================================================[.rst:
FindMotif
---------
Finds Motif (or LessTif) graphical user interface toolkit:
.. code-block:: cmake
find_package(Motif [...])
Result Variables
^^^^^^^^^^^^^^^^
This module defines the following variables:
``Motif_FOUND``
.. versionadded:: 3.3
Boolean indicating whether Motif was found.
Cache Variables
^^^^^^^^^^^^^^^
The following cache variables may also be set:
``MOTIF_INCLUDE_DIR``
Include directories needed to use Motif.
``MOTIF_LIBRARIES``
Libraries needed to link to Motif.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``MOTIF_FOUND``
.. deprecated:: 4.2
Use ``Motif_FOUND``, which has the same value.
Boolean indicating whether Motif was found.
Examples
^^^^^^^^
Finding Motif and creating an imported interface target for linking it to a
project target:
.. code-block:: cmake
find_package(Motif)
if(Motif_FOUND AND NOT TARGET Motif::Motif)
add_library(Motif::Motif INTERFACE IMPORTED)
set_target_properties(
Motif::Motif
PROPERTIES
INTERFACE_INCLUDE_DIRECTORIES "${MOTIF_INCLUDE_DIR}"
INTERFACE_LINK_LIBRARIES "${MOTIF_LIBRARIES}"
)
endif()
target_link_libraries(example PRIVATE Motif::Motif)
#]=======================================================================]
if(UNIX)
find_path(MOTIF_INCLUDE_DIR
Xm/Xm.h
/usr/openwin/include
)
find_library(MOTIF_LIBRARIES
Xm
/usr/openwin/lib
)
endif()
include(FindPackageHandleStandardArgs)
find_package_handle_standard_args(Motif DEFAULT_MSG MOTIF_LIBRARIES MOTIF_INCLUDE_DIR)
mark_as_advanced(
MOTIF_INCLUDE_DIR
MOTIF_LIBRARIES
)