break dcache out of remote-nindy.c

[binutils.git] / binutils / objdump.1

diff --git a/binutils/objdump.1 b/binutils/objdump.1
index 63d167881c3df7cc25cd90bb73e8438f600d7cfe..f935e11490ac0ab0a6f2836f3429e04f67ed0326 100644 (file)
--- a/binutils/objdump.1
+++ b/binutils/objdump.1
@@ -1,6 +1,5 @@
 .\" Copyright (c) 1991 Free Software Foundation
 .\" See section COPYING for conditions for redistribution
-.\" $Id$
 .TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools"
 .de BP
 .sp
@@ -15,14 +14,14 @@ objdump\(em\&display information from object files.
 .hy 0
 .na
 .TP
-.B   objdump
+.B objdump
 .RB "[\|" \-a "\|]" 
 .RB "[\|" "\-b\ "\c
 .I bfdname\c
 \&\|] 
 .RB "[\|" \-d "\|]" 
 .RB "[\|" \-f "\|]"
-.RB "[\|" \-h | +header "\|]" 
+.RB "[\|" \-h | \-\-header "\|]" 
 .RB "[\|" \-i "\|]" 
 .RB "[\|" "\-j\ "\c
 .I section\c
@@ -31,11 +30,14 @@ objdump\(em\&display information from object files.
 .RB "[\|" "\-m\ "\c
 .I machine\c
 \&\|] 
-.RB "[\|" \-r | +reloc "\|]" 
+.RB "[\|" \-r | \-\-reloc "\|]" 
 .RB "[\|" \-s "\|]"
-.RB "[\|" \-t | +syms "\|]" 
+.RB "[\|" \-\-stabs "\|]"
+.RB "[\|" \-t | \-\-syms "\|]" 
 .RB "[\|" \-x "\|]"
-.I objfiles\c
+.RB "[\|" \-\-version "\|]"
+.RB "[\|" \-\-help "\|]"
+.I objfile\c
 \&.\|.\|.
 .ad b
 .hy 1
@@ -47,21 +49,23 @@ The options control what particular information to display.  This
 information is mostly useful to programmers who are working on the
 compilation tools, as opposed to programmers who just want their
 program to compile and work.
-.SH OPTIONS
-Where long and short forms of an option are shown together, they are
-equivalent.
-
-.TP
-.IR  "objfiles" .\|.\|.
-The object files to be examined.  When you specify archives,
+.PP
+.IR  "objfile" .\|.\|.
+are the object files to be examined.  When you specify archives,
 \c
 .B objdump\c
 \& shows information on each of the member object files.
 
+.SH OPTIONS
+Where long and short forms of an option are shown together, they are
+equivalent.  At least one option besides
+.B \-l
+must be given.
+
 .TP
 .B \-a
 If any files from \c
-.I objfiles\c
+.I objfile\c
 \& are archives, display the archive
 header information (in a format similar to `\|\c
 .B ls \-l\c
@@ -76,7 +80,7 @@ the object file format of each archive member.
 .TP
 .BI "-b " "bfdname"\c
 \&
-You can specify a particular object-code format for your object files as
+Specify the object-code format for the object files to be
 \c
 .I bfdname\c
 \&.  This may not be necessary; \c
@@ -89,7 +93,7 @@ objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o
 .br
 .sp
 
-Displays summary information from the section headers (`\|\c
+display summary information from the section headers (`\|\c
 .B \-h\c
 \|') of
 `\|\c
@@ -106,23 +110,29 @@ formats available with the `\|\c
 .B \-d
 Disassemble.  Display the assembler mnemonics for the machine
 instructions from \c
-.I objfiles\c
+.I objfile\c
 \&.
 
 .TP
 .B \-f
 File header.  Display summary information from the overall header of
 each file in \c
-.I objfiles\c
+.I objfile\c
 \&.
 
 .TP
 .B \-h
 .TP
-.B +header
+.B \-\-header
 Header.  Display summary information from the section headers of the
 object file.
 
+.TP
+.B \-\-help
+Print a summary of the options to
+.B objdump
+and exit.
+
 .TP
 .B \-i
 Display a list showing all architectures and object formats available
@@ -148,7 +158,7 @@ and line numbers corresponding to the object code shown.
 .BI "-m " "machine"\c
 \&
 Specify the object files \c
-.I objfiles\c
+.I objfile\c
 \& are for architecture
 \c
 .I machine\c
@@ -160,22 +170,37 @@ option.
 .TP
 .B \-r
 .TP
-.B +reloc
+.B \-\-reloc
 Relocation.  Print the relocation entries of the file.
 
 .TP
 .B \-s
 Display the full contents of any sections requested.
 
+.TP
+.B \-\-stabs
+Display the contents of the .stab, .stab.index, and .stab.excl
+sections from an ELF file.  This is only useful on systems (such as
+Solaris 2.0) in which .stab debugging symbol-table entries are carried
+in an ELF section.  In most other file formats, debugging symbol-table
+entries are interleaved with linkage symbols, and are visible in the
+\-\-syms output.
+
 .TP
 .B \-t
 .TP
-.B +syms
+.B \-\-syms
 Symbol Table.  Print the symbol table entries of the file.
 This is similar to the information provided by the `\|\c
 .B nm\c
 \|' program.
 
+.TP
+.B \-\-version
+Print the version number of
+.B objdump
+and exit.
+
 .TP
 .B \-x
 Display all available header information, including the symbol table and
@@ -186,8 +211,6 @@ relocation entries.  Using `\|\c
 .B \-a \-f \-h \-r \-t\c
 \|'.
 
-.PP
-
 .SH "SEE ALSO"
 .RB "`\|" binutils "\|'"
 entry in