diff options
| author | Mads Marquart <mads@marquart.dk> | 2025-01-24 14:44:51 +0100 |
|---|---|---|
| committer | Mads Marquart <mads@marquart.dk> | 2025-01-31 09:41:59 +0100 |
| commit | 7df38d94a1de6194dc6ecf474e62cff94fbadd22 (patch) | |
| tree | d5644e93aef5579dcede91bba44719f85e62a992 | |
| parent | 11de4b71bd8970c9b5491cc1bb13266ce7d05af8 (diff) | |
| download | rust-7df38d94a1de6194dc6ecf474e62cff94fbadd22.tar.gz rust-7df38d94a1de6194dc6ecf474e62cff94fbadd22.zip | |
Recommend adding target spec first, then std support later
Co-Authored-By: Jieyou Xu <jieyouxu@outlook.com>
| -rw-r--r-- | src/doc/rustc/src/target-tier-policy.md | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/src/doc/rustc/src/target-tier-policy.md b/src/doc/rustc/src/target-tier-policy.md index 813c052d6db..a0acfdf0e4a 100644 --- a/src/doc/rustc/src/target-tier-policy.md +++ b/src/doc/rustc/src/target-tier-policy.md @@ -125,6 +125,13 @@ To propose addition of a new target, open a pull request on [`rust-lang/rust`]: See also the documentation in the `rustc-dev-guide` on [adding a new target to `rustc`][rustc_dev_guide_add_target]. +Note that adding a new target that wants to support `std` would transitively +require `cc` and `libc` support. However, these would like to know about the +target from `rustc` as well. To break this cycle, you are strongly encouraged +to add a _minimal_ `#![no_core]` target spec first to teach `rustc` about the +target's existence, and add `std` support as a follow-up once you've added +support for the target in `cc` and `libc`. + [tier3example]: https://github.com/rust-lang/rust/pull/94872 [platform_template]: https://github.com/rust-lang/rust/blob/master/src/doc/rustc/src/platform-support/TEMPLATE.md [summary]: https://github.com/rust-lang/rust/blob/master/src/doc/rustc/src/SUMMARY.md |