Skip to content

Commit 4994f73

Browse files
Revise strip-symbols paragraph
1 parent 973663d commit 4994f73

File tree

1 file changed

+5
-6
lines changed
  • src/doc/rustc/src/codegen-options

1 file changed

+5
-6
lines changed

src/doc/rustc/src/codegen-options/index.md

+5-6
Original file line numberDiff line numberDiff line change
@@ -555,12 +555,11 @@ Supported values for this option are:
555555
section are stripped at link time and are not copied to the produced binary
556556
or separate files. This should leave backtraces mostly-intact but may make
557557
using a debugger like gdb or lldb ineffectual.
558-
- `symbols` - same as `debuginfo`, but the rest of the symbol table section is
559-
stripped as well if the linker supports it. On platforms which depend on the
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.
558+
- `symbols` - same as `debuginfo`, but the rest of the symbol table section is stripped as well,
559+
depending on platform support. On platforms which depend on this symbol table for backtraces,
560+
profiling, and similar, this can affect them so negatively as to make the trace incomprehensible.
561+
Programs which may be combined with others, such as CLI pipelines and developer tooling,
562+
or even anything which wants crash-reporting, should usually avoid `-Cstrip=symbols`.
564563

565564
## symbol-mangling-version
566565

0 commit comments

Comments
 (0)