Skip to content

Commit 026ec62

Browse files
committed
docs: align XLA preflight docs with xla 0.10 cuda13 support
Critical review found three stale references that still described XLA_TARGET=cuda13 as rejected by xla 0.9.x after the v0.2.0 dep-stack bump. The code and main troubleshooting guide were already updated; this commit fixes the remaining packaged docs/comments: - Mix.Tasks.Compile.XlaEnvPreflight moduledoc now uses cuda14 as the unsupported example and names xla 0.10.0 / cuda13 in the accepted set. - XlaTargetValidator error message points at the renamed troubleshooting heading. - docs/production_runbook.md now says cuda13 is accepted under xla 0.10.x and cuda12 remains recommended. Verification: - mix test test/source_policy_test.exs test/build_support/xla_target_validator_test.exs - mix docs --warnings-as-errors
1 parent 017643e commit 026ec62

3 files changed

Lines changed: 9 additions & 7 deletions

File tree

build_support/mix_tasks_compile_xla_env_preflight.exs

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,12 @@ defmodule Mix.Tasks.Compile.XlaEnvPreflight do
88
## Why this exists
99
1010
Without this preflight, an unrecognised `XLA_TARGET` (for example
11-
`cuda13` against the bundled `xla 0.9.x`) surfaces as a `RuntimeError`
11+
`cuda14` against the bundled `xla 0.10.x`) surfaces as a `RuntimeError`
1212
stacktrace from `deps/exla/mix.exs` during dependency compilation:
1313
1414
** (RuntimeError) expected XLA_TARGET to be one of
15-
"cpu", "cuda", "rocm", "tpu", "cuda12", but got: "cuda13"
16-
(xla 0.9.1) lib/xla.ex:82: XLA.xla_target/0
15+
"cpu", "cuda", "rocm", "tpu", "cuda12", "cuda13", but got: "cuda14"
16+
(xla 0.10.0) lib/xla.ex:82: XLA.xla_target/0
1717
...
1818
1919
With this preflight, the project surfaces the failure with a single

build_support/xla_target_validator.exs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,8 +83,8 @@ defmodule XlaTargetValidator do
8383
"Recommended for CPU hosts: unset XLA_TARGET (or use cpu). " <>
8484
"The bundled xla rejects unrecognised targets at compile time, so EXLA " <>
8585
"cannot compile until XLA_TARGET is corrected. See " <>
86-
"guides/troubleshooting.md (\"XLA_TARGET=cuda13 Is Rejected At Compile " <>
87-
"Time\") for the canonical recipe."
86+
"guides/troubleshooting.md (\"XLA_TARGET Rejected At Compile Time\") " <>
87+
"for the canonical recipe."
8888
)
8989
end
9090
end

docs/production_runbook.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,10 @@ Common output:
2929
trinity.env.check: ok / xla_target=cuda12
3030
```
3131

32-
Known gotcha: `XLA_TARGET=cuda13` is rejected at compile time by
33-
`xla 0.9.1`. Use `cuda12`.
32+
Known gotcha: `XLA_TARGET` is validated before EXLA compiles. With the
33+
current `xla 0.10.x` stack, `cuda13` is accepted; `cuda12` remains the
34+
recommended default for CUDA hosts. Unsupported values such as `cuda14` fail
35+
fast with a readable `Mix.Error`.
3436

3537
## 2. Canonical artifact
3638

0 commit comments

Comments
 (0)