misc fixes

[binutils.git] / binutils / strip.1

diff --git a/binutils/strip.1 b/binutils/strip.1
index 01e6674eb032ef3f73d59eac2e20efcfd7f259f7..1c691623dedf278fe211717eb551ee1ced2def21 100644 (file)
--- a/binutils/strip.1
+++ b/binutils/strip.1
@@ -11,106 +11,77 @@
 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
-\&\|]
-.I objfiles\c
+.RB "[\|" "\-F \fIformat\fP" | \-\-format=\fIformat\fP | \-\-target=\fIformat\fP "\|]"
+.RB "[\|" "\-I \fIformat\fP" | \-\-input\-format=\fIformat\fP "\|]"
+.RB "[\|" "\-O \fIformat\fP" | \-\-output\-format=\fIformat\fP "\|]"
+.RB "[\|" \-s | \-\-strip\-all "\|]"
+.RB "[\|" \-S | -g | \-\-strip\-debug "\|]"
+.RB "[\|" \-x | \-\-discard\-all "\|]"
+.RB "[\|" \-X | \-\-discard\-locals "\|]"
+.RB "[\|" \-v | \-\-verbose "\|]"
+.RB "[\|" \-V | \-\-version "\|]"
+.I objfile\c
 \&.\|.\|.
-.ad b
-.hy 1
+
 .SH DESCRIPTION
 GNU \c
 .B strip\c
-\& will discard all symbols from object files
+\& discards all symbols from the object files
 \c
-.I objfiles\c
-\&, if no options are specified; or only certain symbols,
-depending on its command-line options.
+.I objfile\c
+\&.  The list of object files may include archives.
 
 \c
 .B strip\c
 \& will not execute unless at least one object file is listed.
 
-.I WARNING:\c
 \& \c
 .B strip\c
 \& modifies the files named in its argument,
 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
-\&.
+.B "\-F \fIformat\fP \-\-format=\fIformat\fP \-\-target=\fIformat\fP"
+Treat the original \fIobjfile\fP as a file with the object
+code format \fIformat\fP, and rewrite it in the same format.
 
 .TP
-.B \-g
+.B "\-I \fIformat\fP \-\-input\-format=\fIformat\fP"
+Treat the original \fIobjfile\fP as a file with the object
+code format \fIformat\fP.
+
 .TP
-.B \-S
+.B "\-O \fIformat\fP \-\-output\-format=\fIformat\fP"
+Replace \fIobjfile\fP with a file in the output format \fIformat\fP.
+
 .TP
-.B +strip-debug 
-Discard only debugging symbol information from \c
-.I objfiles\c
-\&.
+.B "\-s \-\-strip\-all"
+Remove all symbols.
 
 .TP
-.B \-x
+.B "\-S -g \-\-strip\-debug"
+Remove debugging symbols only.
+
 .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.
+.B "\-x \-\-discard\-all"
+Remove non-global symbols.
 
 .TP
-.B \-X
+.B "\-X \-\-discard\-locals"
+Remove compiler-generated local symbols.
+(These usually start with ``L'' or ``.''.)
+
 .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
-\|'.)
+.B "\-v \-\-verbose"
+Verbose output: list all object files modified.  In the case of
+archives, ``strip \-V'' lists all members of the archive.
 
 .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 \-\-version
+Show the version number for \fBstrip\fP.
+
 .PP
 
 .SH "SEE ALSO"