From 228574abd13351dc1406502b6c78a16a5de8eab8 Mon Sep 17 00:00:00 2001 From: MalekiRe Date: Fri, 3 Nov 2023 20:15:35 -0700 Subject: [PATCH 1/2] added section on cranelift codegen --- content/learn/book/getting-started/setup/_index.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/content/learn/book/getting-started/setup/_index.md b/content/learn/book/getting-started/setup/_index.md index 776a83707d..ba29520145 100644 --- a/content/learn/book/getting-started/setup/_index.md +++ b/content/learn/book/getting-started/setup/_index.md @@ -200,6 +200,9 @@ Bevy can be built just fine using default configuration on stable Rust. However For more information, see [The rustup book: Overrides](https://rust-lang.github.io/rustup/overrides.html#the-toolchain-file). +* **Cranelift Codegen**: This uses a new nightly-only codegen that can be 300% faster than LLVM! However it only currently works on Linux. + [Cranelift codegen setup](https://bjorn3.github.io/2023/10/31/progress-report-oct-2023.html). + * **Generic Sharing**: Allows crates to share monomorphized generic code instead of duplicating it. In some cases this allows us to "precompile" generic code so it doesn't affect iterative compiles. This is only available on nightly Rust. To enable fast compiles, install the nightly rust compiler and LLD. Then copy the contents of [this file](https://github.com/bevyengine/bevy/blob/main/.cargo/config_fast_builds) to `YOUR_WORKSPACE/.cargo/config.toml`. For the project in this guide, that would be `my_bevy_game/.cargo/config.toml`. From 88073e850970ce637e04f17d09f479b3027a8349 Mon Sep 17 00:00:00 2001 From: Alice Cecile Date: Sun, 5 May 2024 18:12:08 -0400 Subject: [PATCH 2/2] Add caveat --- content/learn/book/getting-started/setup/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/learn/book/getting-started/setup/_index.md b/content/learn/book/getting-started/setup/_index.md index ba29520145..576d389d21 100644 --- a/content/learn/book/getting-started/setup/_index.md +++ b/content/learn/book/getting-started/setup/_index.md @@ -200,7 +200,7 @@ Bevy can be built just fine using default configuration on stable Rust. However For more information, see [The rustup book: Overrides](https://rust-lang.github.io/rustup/overrides.html#the-toolchain-file). -* **Cranelift Codegen**: This uses a new nightly-only codegen that can be 300% faster than LLVM! However it only currently works on Linux. +* **Cranelift Codegen**: This uses a new nightly-only codegen that can be 300% faster than LLVM! However it only currently works on Linux and is generally still immature. [Cranelift codegen setup](https://bjorn3.github.io/2023/10/31/progress-report-oct-2023.html). * **Generic Sharing**: Allows crates to share monomorphized generic code instead of duplicating it. In some cases this allows us to "precompile" generic code so it doesn't affect iterative compiles. This is only available on nightly Rust.