[llvm] e758237 - [docs] Mention --discard-locals/--discard-all change for llvm-strip

[via llvm-commits]

Author: Fangrui Song
Date: 2025-03-17T20:09:52-07:00
New Revision: e758237352f70fad028f3947e6f0404e50fec024

URL: https://github.com/llvm/llvm-project/commit/e758237352f70fad028f3947e6f0404e50fec024
DIFF: https://github.com/llvm/llvm-project/commit/e758237352f70fad028f3947e6f0404e50fec024.diff

LOG: [docs] Mention --discard-locals/--discard-all change for llvm-strip

PR #130704 updated llvm-strip as well.

Suggested by @nga888

Pull Request: https://github.com/llvm/llvm-project/pull/131491

Added: 
    

Modified: 
    llvm/docs/CommandGuide/llvm-strip.rst
    llvm/docs/ReleaseNotes.md

Removed: 
    


################################################################################
diff  --git a/llvm/docs/CommandGuide/llvm-strip.rst b/llvm/docs/CommandGuide/llvm-strip.rst
index b0777991eb901..b4d6dc08dc1ac 100644
--- a/llvm/docs/CommandGuide/llvm-strip.rst
+++ b/llvm/docs/CommandGuide/llvm-strip.rst
@@ -37,9 +37,10 @@ multiple file formats.
 
 .. option:: --discard-all, -x
 
- Remove most local symbols from the output. Different file formats may limit
- this to a subset of the local symbols. For example, file and section symbols in
- ELF objects will not be discarded. Additionally, remove all debug sections.
+ Remove most local symbols not referenced by relocations from the output.
+ Different file formats may limit this to a subset of the local symbols. For
+ example, file and section symbols in ELF objects will not be discarded.
+ Additionally, remove all debug sections.
 
 .. option::  --enable-deterministic-archives, -D
 
@@ -152,7 +153,7 @@ them.
 
 .. option:: --discard-locals, -X
 
- Remove local symbols starting with ".L" from the output.
+ Remove local symbols starting with ".L" not referenced by relocations from the output.
 
 .. option:: --keep-file-symbols
 

diff  --git a/llvm/docs/ReleaseNotes.md b/llvm/docs/ReleaseNotes.md
index 111cdb796a2a8..1a948a4d4d86e 100644
--- a/llvm/docs/ReleaseNotes.md
+++ b/llvm/docs/ReleaseNotes.md
@@ -169,7 +169,8 @@ Changes to the LLVM tools
 
 * llvm-objcopy now supports the `--update-section` flag for intermediate Mach-O object files.
 * llvm-strip now supports continuing to process files on encountering an error.
-* In llvm-objcopy's ELF port, `--discard-locals` and `--discard-all` now allow and preserve symbols referenced by relocations.
+* In llvm-objcopy/llvm-strip's ELF port, `--discard-locals` and `--discard-all` now allow and preserve symbols referenced by relocations.
+  ([#47468](https://github.com/llvm/llvm-project/issues/47468))
 
 Changes to LLDB
 ---------------------------------