about summary refs log tree commit diff
path: root/src/doc/rustc
diff options
context:
space:
mode:
authorThom Chiovoloni <thom@shift.click>2023-06-04 10:08:10 -0700
committerThom Chiovoloni <thom@shift.click>2023-06-21 14:59:40 -0700
commita7ecc71a48be74882d2b159876911e6b9edb945d (patch)
tree732d1503f9b4715e1c96d4b5714cf0cb34fe2c8a /src/doc/rustc
parent37854aab76209788b0f402aa0ff0acb2a8d3acb7 (diff)
downloadrust-a7ecc71a48be74882d2b159876911e6b9edb945d.tar.gz
rust-a7ecc71a48be74882d2b159876911e6b9edb945d.zip
Note the incomplete Command support in the apple-tvos.md document
Diffstat (limited to 'src/doc/rustc')
-rw-r--r--src/doc/rustc/src/platform-support/apple-tvos.md19
1 files changed, 16 insertions, 3 deletions
diff --git a/src/doc/rustc/src/platform-support/apple-tvos.md b/src/doc/rustc/src/platform-support/apple-tvos.md
index 2446c5fc10f..5a22402324c 100644
--- a/src/doc/rustc/src/platform-support/apple-tvos.md
+++ b/src/doc/rustc/src/platform-support/apple-tvos.md
@@ -18,9 +18,9 @@ These targets are cross-compiled. You will need appropriate versions of Xcode
 and the SDKs for tvOS (`AppleTVOS.sdk`) and/or the tvOS Simulator
 (`AppleTVSimulator.sdk`) to build a toolchain and target these platforms.
 
-The targets support the full standard library including the allocator to the
-best of my knowledge, however they are very new, not yet well-tested, and
-it is possible that there are various bugs.
+The targets support most (see below) of the standard library including the
+allocator to the best of my knowledge, however they are very new, not yet
+well-tested, and it is possible that there are various bugs.
 
 In theory we support back to tvOS version 7.0, although the actual minimum
 version you can target may be newer than this, for example due to the versions
@@ -30,6 +30,19 @@ As with the other Apple targets, `rustc` respects the common environment
 variables used by Xcode to configure this, in this case
 `TVOS_DEPLOYMENT_TARGET`.
 
+#### Incompletely supported library functionality
+
+As mentioned, "most" of the standard library is supported, which means that some portions
+are known to be unsupported. The following APIs are currently known to have
+missing or incomplete support:
+
+- `std::process::Command`'s API will return an error if it is configured in a
+  manner which cannot be performed using `posix_spawn` -- this is because the
+  more flexible `fork`/`exec`-based approach is prohibited on these platforms in
+  favor of `posix_spawn{,p}`. A concrete set of cases where this will occur is
+  difficult to enumerate (and would quickly become stale), but in some cases it
+  may be worked around by tweaking the manner in which `Command` is invoked.
+
 ## Building the target
 
 The targets can be built by enabling them for a `rustc` build in `config.toml`, by adding, for example: