@@ -5,22 +5,26 @@ new variants to AST representation), they should modify rustfmt in such a
5
5
way to keep existing formatting verbatim.
6
6
7
7
Rustfmt is allowed to implement nightly-only formatting behavior without that
8
- syntax being specified by the style guide. Initial PR implementors are
9
- encouraged but not required to open a PR against rustfmt suggesting an initial
8
+ syntax being specified by the style guide. The initial authors of PRs
9
+ implementing new features in rust-lang/rust are encouraged, but not
10
+ required, to open a PR against
11
+ [ rustfmt] ( https://github.com/rust-lang/rustfmt ) suggesting an initial
10
12
formatting behavior, or formatting may later be implemented as a PR by anyone,
11
13
pending approval of the implementation from T-rustfmt. T-style should be
12
14
notified to approve the interim style proposed by these PRs, but this decision
13
15
is not binding and may be revisited until the feature is stabilized and the
14
16
formatting is codified in the style guide.
15
17
16
- Much like breaking nightly feature changes in the Rust compiler, changes should
17
- be not done unnecessarily, and should take into account the feature's adoption
18
+ Much like breaking nightly feature changes in the Rust compiler, any changes
19
+ to formatting behavior for nightly syntax should be made cautiously and with
20
+ thorough consideration to avoid churn. Changes should not be done unnecessarily,
21
+ and should take into account the feature's adoption
18
22
and readiness for stabilization. However, changes may be done until the feature
19
23
is stabilized for various reasons: new understanding of the feature's usage in
20
24
the language, recommendation from T-style, or changes in the implementation of
21
25
the feature.
22
26
23
27
Feature stabilization should be blocked on confirmation and codification of
24
- formatting bheavior . At this point, T-style may also propose alternative
28
+ formatting behavior . At this point, T-style may also propose alternative
25
29
formatting at the time of stabilization, with any breaking changes weighted
26
30
according to the principle stated above.
0 commit comments