about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
authorJoshua Nelson <jyn514@gmail.com>2020-09-08 20:14:05 -0400
committerTshepang Lekhonkhobe <tshepang@gmail.com>2020-09-09 21:39:55 +0200
commitcbdf90fd573906b92ece5ef4f75b2293576e036e (patch)
treef25defa4b15a71345d12bbbc1895cc04a7d9d709 /src/doc/rustc-dev-guide
parent447654ef9e02be29b5ea18252854b07f553282c5 (diff)
downloadrust-cbdf90fd573906b92ece5ef4f75b2293576e036e.tar.gz
rust-cbdf90fd573906b92ece5ef4f75b2293576e036e.zip
Document how to promote a target from cross-compiled to hosted
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/building/new-target.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/building/new-target.md b/src/doc/rustc-dev-guide/src/building/new-target.md
index 24d47edad7e..022f8f1fb08 100644
--- a/src/doc/rustc-dev-guide/src/building/new-target.md
+++ b/src/doc/rustc-dev-guide/src/building/new-target.md
@@ -99,3 +99,12 @@ compiler/rustc library/std
 
 If your target specification is already available in the bootstrap
 compiler, you can use it instead of the JSON file for both arguments.
+
+## Promoting a target from tier 2 (target) to tier 2 (host)
+
+There are two levels of tier 2 targets:
+a) Targets that are only cross-compiled (`rustup target add`)
+b) Targets that have a native toolchain (`rustup toolchain install`)
+
+For an example of promoting a target from cross-compiled to native,
+see [!75914](https://github.com/rust-lang/rust/pull/75914).