Skip to content

Commit 973663d

Browse files
Discourage stripping symbols in devtools
1 parent 3896f07 commit 973663d

File tree

1 file changed

+4
-2
lines changed
  • src/doc/rustc/src/codegen-options

1 file changed

+4
-2
lines changed

Diff for: src/doc/rustc/src/codegen-options/index.md

+4-2
Original file line numberDiff line numberDiff line change
@@ -557,8 +557,10 @@ Supported values for this option are:
557557
using a debugger like gdb or lldb ineffectual.
558558
- `symbols` - same as `debuginfo`, but the rest of the symbol table section is
559559
stripped as well if the linker supports it. On platforms which depend on the
560-
binary's symbol table for backtraces, this can affect them so negatively as to
561-
make the trace completely incomprehensible.
560+
binary's symbol table for backtraces, profiling, and similar, this can affect
561+
them so negatively as to make the results completely incomprehensible.
562+
Programs which may be combined with others, using e.g. CLI pipelines, or any
563+
developer tooling whatsoever, should avoid stripping symbols for this reason.
562564

563565
## symbol-mangling-version
564566

0 commit comments

Comments
 (0)