@@ -49,19 +49,19 @@ Guard](https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard)
49
49
platform security feature. This flag is currently ignored for non-Windows targets.
50
50
It takes one of the following values:
51
51
52
- * ` y ` , ` yes ` , ` on ` , ` checks ` , or no value: enable Control Flow Guard.
52
+ * ` y ` , ` yes ` , ` on ` , ` true ` , ` checks ` , or no value: enable Control Flow Guard.
53
53
* ` nochecks ` : emit Control Flow Guard metadata without runtime enforcement checks (this
54
54
should only be used for testing purposes as it does not provide security enforcement).
55
- * ` n ` , ` no ` , ` off ` : do not enable Control Flow Guard (the default).
55
+ * ` n ` , ` no ` , ` off ` , ` false ` : do not enable Control Flow Guard (the default).
56
56
57
57
## debug-assertions
58
58
59
59
This flag lets you turn ` cfg(debug_assertions) ` [ conditional
60
60
compilation] ( ../../reference/conditional-compilation.md#debug_assertions ) on
61
61
or off. It takes one of the following values:
62
62
63
- * ` y ` , ` yes ` , ` on ` , or no value: enable debug-assertions.
64
- * ` n ` , ` no ` , or ` off ` : disable debug-assertions.
63
+ * ` y ` , ` yes ` , ` on ` , ` true ` , or no value: enable debug-assertions.
64
+ * ` n ` , ` no ` , ` off ` or ` false ` : disable debug-assertions.
65
65
66
66
If not specified, debug assertions are automatically enabled only if the
67
67
[ opt-level] ( #opt-level ) is 0.
@@ -82,8 +82,8 @@ Note: The [`-g` flag][option-g-debug] is an alias for `-C debuginfo=2`.
82
82
This flag controls whether or not the linker includes its default libraries.
83
83
It takes one of the following values:
84
84
85
- * ` y ` , ` yes ` , ` on ` , or no value: include default libraries (the default).
86
- * ` n ` , ` no ` , or ` off ` : exclude default libraries.
85
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: include default libraries (the default).
86
+ * ` n ` , ` no ` , ` off ` or ` false ` : exclude default libraries.
87
87
88
88
For example, for gcc flavor linkers, this issues the ` -nodefaultlibs ` flag to
89
89
the linker.
@@ -93,8 +93,8 @@ the linker.
93
93
This flag controls whether or not the compiler embeds LLVM bitcode into object
94
94
files. It takes one of the following values:
95
95
96
- * ` y ` , ` yes ` , ` on ` , or no value: put bitcode in rlibs (the default).
97
- * ` n ` , ` no ` , or ` off ` : omit bitcode from rlibs.
96
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: put bitcode in rlibs (the default).
97
+ * ` n ` , ` no ` , ` off ` or ` false ` : omit bitcode from rlibs.
98
98
99
99
LLVM bitcode is required when rustc is performing link-time optimization (LTO).
100
100
It is also required on some targets like iOS ones where vendors look for LLVM
@@ -135,8 +135,8 @@ flag][option-emit] for more information.
135
135
This flag forces the use of frame pointers. It takes one of the following
136
136
values:
137
137
138
- * ` y ` , ` yes ` , ` on ` , or no value: force-enable frame pointers.
139
- * ` n ` , ` no ` , or ` off ` : do not force-enable frame pointers. This does
138
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: force-enable frame pointers.
139
+ * ` n ` , ` no ` , ` off ` or ` false ` : do not force-enable frame pointers. This does
140
140
not necessarily mean frame pointers will be removed.
141
141
142
142
The default behaviour, if frame pointers are not force-enabled, depends on the
@@ -147,8 +147,8 @@ target.
147
147
This flag forces the generation of unwind tables. It takes one of the following
148
148
values:
149
149
150
- * ` y ` , ` yes ` , ` on ` , or no value: Unwind tables are forced to be generated.
151
- * ` n ` , ` no ` , or ` off ` : Unwind tables are not forced to be generated. If unwind
150
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: Unwind tables are forced to be generated.
151
+ * ` n ` , ` no ` , ` off ` or ` false ` : Unwind tables are not forced to be generated. If unwind
152
152
tables are required by the target an error will be emitted.
153
153
154
154
The default if not specified depends on the target.
@@ -202,8 +202,8 @@ options should be separated by spaces.
202
202
This flag controls whether the linker will keep dead code. It takes one of
203
203
the following values:
204
204
205
- * ` y ` , ` yes ` , ` on ` , or no value: keep dead code.
206
- * ` n ` , ` no ` , or ` off ` : remove dead code (the default).
205
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: keep dead code.
206
+ * ` n ` , ` no ` , ` off ` or ` false ` : remove dead code (the default).
207
207
208
208
An example of when this flag might be useful is when trying to construct code coverage
209
209
metrics.
@@ -215,8 +215,8 @@ linker will use libraries and objects shipped with Rust instead or those in the
215
215
It takes one of the following values:
216
216
217
217
* no value: rustc will use heuristic to disable self-contained mode if system has necessary tools.
218
- * ` y ` , ` yes ` , ` on ` : use only libraries/objects shipped with Rust.
219
- * ` n ` , ` no ` , or ` off ` : rely on the user or the linker to provide non-Rust libraries/objects.
218
+ * ` y ` , ` yes ` , ` on ` , ` true ` : use only libraries/objects shipped with Rust.
219
+ * ` n ` , ` no ` , ` off ` or ` false ` : rely on the user or the linker to provide non-Rust libraries/objects.
220
220
221
221
This allows overriding cases when detection fails or user wants to use shipped libraries.
222
222
@@ -261,8 +261,8 @@ This flag defers LTO optimizations to the linker. See
261
261
[ linker-plugin-LTO] ( ../linker-plugin-lto.md ) for more details. It takes one of
262
262
the following values:
263
263
264
- * ` y ` , ` yes ` , ` on ` , or no value: enable linker plugin LTO.
265
- * ` n ` , ` no ` , or ` off ` : disable linker plugin LTO (the default).
264
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: enable linker plugin LTO.
265
+ * ` n ` , ` no ` , ` off ` or ` false ` : disable linker plugin LTO (the default).
266
266
* A path to the linker plugin.
267
267
268
268
More specifically this flag will cause the compiler to replace its typical
@@ -292,9 +292,9 @@ optimizations](https://llvm.org/docs/LinkTimeOptimization.html) to produce
292
292
better optimized code, using whole-program analysis, at the cost of longer
293
293
linking time. It takes one of the following values:
294
294
295
- * ` y ` , ` yes ` , ` on ` , ` fat ` , or no value: perform "fat" LTO which attempts to
295
+ * ` y ` , ` yes ` , ` on ` , ` true ` , ` fat ` , or no value: perform "fat" LTO which attempts to
296
296
perform optimizations across all crates within the dependency graph.
297
- * ` n ` , ` no ` , ` off ` : disables LTO.
297
+ * ` n ` , ` no ` , ` off ` , ` false ` : disables LTO.
298
298
* ` thin ` : perform [ "thin"
299
299
LTO] ( http://blog.llvm.org/2016/06/thinlto-scalable-and-incremental-lto.html ) .
300
300
This is similar to "fat", but takes substantially less time to run while
@@ -333,8 +333,8 @@ This flag allows you to disable [the
333
333
red zone] ( https://en.wikipedia.org/wiki/Red_zone_\( computing\) ) . It takes one
334
334
of the following values:
335
335
336
- * ` y ` , ` yes ` , ` on ` , or no value: disable the red zone.
337
- * ` n ` , ` no ` , or ` off ` : enable the red zone.
336
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: disable the red zone.
337
+ * ` n ` , ` no ` , ` off ` or ` false ` : enable the red zone.
338
338
339
339
The default behaviour, if the flag is not specified, depends on the target.
340
340
@@ -376,8 +376,8 @@ overflow](../../reference/expressions/operator-expr.md#overflow). When
376
376
overflow-checks are enabled, a panic will occur on overflow. This flag takes
377
377
one of the following values:
378
378
379
- * ` y ` , ` yes ` , ` on ` , or no value: enable overflow checks.
380
- * ` n ` , ` no ` , or ` off ` : disable overflow checks.
379
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: enable overflow checks.
380
+ * ` n ` , ` no ` , ` off ` or ` false ` : disable overflow checks.
381
381
382
382
If not specified, overflow checks are enabled if
383
383
[ debug-assertions] ( #debug-assertions ) are enabled, disabled otherwise.
@@ -409,8 +409,8 @@ for determining whether or not it is possible to statically or dynamically
409
409
link with a dependency. For example, ` cdylib ` crate types may only use static
410
410
linkage. This flag takes one of the following values:
411
411
412
- * ` y ` , ` yes ` , ` on ` , or no value: use dynamic linking.
413
- * ` n ` , ` no ` , or ` off ` : use static linking (the default).
412
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: use dynamic linking.
413
+ * ` n ` , ` no ` , ` off ` or ` false ` : use static linking (the default).
414
414
415
415
## profile-generate
416
416
@@ -487,24 +487,24 @@ The list of passes should be separated by spaces.
487
487
This flag controls whether [ ` rpath ` ] ( https://en.wikipedia.org/wiki/Rpath ) is
488
488
enabled. It takes one of the following values:
489
489
490
- * ` y ` , ` yes ` , ` on ` , or no value: enable rpath.
491
- * ` n ` , ` no ` , or ` off ` : disable rpath (the default).
490
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: enable rpath.
491
+ * ` n ` , ` no ` , ` off ` or ` false ` : disable rpath (the default).
492
492
493
493
## save-temps
494
494
495
495
This flag controls whether temporary files generated during compilation are
496
496
deleted once compilation finishes. It takes one of the following values:
497
497
498
- * ` y ` , ` yes ` , ` on ` , or no value: save temporary files.
499
- * ` n ` , ` no ` , or ` off ` : delete temporary files (the default).
498
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: save temporary files.
499
+ * ` n ` , ` no ` , ` off ` or ` false ` : delete temporary files (the default).
500
500
501
501
## soft-float
502
502
503
503
This option controls whether ` rustc ` generates code that emulates floating
504
504
point instructions in software. It takes one of the following values:
505
505
506
- * ` y ` , ` yes ` , ` on ` , or no value: use soft floats.
507
- * ` n ` , ` no ` , or ` off ` : use hardware floats (the default).
506
+ * ` y ` , ` yes ` , ` on ` , ` true ` or no value: use soft floats.
507
+ * ` n ` , ` no ` , ` off ` or ` false ` : use hardware floats (the default).
508
508
509
509
## split-debuginfo
510
510
0 commit comments