about summary refs log tree commit diff
diff options
context:
space:
mode:
authorMatthias Krüger <matthias.krueger@famsik.de>2024-03-13 20:01:58 +0100
committerGitHub <noreply@github.com>2024-03-13 20:01:58 +0100
commit8d2f79c3f189f552e0dbc5fdfafcf3fc6b9e6037 (patch)
treea12f6df0b0e392aa1399e7bf99e5357366f42277
parent89c3fa92d41d194676e9edefdb72e7a5a5e730ab (diff)
parent2366d97d81d03a4b4876adfb5b0c3b94fd562918 (diff)
downloadrust-8d2f79c3f189f552e0dbc5fdfafcf3fc6b9e6037.tar.gz
rust-8d2f79c3f189f552e0dbc5fdfafcf3fc6b9e6037.zip
Rollup merge of #122442 - RalfJung:print-mono-items, r=compiler-errors
extend docs of -Zprint-mono-items

Currently the values one can set this to are not documented anywhere.

I think ideally this flag wouldn't overwrite the collector's behavior, a "print" flag should just print what happens but not change what happens. But our codegen-units tests rely on being able to collect all items without the other side-effects of `-C link-dead-code` and I can't tell whether that reliance is incidental or crucial, so I'm not touching this and just documenting the (messy) status quo.
-rw-r--r--compiler/rustc_session/src/options.rs4
1 files changed, 3 insertions, 1 deletions
diff --git a/compiler/rustc_session/src/options.rs b/compiler/rustc_session/src/options.rs
index 2f018fbaa86..9c03bdb2187 100644
--- a/compiler/rustc_session/src/options.rs
+++ b/compiler/rustc_session/src/options.rs
@@ -1831,7 +1831,9 @@ options! {
     print_llvm_passes: bool = (false, parse_bool, [UNTRACKED],
         "print the LLVM optimization passes being run (default: no)"),
     print_mono_items: Option<String> = (None, parse_opt_string, [UNTRACKED],
-        "print the result of the monomorphization collection pass"),
+        "print the result of the monomorphization collection pass. \
+         Value `lazy` means to use normal collection; `eager` means to collect all items.
+         Note that this overwrites the effect `-Clink-dead-code` has on collection!"),
     print_type_sizes: bool = (false, parse_bool, [UNTRACKED],
         "print layout information for each type encountered (default: no)"),
     print_vtable_sizes: bool = (false, parse_bool, [UNTRACKED],