about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJubilee <workingjubilee@gmail.com>2025-02-05 19:53:47 -0800
committerGitHub <noreply@github.com>2025-02-05 19:53:47 -0800
commit45398fc04aad62957dfb5c8d23f2ae38170202fb (patch)
treef18d1ea037fd5c5fb430b437203e4ded451cf8af
parent1361ef37ff3e1901fc13147d8e795e356b52b7f8 (diff)
parent6bfa0571af39c4a39e5a7b9e354135de53c73aab (diff)
downloadrust-45398fc04aad62957dfb5c8d23f2ae38170202fb.tar.gz
rust-45398fc04aad62957dfb5c8d23f2ae38170202fb.zip
Rollup merge of #136558 - madsmtm:apple-host-tooling, r=jieyouxu
Document minimum supported host tooling on macOS

In particular we support macOS 10.12 (same as for binaries produced by `rustc`) and Xcode 9.2 (the highest Xcode version that runs on macOS 10.12.6). I have this installed on a MacBook Pro from 2013 that sits below my desk, and am occasionally testing it.

I am documenting this now because it was unclear in https://github.com/rust-lang/rust/issues/136523.

(I'm not inherently against bumping these one day, but that's a separate discussion, let's at least document what we support right now).

`@rustbot` label O-macos
-rw-r--r--src/doc/rustc/src/platform-support/apple-darwin.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/src/doc/rustc/src/platform-support/apple-darwin.md b/src/doc/rustc/src/platform-support/apple-darwin.md
index 17ea225805b..dba2c4b2aaf 100644
--- a/src/doc/rustc/src/platform-support/apple-darwin.md
+++ b/src/doc/rustc/src/platform-support/apple-darwin.md
@@ -30,6 +30,18 @@ The current default deployment target for `rustc` can be retrieved with
 [deployment target]: https://developer.apple.com/library/archive/documentation/DeveloperTools/Conceptual/cross_development/Configuring/configuring.html
 [rustc-print]: ../command-line-arguments.md#option-print
 
+### Host tooling
+
+The minimum supported OS versions for the host tooling (`rustc`, `cargo`,
+etc.) are currently the same as for applications, namely 10.12 on x86 and 11.0
+on ARM64.
+The minimum supported Xcode version is 9.2.
+
+Building from source likely requires that you can build LLVM from source too,
+which [currently][llvm-os] requires Xcode 10.0 and macOS 10.13 (for LLVM 19).
+
+[llvm-os]: https://releases.llvm.org/19.1.0/docs/GettingStarted.html#host-c-toolchain-both-compiler-and-standard-library
+
 ### Binary format
 
 The default binary format is Mach-O, the executable format used on Apple's