@@ -67,14 +67,14 @@ of which 49% is codegen, to building in 7.5s of which 1% is codegen.
67
67
Note that this option does not provide a universal performance improvement for
68
68
every crate; if used when not applicable, this option can make builds much
69
69
* slower* . Deferring compilation of the items in a crate can lead to redoing
70
- code generation for those items repeatedly. In particular, avoid using this
71
- hint for crates whose API surface is mostly used, and/or used in multiple
72
- different crates or binaries (e.g. multiple test binaries that each test a
73
- substantial swath of the API).
70
+ code generation for those items repeatedly. In particular, this hint will
71
+ probably regress compile time if applied to crates whose API surface is mostly
72
+ used, and/or used in multiple different crates or binaries (e.g. multiple test
73
+ binaries that each test a substantial swath of the API).
74
74
75
75
Always do performance analysis when considering this hint, and only apply it if
76
- it applies obvious and substantial wins for your users. Never apply it across
77
- the board to all your dependencies.
76
+ it applies obvious and substantial wins for your users. Applying it across the
77
+ board to all your dependencies will likely regress compilation time .
78
78
79
79
If most of the items in your crate are polymorphic (generic), this hint may be
80
80
redundant, as Rust already defers compilation of polymorphic items until they
0 commit comments