From 059ad38ddf11ab345fef608fdb05c5c5044373a1 Mon Sep 17 00:00:00 2001
From: Joshua Nelson <jyn514@gmail.com>
Date: Tue, 8 Sep 2020 20:14:05 -0400
Subject: [PATCH] Document how to promote a target from cross-compiled to
 hosted

---
 src/building/new-target.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/building/new-target.md b/src/building/new-target.md
index 24d47eda..022f8f1f 100644
--- a/src/building/new-target.md
+++ b/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).