about summary refs log tree commit diff
diff options
context:
space:
mode:
authorRandy Eckenrode <randy@largeandhighquality.com>2022-06-07 00:18:19 -0400
committerRandy Eckenrode <randy@largeandhighquality.com>2022-07-07 07:52:36 -0400
commit25ccd71ff83a1b6e961588ee65c9f18a7c8f0a92 (patch)
tree90bc9646effdc99ef8fafb7058f9dc7f87e0d460
parent9659c7abcebb9fd36d0a8184681574268d8b9296 (diff)
doc: update Darwin platform doc regarding the 11.0 SDK
-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.