1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-18 17:31:57 +08:00

Help: Add note about /usr/local/include on macOS without CMAKE_OSX_SYSROOT

Issue: #19180
This commit is contained in:
Brad King
2025-04-10 10:16:29 -04:00
parent f098dc700e
commit c69add958a
2 changed files with 14 additions and 0 deletions

View File

@@ -235,6 +235,12 @@ Other Changes
does not do this, users must now specify :variable:`CMAKE_OSX_SYSROOT`
when configuring their build, e.g., ``-DCMAKE_OSX_SYSROOT=macosx``.
Note that Xcode's compilers, when not invoked with ``-isysroot``, search
for headers in ``/usr/local/include`` before system SDK paths, matching the
convention on many platforms. Users on macOS-x86_64 hosts with Homebrew
installed in ``/usr/local`` should pass ``-DCMAKE_OSX_SYSROOT=macosx``,
or ``export SDKROOT=macosx``, when not building with Homebrew tools.
* On AIX, ``SHARED`` library targets now produce a shared library archive
by default. See policy :policy:`CMP0182`.

View File

@@ -15,4 +15,12 @@ sysroot is used.
The default is now empty. Previously a default was computed based on
the :variable:`CMAKE_OSX_DEPLOYMENT_TARGET` or the host platform.
.. note::
Xcode's compilers, when not invoked with ``-isysroot``, search for
headers in ``/usr/local/include`` before system SDK paths, matching the
convention on many platforms. Users on macOS-x86_64 hosts with Homebrew
installed in ``/usr/local`` should pass ``-DCMAKE_OSX_SYSROOT=macosx``,
or ``export SDKROOT=macosx``, when not building with Homebrew tools.
.. include:: CMAKE_OSX_VARIABLE.txt