about summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authortoonn <toonn@toonn.io>2022-07-08 12:28:51 +0200
committerGitHub <noreply@github.com>2022-07-08 12:28:51 +0200
commit80ffac409746c8b3d0696ee96cc25ccf7ac22a27 (patch)
treed8325a3c8ab02edebb791d0c951371e28130da20 /doc
parent42100e31bfa5ad169e7bc7356ad83fe9f817e34e (diff)
parent25ccd71ff83a1b6e961588ee65c9f18a7c8f0a92 (diff)
Merge pull request #176661 from reckenrode/apple-sdk-11-x86_64
apple_sdk_11_0: make available for use on x86_64-darwin
Diffstat (limited to 'doc')
-rw-r--r--doc/stdenv/platform-notes.chapter.md5
1 files changed, 5 insertions, 0 deletions
diff --git a/doc/stdenv/platform-notes.chapter.md b/doc/stdenv/platform-notes.chapter.md
index 03e61e333f8b2..b47f5af349b8d 100644
--- a/doc/stdenv/platform-notes.chapter.md
+++ b/doc/stdenv/platform-notes.chapter.md
@@ -60,3 +60,8 @@ Some common issues when packaging software for Darwin:
   ```
 
   The package `xcbuild` can be used to build projects that really depend on Xcode. However, this replacement is not 100% compatible with Xcode and can occasionally cause issues.
+
+- x86_64-darwin uses the 10.12 SDK by default, but some software is not compatible with that version of the SDK. In that case,
+  the 11.0 SDK used by aarch64-darwin is available for use on x86_64-darwin. To use it, reference `apple_sdk_11_0` instead of
+  `apple_sdk` in your derivation and use `pkgs.darwin.apple_sdk_11_0.callPackage` instead of `pkgs.callPackage`. On Linux, this will
+  have the same effect as `pkgs.callPackage`, so you can use `pkgs.darwin.apple_sdk_11_0.callPackage` regardless of platform.