Skip to content

Commit 48f3c43

Browse files
committed
per TC's suggestion, update wording to fit IETF RFC 2119
1 parent b6cccd2 commit 48f3c43

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

text/0000-cargo-check-lang-policy.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,11 @@ The RFC gives a clear policy from T-lang's perspective so that both other teams
2424
* `cargo check` only catches some subset of the possible compilation errors.
2525
* A Rust program **must** compile with `cargo build` to be covered by Rust's standard stability guarantee.
2626

27-
Specifically, if a given Rust program passes `cargo check` but **not** `cargo build` in one version of Rust, then in any future version of Rust that program *can* begin to also fail `cargo check`, and this is **not** considered a breaking change.
27+
Specifically, if a given Rust program does not compile with `cargo build` then it might or might not pass `cargo check`. If a program does not compile with `cargo build` but does pass `cargo check` it still might not pass a `cargo check` in a future version of Rust. Changes in `cargo check` outcome when `cargo build` does not work are not considered a breaking change in Rust.
2828

29-
`cargo check` should catch as many errors as possible, but the emphasis is on giving a fast answer rather than giving a complete answer. If you need a complete answer then you need to use `cargo build`.
29+
`cargo check` **should** catch as many errors as possible, but the emphasis of `cargo check` is on giving a "fast" answer rather than giving a "complete" answer. If you need a complete answer with all possible errors accounted for then you **must** use `cargo build`.
3030

31-
The optimization level of the compiler **should not** affect if the program compiles or not (using `build` or `check`). Any such case is very likely a bug, and T-lang will have to make a determination on a case-by-case basis.
31+
Any example where the optimization level can affect if a program passes `cargo check` and/or `cargo build` is a bug. There are no situations where a change in optimization level is intended to affect if a `check` or `build` is successful.
3232

3333
# Unresolved questions
3434
[unresolved-questions]: #unresolved-questions

0 commit comments

Comments
 (0)