From 4994f73a27260e837af98ef906d30d6e512bc52f Mon Sep 17 00:00:00 2001 From: Jubilee Young Date: Mon, 1 Apr 2024 14:07:59 -0700 Subject: [PATCH] Revise strip-symbols paragraph --- src/doc/rustc/src/codegen-options/index.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/src/doc/rustc/src/codegen-options/index.md b/src/doc/rustc/src/codegen-options/index.md index 36335abb525..0f96f6cb2bc 100644 --- a/src/doc/rustc/src/codegen-options/index.md +++ b/src/doc/rustc/src/codegen-options/index.md @@ -555,12 +555,11 @@ Supported values for this option are: section are stripped at link time and are not copied to the produced binary or separate files. This should leave backtraces mostly-intact but may make 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, 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. +- `symbols` - same as `debuginfo`, but the rest of the symbol table section is stripped as well, + depending on platform support. On platforms which depend on this symbol table for backtraces, + profiling, and similar, this can affect them so negatively as to make the trace incomprehensible. + Programs which may be combined with others, such as CLI pipelines and developer tooling, + or even anything which wants crash-reporting, should usually avoid `-Cstrip=symbols`. ## symbol-mangling-version