@@ -49,19 +49,19 @@ Guard](https://docs.microsoft.com/en-us/windows/win32/secbp/control-flow-guard)
4949platform security feature. This flag is currently ignored for non-Windows targets.
5050It takes one of the following values:
5151
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.
5353*  ` nochecks ` : emit Control Flow Guard metadata without runtime enforcement checks (this
5454should 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).
5656
5757## debug-assertions  
5858
5959This flag lets you turn ` cfg(debug_assertions) `  [ conditional
6060compilation] ( ../../reference/conditional-compilation.md#debug_assertions )  on
6161or off. It takes one of the following values:
6262
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.
6565
6666If not specified, debug assertions are automatically enabled only if the
6767[ opt-level] ( #opt-level )  is 0.
@@ -82,8 +82,8 @@ Note: The [`-g` flag][option-g-debug] is an alias for `-C debuginfo=2`.
8282This flag controls whether or not the linker includes its default libraries.
8383It takes one of the following values:
8484
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.
8787
8888For example, for gcc flavor linkers, this issues the ` -nodefaultlibs `  flag to
8989the linker.
@@ -93,8 +93,8 @@ the linker.
9393This flag controls whether or not the compiler embeds LLVM bitcode into object
9494files. It takes one of the following values:
9595
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.
9898
9999LLVM bitcode is required when rustc is performing link-time optimization (LTO).
100100It is also required on some targets like iOS ones where vendors look for LLVM
@@ -135,8 +135,8 @@ flag][option-emit] for more information.
135135This flag forces the use of frame pointers. It takes one of the following
136136values:
137137
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
140140  not necessarily mean frame pointers will be removed.
141141
142142The default behaviour, if frame pointers are not force-enabled, depends on the
@@ -147,8 +147,8 @@ target.
147147This flag forces the generation of unwind tables. It takes one of the following
148148values:
149149
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
152152  tables are required by the target an error will be emitted.
153153
154154The default if not specified depends on the target.
@@ -202,8 +202,8 @@ options should be separated by spaces.
202202This flag controls whether the linker will keep dead code. It takes one of
203203the following values:
204204
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).
207207
208208An example of when this flag might be useful is when trying to construct code coverage
209209metrics.
@@ -215,8 +215,8 @@ linker will use libraries and objects shipped with Rust instead or those in the
215215It takes one of the following values:
216216
217217*  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.
220220
221221This allows overriding cases when detection fails or user wants to use shipped libraries.
222222
@@ -261,8 +261,8 @@ This flag defers LTO optimizations to the linker. See
261261[ linker-plugin-LTO] ( ../linker-plugin-lto.md )  for more details. It takes one of
262262the following values:
263263
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).
266266*  A path to the linker plugin.
267267
268268More specifically this flag will cause the compiler to replace its typical
@@ -292,9 +292,9 @@ optimizations](https://llvm.org/docs/LinkTimeOptimization.html) to produce
292292better optimized code, using whole-program analysis, at the cost of longer
293293linking time. It takes one of the following values:
294294
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
296296  perform optimizations across all crates within the dependency graph.
297- *  ` n ` , ` no ` , ` off ` : disables LTO.
297+ *  ` n ` , ` no ` , ` off ` ,  ` false ` : disables LTO.
298298*  ` thin ` : perform [ "thin"
299299  LTO] ( http://blog.llvm.org/2016/06/thinlto-scalable-and-incremental-lto.html ) .
300300  This is similar to "fat", but takes substantially less time to run while
@@ -333,8 +333,8 @@ This flag allows you to disable [the
333333red zone] ( https://en.wikipedia.org/wiki/Red_zone_\( computing\)  ) . It takes one
334334of the following values:
335335
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.
338338
339339The default behaviour, if the flag is not specified, depends on the target.
340340
@@ -376,8 +376,8 @@ overflow](../../reference/expressions/operator-expr.md#overflow). When
376376overflow-checks are enabled, a panic will occur on overflow. This flag takes
377377one of the following values:
378378
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.
381381
382382If not specified, overflow checks are enabled if
383383[ debug-assertions] ( #debug-assertions )  are enabled, disabled otherwise.
@@ -409,8 +409,8 @@ for determining whether or not it is possible to statically or dynamically
409409link with a dependency. For example, ` cdylib `  crate types may only use static
410410linkage. This flag takes one of the following values:
411411
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).
414414
415415## profile-generate  
416416
@@ -487,24 +487,24 @@ The list of passes should be separated by spaces.
487487This flag controls whether [ ` rpath ` ] ( https://en.wikipedia.org/wiki/Rpath )  is
488488enabled. It takes one of the following values:
489489
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).
492492
493493## save-temps  
494494
495495This flag controls whether temporary files generated during compilation are
496496deleted once compilation finishes. It takes one of the following values:
497497
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).
500500
501501## soft-float  
502502
503503This option controls whether ` rustc `  generates code that emulates floating
504504point instructions in software. It takes one of the following values:
505505
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).
508508
509509## split-debuginfo  
510510
0 commit comments