Skip to content

Commit 13c8776

Browse files
authored
Merge pull request #18 from brson/bluh
Changes to platform support description
2 parents 0da0e4a + dc55425 commit 13c8776

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

platform-support.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,13 @@ whether the corresponding component works on the specified platform.
1515

1616
## Tier 1
1717

18-
Tier 1 platforms can be thought of as "guaranteed to build and work".
18+
Tier 1 platforms can be thought of as "guaranteed to work".
1919
Specifically they will each satisfy the following requirements:
2020

21+
* Official binary releases are provided for the platform.
2122
* Automated testing is set up to run tests for the platform.
2223
* Landing changes to the `rust-lang/rust` repository's master branch is gated on
2324
tests passing.
24-
* Official release artifacts are provided for the platform.
2525
* Documentation for how to use and how to build the platform is available.
2626

2727
| Target | std |rustc|cargo| notes |
@@ -42,11 +42,11 @@ are not run so it's not guaranteed to produce a working build, but platforms
4242
often work to quite a good degree and patches are always welcome! Specifically,
4343
these platforms are required to have each of the following:
4444

45+
* Official binary releases are provided for the platform.
4546
* Automated building is set up, but may not be running tests.
4647
* Landing changes to the `rust-lang/rust` repository's master branch is gated on
47-
platforms **building**. Note that this means for some platforms only the
48-
standard library is compiled, but for others the full bootstrap is run.
49-
* Official release artifacts are provided for the platform.
48+
platforms **building**. For some platforms only the standard library is
49+
compiled, but for others `rustc` and `cargo` are too.
5050

5151
| Target | std |rustc|cargo| notes |
5252
|---------------------------------|-----|-----|-----|----------------------------|
@@ -75,12 +75,9 @@ these platforms are required to have each of the following:
7575

7676
## Tier 3
7777

78-
Tier 3 platforms are those which Rust has support for, but landing changes is
79-
not gated on the platform either building or passing tests. Working builds for
80-
these platforms may be spotty as their reliability is often defined in terms of
81-
community contributions. Additionally, release artifacts and installers are not
82-
provided, but there may be community infrastructure producing these in
83-
unofficial locations.
78+
Tier 3 platforms are those which the Rust codebase has support for, but
79+
which are not built or tested automatically, and may not work.
80+
Official builds are not available.
8481

8582
| Target | std |rustc|cargo| notes |
8683
|-------------------------------|-----|-----|-----|----------------------------|
@@ -95,6 +92,9 @@ unofficial locations.
9592
| `x86_64-unknown-dragonfly` ||| | 64-bit DragonFlyBSD |
9693
| `x86_64-unknown-openbsd` ||| | 64-bit OpenBSD |
9794

98-
Note that this table can be expanded over time, this isn't the exhaustive set of
99-
tier 3 platforms that will ever be!
95+
But those aren't the only platforms Rust can compile to, those are the ones that
96+
require the standard library. When linking only to the core library, Rust can
97+
target "bare metal" in the x86, ARM, MIPS, and PowerPC families, and thus applied
98+
to a variety of problems. It may require defining custom target specifications
99+
to do so. All such scenarios are tier 3.
100100

0 commit comments

Comments
 (0)