Kitware/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-21 06:10:16 +08:00
Code Issues Projects Releases Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

6
Help/release/4.0.rst
View File

@@ -235,6 +235,12 @@ Other Changes
does not do this, users must now specify :variable:`CMAKE_OSX_SYSROOT` does not do this, users must now specify :variable:`CMAKE_OSX_SYSROOT`
when configuring their build, e.g., ``-DCMAKE_OSX_SYSROOT=macosx``. 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 * On AIX, ``SHARED`` library targets now produce a shared library archive
by default. See policy :policy:`CMP0182`. by default. See policy :policy:`CMP0182`.

8
Help/variable/CMAKE_OSX_SYSROOT.rst
View File

@@ -15,4 +15,12 @@ sysroot is used.
The default is now empty. Previously a default was computed based on The default is now empty. Previously a default was computed based on
the :variable:`CMAKE_OSX_DEPLOYMENT_TARGET` or the host platform. 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 .. include:: CMAKE_OSX_VARIABLE.txt