From: Roland Pesch <pesch@cygnus>
Date: Sat, 8 Aug 1992 01:13:23 +0000 (+0000)
Subject: Strip has mutated; remove all existing option documentation, document
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=1815e42cc3cbf95cd12055515a85a707ba7dc764;p=binutils-gdb.git

Strip has mutated; remove all existing option documentation, document
only -v (verbose).
---

diff --git a/binutils/binutils.texi b/binutils/binutils.texi
index d53cbc1228a..226e58646ea 100644
--- a/binutils/binutils.texi
+++ b/binutils/binutils.texi
@@ -879,17 +879,14 @@ Display version number information on @code{size} itself.
 @kindex strip
 @cindex removing symbols
 @cindex discarding symbols
+@cindex symbols, discarding
 
 @smallexample
-  strip [ -s | +strip-all ]  [ -g | -S | +strip-debug ]
-         [ -x | +discard-all ]  [ -X | +discard-locals ]
-         [ -T @var{bfdname} ]
-         @var{objfiles}@dots{}
+  strip [ -v ] @var{objfiles}@dots{}
 @end smallexample
 
 GNU @code{strip} will discard all symbols from object files
-@var{objfiles}, if no options are specified; or only certain symbols,
-depending on its command-line options.
+@var{objfiles}.  The list of object files may include archives.
 
 @code{strip} will not execute unless at least one object file is listed.
 
@@ -898,40 +895,10 @@ depending on its command-line options.
 rather than writing modified copies under different names.
 @end quotation
 
-The long and short forms of options, shown here as alternatives, are
-equivalent.
-
 @table @code
-@item -s
-@itemx +strip-all 
-@cindex all symbols, discarding
-This is the default case: strip all symbol entries from @var{objfiles}.
-
-@item -g
-@itemx -S
-@itemx +strip-debug 
-@cindex debugging symbols, discarding
-Discard only debugging symbol information from @var{objfiles}.
-
-@item -x
-@itemx +discard-all 
-@cindex local symbols, discarding
-Discard all symbols local to each file in @var{objfiles}.
-@emph{WARNING:} Note that @code{+discard-all} discards only @emph{local}
-symbols, in spite of its name.
-
-@item -X
-@itemx +discard-locals 
-Discard local symbols starting with @samp{L} from each file in
-@var{objfiles}.  (Some compilers produce internally-used symbols that
-begin with @samp{L}.)
-
-@item -T @var{bfdname}
-@cindex object code format
-You can specify a particular object-code format @var{bfdname} for
-@var{objfiles}.  This may not be necessary; @var{strip} can automatically
-recognize many formats.  @xref{objdump}, for information on listing
-available formats.
+@item -v
+Verbose operation: list all object files modified.  In the case of
+archives, @samp{strip -v} will list all members of the archive.
 @end table
 
 @node Index,  , strip, Top
diff --git a/binutils/strip.1 b/binutils/strip.1
index 01e6674eb03..26f4a3cd914 100644
--- a/binutils/strip.1
+++ b/binutils/strip.1
@@ -11,30 +11,18 @@
 strip\(em\&Discard symbols from object files.
 
 .SH SYNOPSIS
-.hy 0
-.na
-.TP
-.B strip
-.RB "[\|" \-s | +strip-all "\|]" 
-.RB "[\|" \-g | \-S | +strip-debug\c
-\|]
-.RB "[\|" \-x | +discard-all "\|]" 
-.RB "[\|" \-X | +discard-locals "\|]"
-.RB "[\|" "\-T\ "\c
-.I bfdname\c
-\&\|]
+.B strip\c
+.RB " [\|" \-v "\|] "\c
 .I objfiles\c
 \&.\|.\|.
-.ad b
-.hy 1
+
 .SH DESCRIPTION
 GNU \c
 .B strip\c
 \& will discard all symbols from object files
 \c
 .I objfiles\c
-\&, if no options are specified; or only certain symbols,
-depending on its command-line options.
+\&.  The list of object files may include archives.
 
 \c
 .B strip\c
@@ -47,70 +35,12 @@ depending on its command-line options.
 rather than writing modified copies under different names.
 
 .SH OPTIONS
-The long and short forms of options, shown here as alternatives, are
-equivalent.
-
-.TP
-.B \-s
-.TP
-.B +strip-all 
-This is the default case: strip all symbol entries from \c
-.I objfiles\c
-\&.
-
-.TP
-.B \-g
-.TP
-.B \-S
-.TP
-.B +strip-debug 
-Discard only debugging symbol information from \c
-.I objfiles\c
-\&.
-
 .TP
-.B \-x
-.TP
-.B +discard-all 
-Discard all symbols local to each file in \c
-.I objfiles\c
-\&.
-\c
-.I WARNING:\c
-\& Note that \c
-.B +discard-all\c
-\& discards only \c
-.I local\c
-\&
-symbols, in spite of its name.
-
-.TP
-.B \-X
-.TP
-.B +discard-locals 
-Discard local symbols starting with `\|\c
-.B L\c
-\|' from each file in
-\c
-.I objfiles\c
-\&.  (Some compilers produce internally-used symbols that
-begin with `\|\c
-.B L\c
-\|'.)
-
-.TP
-.BI "-T " "bfdname"\c
-\&
-You can specify a particular object-code format \c
-.I bfdname\c
-\& for
-\c
-.I objfiles\c
-\&.  This may not be necessary; \c
-.I strip\c
-\& can automatically
-recognize many formats.   for information on listing
-available formats.
+.B \-v
+Verbose operation: list all object files modified.  In the case of
+archives, `\|\c
+.B strip \-v\c
+\&\|' will list all members of the archive.
 .PP
 
 .SH "SEE ALSO"