mirror
/
rustc-dev-guide
mirror of https://github.com/rust-lang/rustc-dev-guide.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Remove a dead link in `new-target.md` + other nits (#1186)

This commit is contained in:
Rahul Butani 2021-08-10 04:41:44 -07:00 committed by GitHub
parent cb2c542217
commit 6893645e60
1 changed files with 8 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
src/building/new-target.md
View File

@ -20,15 +20,15 @@ cd src/llvm-project
git remote add my-target-llvm some-llvm-repository git remote add my-target-llvm some-llvm-repository
git checkout my-target-llvm/my-branch git checkout my-target-llvm/my-branch
cd .. cd ..
git add llvm_target git add llvm-project
git commit -m 'Use my custom LLVM' git commit -m 'Use my custom LLVM'
``` ```
### Using pre-built LLVM ### Using pre-built LLVM
If you have a local LLVM checkout that is already built, you may be If you have a local LLVM checkout that is already built, you may be
able to configure Rust to treat your build as the [system LLVM][sysllvm] able to configure Rust to treat your build as the system LLVM to avoid
to avoid redundant builds. redundant builds.
You can tell Rust to use a pre-built version of LLVM using the `target` section You can tell Rust to use a pre-built version of LLVM using the `target` section
of `config.toml`: of `config.toml`:
@ -74,7 +74,7 @@ You will need to add a line to the big table inside of the
will then add a corresponding file for your new target containing a will then add a corresponding file for your new target containing a
`target` function. `target` function.
Look for existing targets to use as examples Look for existing targets to use as examples.
## Patching crates ## Patching crates
@ -125,8 +125,10 @@ compiler, you can use it instead of the JSON file for both arguments.
## Promoting a target from tier 2 (target) to tier 2 (host) ## Promoting a target from tier 2 (target) to tier 2 (host)
There are two levels of tier 2 targets: There are two levels of tier 2 targets:
a) Targets that are only cross-compiled (`rustup target add`) a) Targets that are only cross-compiled (`rustup target add`)
b) Targets that have a native toolchain (`rustup toolchain install`) b) Targets that [have a native toolchain][tier2-native] (`rustup toolchain install`)
[tier2-native]: https://doc.rust-lang.org/nightly/rustc/target-tier-policy.html#tier-2-with-host-tools
For an example of promoting a target from cross-compiled to native, For an example of promoting a target from cross-compiled to native,
see [#75914](https://github.com/rust-lang/rust/pull/75914). see [#75914](https://github.com/rust-lang/rust/pull/75914).