From 432a766ab43a2257320de77c0f4b6e5a13d59bbe Mon Sep 17 00:00:00 2001 From: Roman Lee Date: Tue, 25 Nov 2025 10:19:50 -0600 Subject: [PATCH 1/4] Add more detail to local_build instructions --- docs/src/tutorials/local-build.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/src/tutorials/local-build.md b/docs/src/tutorials/local-build.md index ea59d32894..6add0a5766 100644 --- a/docs/src/tutorials/local-build.md +++ b/docs/src/tutorials/local-build.md @@ -99,5 +99,6 @@ Finally, you may have to add the flag `--extraopt "--sandbox_writable_path=/path ## `LocalPreferences.toml` file -At the end of a successfult build, the `build_local.jl` script will create a `LocalPreferences.toml` file (see [`Preferences.jl` documentation](https://juliapackaging.github.io/Preferences.jl/stable/) for more information) in the top-level of the Reactant repository, pointing `libReactantExtra` to the new local build. -If you instantiate this environment Reactant will automatically use the new local build, but if you want to use the local build in a different environment you will have to copy the `LocalPreferences.toml` file (or its content, if you already have a `LocalPreferences.toml` file) to the directory of that environment. +At the end of a successfult build, the `build_local.jl` script will create a `LocalPreferences.toml` file (see [`Preferences.jl` documentation](https://juliapackaging.github.io/Preferences.jl/stable/) for more information) in the top-level of the Reactant repository, pointing `libReactantExtra` to the new local build. If you instantiate this environment Reactant will automatically use the new local build + +If you want to use the local build in a different environment: (1) copy the `LocalPreferences.toml` file (or its content, if you already have a `LocalPreferences.toml` file) to the directory of that environment, and (2) ensure that `Reactant_jll` is a direct dependency of that environment (i.e., add `Reactant_jll` to your Project.toml directly). From d4dc15d3ecc2462b5a39c675c0dd5dc7cca5bf62 Mon Sep 17 00:00:00 2001 From: Roman Lee <31547765+romanlee@users.noreply.github.com> Date: Wed, 26 Nov 2025 11:27:31 -0500 Subject: [PATCH 2/4] Update docs/src/tutorials/local-build.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Mosè Giordano <765740+giordano@users.noreply.github.com> --- docs/src/tutorials/local-build.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/src/tutorials/local-build.md b/docs/src/tutorials/local-build.md index 6add0a5766..1af774a8e2 100644 --- a/docs/src/tutorials/local-build.md +++ b/docs/src/tutorials/local-build.md @@ -99,6 +99,7 @@ Finally, you may have to add the flag `--extraopt "--sandbox_writable_path=/path ## `LocalPreferences.toml` file -At the end of a successfult build, the `build_local.jl` script will create a `LocalPreferences.toml` file (see [`Preferences.jl` documentation](https://juliapackaging.github.io/Preferences.jl/stable/) for more information) in the top-level of the Reactant repository, pointing `libReactantExtra` to the new local build. If you instantiate this environment Reactant will automatically use the new local build +At the end of a successful build, the `build_local.jl` script will create a `LocalPreferences.toml` file (see [`Preferences.jl` documentation](https://juliapackaging.github.io/Preferences.jl/stable/) for more information) in the top-level of the Reactant repository, pointing `libReactantExtra` to the new local build. +If you instantiate this environment, Reactant will automatically use the new local build If you want to use the local build in a different environment: (1) copy the `LocalPreferences.toml` file (or its content, if you already have a `LocalPreferences.toml` file) to the directory of that environment, and (2) ensure that `Reactant_jll` is a direct dependency of that environment (i.e., add `Reactant_jll` to your Project.toml directly). From 363358302ca3130b1a0655479a5b35f66a72ae86 Mon Sep 17 00:00:00 2001 From: Roman Lee <31547765+romanlee@users.noreply.github.com> Date: Wed, 26 Nov 2025 11:28:28 -0500 Subject: [PATCH 3/4] Update docs/src/tutorials/local-build.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Mosè Giordano <765740+giordano@users.noreply.github.com> --- docs/src/tutorials/local-build.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/src/tutorials/local-build.md b/docs/src/tutorials/local-build.md index 1af774a8e2..d88858a46e 100644 --- a/docs/src/tutorials/local-build.md +++ b/docs/src/tutorials/local-build.md @@ -102,4 +102,6 @@ Finally, you may have to add the flag `--extraopt "--sandbox_writable_path=/path At the end of a successful build, the `build_local.jl` script will create a `LocalPreferences.toml` file (see [`Preferences.jl` documentation](https://juliapackaging.github.io/Preferences.jl/stable/) for more information) in the top-level of the Reactant repository, pointing `libReactantExtra` to the new local build. If you instantiate this environment, Reactant will automatically use the new local build -If you want to use the local build in a different environment: (1) copy the `LocalPreferences.toml` file (or its content, if you already have a `LocalPreferences.toml` file) to the directory of that environment, and (2) ensure that `Reactant_jll` is a direct dependency of that environment (i.e., add `Reactant_jll` to your Project.toml directly). +If you want to use the local build in a different environment: +1. copy the `LocalPreferences.toml` file (or its content, if you already have a `LocalPreferences.toml` file) to the directory of that environment, and +2. ensure that `Reactant_jll` is a direct dependency of that environment (i.e., add `Reactant_jll` to your `Project.toml` directly). From 851e706b83692df5698b67431adc2c3718951b5f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mos=C3=A8=20Giordano?= <765740+giordano@users.noreply.github.com> Date: Wed, 26 Nov 2025 21:08:05 +0000 Subject: [PATCH 4/4] Apply suggestion from @romanlee Co-authored-by: Roman Lee <31547765+romanlee@users.noreply.github.com> --- docs/src/tutorials/local-build.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/tutorials/local-build.md b/docs/src/tutorials/local-build.md index d88858a46e..59ffc0459d 100644 --- a/docs/src/tutorials/local-build.md +++ b/docs/src/tutorials/local-build.md @@ -100,7 +100,7 @@ Finally, you may have to add the flag `--extraopt "--sandbox_writable_path=/path ## `LocalPreferences.toml` file At the end of a successful build, the `build_local.jl` script will create a `LocalPreferences.toml` file (see [`Preferences.jl` documentation](https://juliapackaging.github.io/Preferences.jl/stable/) for more information) in the top-level of the Reactant repository, pointing `libReactantExtra` to the new local build. -If you instantiate this environment, Reactant will automatically use the new local build +If you instantiate this environment, Reactant will automatically use the new local build. If you want to use the local build in a different environment: 1. copy the `LocalPreferences.toml` file (or its content, if you already have a `LocalPreferences.toml` file) to the directory of that environment, and