Files
create/cMake/FreeCAD_Helpers
Jacob Oursland 26e8eb1f9f CMake: ensure shiboken does not introduce Py_LIMITED_API.
On some builds, the CMake package files for PySide6's Shiboken set the Py_LIMITED_API define on
the compiler's command line.  This breaks FreeCAD as it depends on definitions from the Python
Stable API unavailable with the Limited API.
2024-07-22 09:22:30 -07:00
..

This folder will contain an individual cmake file for each FreeCAD "helper".

A "helper" should be a macro or function that tries (as much as possible) to adhere to the UNIX philosophy - in other words, it should strive to do one thing and do it well.

The idea here is to break up the cmake build system into smaller, more manageable chunks. This should make maintenance easier, and should also make troubleshooting a bit less painful. Finally, it should also clean up our top-level CMakeLists.txt file a bit, making it bit easier for new developers to jump in and see what's what.

NOTE: CMake has a very distinct difference between its macros and its functions. Namely, a function creates its own SCOPE, whereas a macro essentially executes in the calling scope. There are also some specifics of how arguments are managed.

In general:

  1. If you use a macro, be careful modifying arguments - you may get surprises.
  2. If you use a function, make sure to use set(.... PARENT_SCOPE) for variables that should be available outside of the function.