Commit Graph

15076 Commits

Author SHA1 Message Date
Brad King cd44c127ef Merge topic 'FindPython-SABI_LIBRARY-definition'
25cbaf162f Merge branch 'backport-FindPython-SABI_LIBRARY-definition'
bd7a27bcc7 FindPython: fix the definition of SABI artifacts
554ef95470 FindPython: fix the definition of SABI artifacts

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10687
2025-04-22 09:15:36 -04:00
Brad King b24c9d4408 Merge topic 'patch-Findosg_functions'
443440a75b Findosg_functions: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10680
2025-04-22 09:14:25 -04:00
Brad King 300dfc13e3 Merge topic 'patch-FindIce'
a993d12605 FindIce: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10681
2025-04-22 09:13:20 -04:00
Brad King 58c1683f8d Merge topic 'patch-FindGLUT'
eecc3d545b FindGLUT: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10686
2025-04-22 09:12:12 -04:00
Marc Chevrier bd7a27bcc7 FindPython: fix the definition of SABI artifacts
Fixes: #26881
2025-04-21 11:47:49 -04:00
Brad King 15daf279f2 Merge topic 'swift-warning-as-error'
dfa78c4868 Swift: Honor COMPILE_WARNING_AS_ERROR for command-line build systems

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10660
2025-04-21 09:38:45 -04:00
Brad King b913544f0f Merge topic 'patch-FindOpenThreads'
5d721d4f1f FindOpenThreads: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10677
2025-04-21 09:35:32 -04:00
Peter Kokot eecc3d545b FindGLUT: Update documentation
- Synced module documentation with other similar find modules.
- Added examples section.
- Refactored the obsolete variables section to only mention in the
  result variables that GLUT_INCLUDE_DIRS should be used instead of
  the previously misused cache variable GLUT_INCLUDE_DIR. The
  GLUT_INCLUDE_DIR as such is not actually deprecated/obsolete as it is
  still used to find GLUT (only its previous usage way is
  changed/obsolete).
2025-04-21 13:39:00 +02:00
Peter Kokot a993d12605 FindIce: Update documentation
- Module documentation synced with other similar find modules.
- Added examples section.
- Extended components into a separate section.
- Components listed with hlist RST directive
- Added and updated versions for variables when they got introduced.
- Fixed variable name from Ice_ICEBOXXX11_EXECUTABLE to
  Ice_ICEBOX++11_EXECUTABLE.
- Fixed typo in C++ component name: s/IceGrid/IceGrid++11
2025-04-20 02:23:53 +02:00
Peter Kokot 443440a75b Findosg_functions: Update documentation
Added note to highlight that this module is for internal usage in
OpenSceneGraph (OSG) find modules.
2025-04-20 01:35:25 +02:00
Brad King 2781e1c58d Merge topic 'patch-FindCURL-features-protocols-26866'
4acfe363a2 FindCURL: Fix hardcoded outdated protocols and features

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10666
2025-04-18 10:34:24 -04:00
Brad King 0a940684f4 Merge topic 'patch-FindFLTK'
0a28689e5b FindFLTK, FindFLTK2: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10665
2025-04-18 10:31:52 -04:00
Peter Kokot 5d721d4f1f FindOpenThreads: Update documentation
- Added examples section.
- Used OpenThreads_FOUND variable. The uppercased OPENTHREADS_FOUND is
  also set to the same value as of CMake 3.3.
- Module documentation synced with other similar find modules.
- Mention of CMake 2.8.10 removed as these are now being cleaned in the
  CMake 4 documentation (CMake docs are at this point considering the
  3.0 as the initial state upon which new and changed items are
  documented through versions).
- Refactored the hints variables section.
- Added info about release and debug variants.
- Refactored internal comments into more readable documentation
  paragraph.  Most of the issues described in the internal comment have
  been resolved in CMake evolution by now - CMake now offers _ROOT
  variables and CMAKE_PREFIX_PATH variable which works by finding that
  paths with precedence over default standard locations.
2025-04-18 15:45:08 +02:00
Evan Wilde dfa78c4868 Swift: Honor COMPILE_WARNING_AS_ERROR for command-line build systems
Define missing CMAKE_Swift_COMPILE_OPTIONS_WARNING_AS_ERROR for Swift to
`-warnings-as-errors`.

Fixes: #26872
2025-04-18 09:26:45 -04:00
Peter Kokot 419a49c67b FindImageMagick: Update documentation
- Synced module documentation with other similar find modules.
- Removed CMake 2.8.8 version info as these are now being cleaned from
  the CMake 4 documentation.
- Added some additional versionadded directives for those items that
  were added after the CMake 3.0.0 module state.
- Added separate components section.
- Reworded few descriptions.
2025-04-17 13:59:49 +02:00
Peter Kokot 4acfe363a2 FindCURL: Fix hardcoded outdated protocols and features
This removes the hardcoded known protocols and features and only checks
whether the specified component(s) by the
`find_package(COMPONENT|OPTIONAL_COMPONENT <components>...)` call are
found and listed by either the pkg-config or the curl-config tool. When
curl is found via its CMake package configuration file, this issue
wasn't relevant.

Additionally, this also removes two internal FindCURL module variables
`CURL_KNOWN_PROTOCOLS` and `CURL_KNOWN_FEATURES`.

Redundant fatal error thrown is also removed as this is handled by the
`find_package_handle_standard_args()`.

Fixes #26866
2025-04-16 23:16:00 +02:00
Peter Kokot 0a28689e5b FindFLTK, FindFLTK2: Update documentation
- Modules documentation updated and syced.
- Added examples section.
- Mentioned FLTK upstream package configuration file that is also taken
  into account when calling the find_package(FLTK).
- Briefly mentioned the fltk_wrap_ui() command.
- Added note for FindFLTK2 that it is for the obsolete 2.x branch that
  wasn't released and FindFLTK should be used instead.

Issue: #15728
2025-04-16 21:47:03 +02:00
Brad King ca9fa874d8 Merge topic 'nasm-find-compiler'
f1b1b84b22 ASM_NASM: Honor ASM_NASM env var over standard NASM installation on Windows

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10662
2025-04-16 09:52:44 -04:00
Brad King 2d04de2532 Merge topic 'macos-usr-local-lib'
6e63080d39 macOS: Restore RPATH entry for libraries linked from /usr/local/lib
430174e65d CMakeDetermineCompilerABI: Comment implicit link directory exclusion

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10663
2025-04-16 09:38:29 -04:00
Brad King 6bbd572438 Merge topic 'patch-FindGLEW'
714966fe42 FindGLEW: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10654
2025-04-16 09:27:39 -04:00
Brad King 7a5ac016f1 Merge topic 'patch-FindMPEG'
cea6119266 FindMPEG, FindMPEG2: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10656
2025-04-16 09:18:29 -04:00
Brad King 7be87256a6 Merge topic 'patch-FindSDL'
905d461431 Find_SDL*: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10657
2025-04-16 09:10:58 -04:00
Peter Kokot 714966fe42 FindGLEW: Update documentation
- Synced module documentation with other similar find modules.
- Added examples section.
- Moved imported targets section to the top.
- Added note about config mode.
- Added CMake versions, when some variables got introduced as many were
  added after the initial module.
2025-04-15 22:41:48 +02:00
Brad King 6e63080d39 macOS: Restore RPATH entry for libraries linked from /usr/local/lib
Since commit 7b19531291 (macOS: Do not pass any SDK/-isysroot to
compilers by default, 2024-11-06, v4.0.0-rc1~511^2) our default
invocation of compilers targeting macOS no longer passes `-isysroot`.
Without that, Xcode's compilers search `-L/usr/local/lib` by default
even though the macOS dynamic loader does not.  Since `/usr/local/lib`
is not a fully-implemented implicit link directory, exclude it from our
detected `CMAKE_<LANG>_IMPLICIT_LINK_LIBRARIES` so that our generators
do not suppress `RPATH` entries for dependencies in that directory.

Fixes: #26867
2025-04-15 14:13:45 -04:00
Brad King 430174e65d CMakeDetermineCompilerABI: Comment implicit link directory exclusion 2025-04-15 14:13:45 -04:00
Brad King f1b1b84b22 ASM_NASM: Honor ASM_NASM env var over standard NASM installation on Windows
Drop the custom `find_program` call in favor of the common
infrastructure.

Fixes: #26873
2025-04-15 12:00:15 -04:00
Brad King 8b4971ec25 Merge topic 'patch-FindGnuTLS'
6dff939916 FindGnuTLS: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10650
2025-04-15 09:58:19 -04:00
Brad King b3dd121aea Merge topic 'patch-FindKDE3'
d7a4750c78 FindKDE3: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10651
2025-04-15 09:56:46 -04:00
Brad King ffec8739de Merge topic 'patch-FindCURL'
2ab964c040 FindCURL: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10646
2025-04-15 09:54:26 -04:00
Brad King 100587fcbc Merge topic 'patch-FindOpenSSL'
8481204a0c FindOpenSSL: Fix version range documentation note

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10649
2025-04-15 09:53:11 -04:00
Brad King 8f3d71b357 Merge topic 'patch-FindwxWindows'
7ac1345f7f FindwxWindows: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10648
2025-04-15 09:51:26 -04:00
Brad King cb31aa3476 Merge topic 'doc-include-rst'
9784834b4c Help: Use `*.rst` extension for included files

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10615
2025-04-15 09:42:51 -04:00
Peter Kokot 905d461431 Find_SDL*: Update documentation
This updates the following modules:
- FindSDL
- FindSDL_gfx
- FindSDL_image
- FindSDL_mixer
- FindSDL_net
- FindSDL_sound
- FindSDL_ttf

Changes:
- Synced modules documentation.
- Added examples sections.
- Used the ``<PackageName>_FOUND`` variables. The uppercased
  ``<PACKAGENAME>_FOUND`` variables are also set to the same value as of
  CMake 3.3.
- Added notes regarding the CMake package configuration files
  provided by upstream distributions with separate imported targets.
- Find modules index sorted alphabetically for FindSDL* modules.
2025-04-15 14:23:12 +02:00
Peter Kokot cea6119266 FindMPEG, FindMPEG2: Update documentation
- Modules documentation updated and synced.
- Added examples section.
- FindMPEG and FindMPEG2 modules behave very much the same except that
  FindMPEG2 also adds the SDL library as a dependency. Added notes
  regarding this and recommended to use the FindMPEG2 as it also links
  in the SDL library at the time of writing.
2025-04-15 02:29:36 +02:00
Brad King ed7f1c54eb Merge topic 'asm-restore-c-compiler'
d26efc3600 ASM: Restore CMAKE_{C,CXX}_COMPILER as ASM-first candidates

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10644
2025-04-14 08:31:33 -04:00
Peter Kokot 6dff939916 FindGnuTLS: Update documentation
- Added examples section.
- Synced module documentation with other similar find modules.
- Documented some missing variables to make the result variables and
  cache variables sections consistent. The imported target is
  highlighted in the example.
- Added deprecated variables section.
- GnuTLS_FOUND variable used. GNUTLS_FOUND is also set to the same value
  as of CMake 3.3.
2025-04-14 12:47:03 +02:00
Peter Kokot d7a4750c78 FindKDE3: Update documentation
- This syncs the module documentation with other similar find modules.
- Added note about KDE version 3 being obsolete and newer KDE version
  should be used. A link to upstream docs is added.
- Fixed typo "SKIP_AUTOMAKE" to "SKIP_AUTOMOC".
- Documented commands. Instead of mentioning "macros", this now uses the
  more general wording "commands" and lists them similar to other
  documentation pages.
- Lowercase style used for commands.
- Reworded descriptions to match the implementations a bit.
2025-04-14 01:25:28 +02:00
Alex Turbov 9784834b4c Help: Use *.rst extension for included files
So, editor(s) can correctly highlight the RST syntax in the included files.
2025-04-14 03:07:46 +04:00
Peter Kokot 2ab964c040 FindCURL: Update documentation
- Module documentation synced with other similar find modules.
- Added examples section.
- Joined all hints variables in a single section.
- Added deprecated variables section.
- Described the "module mode" and "config mode" when searching for CURL
  separately in the module introduction, and added notes to some result
  variables.

Fixes #24580
2025-04-13 17:49:22 +02:00
Peter Kokot 8481204a0c FindOpenSSL: Fix version range documentation note
Handling version ranges in FindOpenSSL was added in CMake 3.20.
2025-04-13 04:26:36 +02:00
Peter Kokot 7ac1345f7f FindwxWindows: Update documentation
- Module documentation updated and synced with other similar find
  modules.
- Added examples section highlighting the usage of the FindwxWidgets
  module instead.
2025-04-13 02:52:57 +02:00
Brad King d26efc3600 ASM: Restore CMAKE_{C,CXX}_COMPILER as ASM-first candidates
Prior to commit abfe98ce6c (ASM: Consider C/CXX compilers only if
enabled, 2025-04-08) one could pass `-DCMAKE_C_COMPILER=...` to
configure a project that enables `ASM` before/without `C` or `CXX`.
This was previously allowed accidentally as a side effect of the way we
implemented support for using the selected `C` or `CXX` compiler for
`ASM`.  Restore it for compatibility, but also preserve the effect of
commit 6baf65ec46 (ASM: Do not consider MSVC C/CXX compiler for generic
ASM, 2025-04-08) by excluding `cl`.
2025-04-12 10:05:13 -04:00
Peter Kokot 008dc3f330 FindPython{Interp,Libs}: Update documentation
Even though these modules are removed with a policy, documentation can
still be improved a bit to help when upgrading CMake code.

Changes:
- Synced modules documentation with other similar find modules.
- Added examples section to hint how to rewrite code using the
  FindPython module.
- FindPythonLibs:
  - Deprecated variables moved to a separate section.
  - PythonLibs_FOUND variable used. The PYTHONLIBS_FOUND variable is
    also set to the same value since CMake 3.3.
- FindPythonInterp:
  - PythonInterp_FOUND variable used. The PYTHONINTERP_FOUND variable is
    also set to the same value since CMake 3.3.
2025-04-11 19:01:55 +02:00
Brad King a84177c683 Merge topic 'patch-FindDevIL'
add5ea827c FindDevIL: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10638
2025-04-11 10:19:02 -04:00
Brad King 890ed9495f Merge topic 'patch-FindSquish'
36b8b053d1 FindSquish: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10634
2025-04-11 10:16:03 -04:00
Brad King f666b0489e Merge topic 'FindLua5x-headers'
14db9f9329 FindLua{50,51}: Fix finding headers in standard distros

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10635
2025-04-11 10:14:43 -04:00
Peter Kokot add5ea827c FindDevIL: Update documentation
- Added examples section.
- Explained the DevIL package libraries and imported targets in more
  details.
- Separated the result variables and cache variables.
- Module documentation synced as much as possible for the time being
  with other similar find modules.
2025-04-10 22:54:08 +02:00
Peter Kokot 36b8b053d1 FindSquish: Update documentation
- Updated and synced module documentation according to other similar
  find modules.
- Added a separate examples section.
- Commands are listed using the `command` directives.
- Updated documentation for the `SquishTestScript.cmake` file. This is
  not actually a module but a test script that `FindSquish` uses and
  also isn't technically deprecated as it is still used. Documentation
  changed a bit to explain it is an internal script that shouldn't be
  used in the project directly.
2025-04-10 21:20:09 +02:00
alyokhin 14db9f9329 FindLua{50,51}: Fix finding headers in standard distros
`find_path` already knows how to search in `<prefix>/include` directories.
We need `PATH_SUFFIXES` only for the `/lua*` subdirectory.

Fixes: #26855
2025-04-10 14:00:37 -04:00
Brad King 602b3d2b19 Merge topic 'patch-FindJava'
bc3bcff18c FindJava: Update documentation

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !10630
2025-04-10 09:10:25 -04:00