[binutils-gdb] Update the binutils documentation to make it clear the the --strip-unneeded option of objcopy and st

[Nick Clifton]

https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=427234c78bddbea7c94fa1a35e74b7dfeabeeb43

commit 427234c78bddbea7c94fa1a35e74b7dfeabeeb43
Author: Ludovic Court?s <ludo@gnu.org>
Date:   Mon Sep 21 16:08:55 2020 +0100

    Update the binutils documentation to make it clear the the --strip-unneeded option of objcopy and strip implies the --strip-debug option.
    
            * doc/binutils.texi (objcopy, strip): Say that
            '--strip-unneeded' implies '--strip-debug'.

Diff:
---
 binutils/ChangeLog         | 5 +++++
 binutils/doc/binutils.texi | 9 +++++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index db839dc4ae8..5e8eb987371 100644
--- a/binutils/ChangeLog
+++ b/binutils/ChangeLog
@@ -1,3 +1,8 @@
+2020-09-21  Ludovic Courtès  <ludo@gnu.org>
+
+	* doc/binutils.texi (objcopy, strip): Say that
+        '--strip-unneeded' implies '--strip-debug'.
+
 2020-09-16  Anatoly Parshintsev  <kupokupokupopo@gmail.com>
 
        * verilog.c (verilog_write_address): Properly handle 64-bit
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index 35a5a67041e..837b7591b06 100644
--- a/binutils/doc/binutils.texi
+++ b/binutils/doc/binutils.texi
@@ -1404,13 +1404,16 @@ will remove all relocations for sections matching the pattern
 @item -S
 @itemx --strip-all
 Do not copy relocation and symbol information from the source file.
+Also deletes debug sections.
 
 @item -g
 @itemx --strip-debug
 Do not copy debugging symbols or sections from the source file.
 
 @item --strip-unneeded
-Strip all symbols that are not needed for relocation processing.
+Remove all symbols that are not needed for relocation processing in
+addition to debugging symbols and sections stripped by
+@option{--strip-debug}.
 
 @item -K @var{symbolname}
 @itemx --keep-symbol=@var{symbolname}
@@ -3387,7 +3390,9 @@ See the description of this option in the @command{objcopy} section
 for more information.
 
 @item --strip-unneeded
-Remove all symbols that are not needed for relocation processing.
+Remove all symbols that are not needed for relocation processing in
+addition to debugging symbols and sections stripped by
+@option{--strip-debug}.
 
 @item -K @var{symbolname}
 @itemx --keep-symbol=@var{symbolname}