From 973663db9dbff6c9fda1ad79884cff5a1675cb06 Mon Sep 17 00:00:00 2001 From: Jubilee Young Date: Mon, 1 Apr 2024 13:50:29 -0700 Subject: [PATCH] Discourage stripping symbols in devtools --- src/doc/rustc/src/codegen-options/index.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/doc/rustc/src/codegen-options/index.md b/src/doc/rustc/src/codegen-options/index.md index 5667f0e02ce..36335abb525 100644 --- a/src/doc/rustc/src/codegen-options/index.md +++ b/src/doc/rustc/src/codegen-options/index.md @@ -557,8 +557,10 @@ Supported values for this option are: using a debugger like gdb or lldb ineffectual. - `symbols` - same as `debuginfo`, but the rest of the symbol table section is stripped as well if the linker supports it. On platforms which depend on the - binary's symbol table for backtraces, this can affect them so negatively as to - make the trace completely incomprehensible. + binary's symbol table for backtraces, profiling, and similar, this can affect + them so negatively as to make the results completely incomprehensible. + Programs which may be combined with others, using e.g. CLI pipelines, or any + developer tooling whatsoever, should avoid stripping symbols for this reason. ## symbol-mangling-version