From 466169b41526c2f00480a29ef9197379a71db200 Mon Sep 17 00:00:00 2001 From: Antoine du Hamel Date: Fri, 22 May 2026 16:45:56 +0200 Subject: [PATCH] doc: edit Rust toolchain general install instructions Signed-off-by: Antoine du Hamel --- BUILDING.md | 25 +++++++++---------------- 1 file changed, 9 insertions(+), 16 deletions(-) diff --git a/BUILDING.md b/BUILDING.md index d10c1b685ac24e..de50ddd53b8673 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -237,23 +237,11 @@ tarball and/or browse the git repository checked out at the relevant tag. ### Prerequisites * [A supported version of Python][Python versions] for building and testing. -* A Rust toolchain if [building Node.js with Temporal support](#building-nodejs-with-temporal-support) - is required (enabled by default starting in Node.js 26). +* A Rust toolchain if [building Node.js with Temporal support](#building-nodejs-with-temporal-support). * Memory: at least 8GB of RAM is typically required when compiling with 4 parallel jobs (e.g: `make -j4`). ### Unix and macOS -Consult the official [Install Rust](https://rust-lang.org/tools/install/) -instructions to install a Rust toolchain, required for Temporal support introduced in Node.js 25.4.0. -Individual packages such as `rust` and `cargo` in some operating system distributions may be considered -as an alternative, for example in CI environments. -Consult with relevant operating system documentation to ensure that packages -meet the minimum version specified in the -[Building Node.js with Temporal support](#building-nodejs-with-temporal-support) section, -as packaged versions may lag behind the `stable` version installed by the official instructions. -Avoid mixing `rustup` together with `rust` and `cargo` package installations, due to -potential version conflicts. - #### Unix prerequisites * `gcc` and `g++` >= 13.2 or `clang` and `clang++` >= 19.1 @@ -1062,14 +1050,19 @@ enable FIPS support in Node.js. Node.js supports the [Temporal](https://github.com/tc39/proposal-temporal) APIs, when linking statically or dynamically with a version of [temporal\_rs](https://github.com/boa-dev/temporal). - -Temporal support is enabled by default starting in Node.js 26. Building it -requires a Rust toolchain: +Building it requires a Rust toolchain: * rustc >= 1.82 (with LLVM >= 19) * cargo >= 1.82 Refer to [Install Rust](https://rust-lang.org/tools/install/) for instructions. +Individual packages such as `rust` and `cargo` in some operating system distributions may be considered +as an alternative, for example in CI environments. +Consult with relevant operating system documentation to ensure that packages +meet the minimum version specified above, +as packaged versions may lag behind the `stable` version installed by the official instructions. +Avoid mixing `rustup` together with `rust` and `cargo` package installations, due to +potential version conflicts. If `--v8-enable-temporal-support` and `--v8-disable-temporal-support` are both omitted, `configure.py` probes for `cargo` and `rustc`. If either is missing,