* objdump.1, binutils.texi: Update for --stabs. Also fix

objdump's doc to use -- rather than + for long options.
(FIXME:  Not yet fixed everywhere in binutils.texinfo.)
This commit is contained in:
John Gilmore 1992-06-11 09:18:44 +00:00
parent 1304f099bc
commit c5f0c9388a
3 changed files with 42 additions and 16 deletions

View File

@ -4,6 +4,9 @@ Thu Jun 11 01:19:06 1992 John Gilmore (gnu at cygnus.com)
.stab section from an ELF file. Installed under #ifdef
ELF_STAB_DISPLAY so it can be easily disabled, since it requires
bfd-internals header files and such.
* objdump.1, binutils.texi: Update for --stabs. Also fix
objdump's doc to use -- rather than + for long options.
(FIXME: Not yet fixed everywhere in binutils.texinfo.)
Wed Jun 10 07:53:24 1992 Steve Chamberlain (sac@thepub.cygnus.com)

View File

@ -637,9 +637,9 @@ Display only undefined symbols (those external to each object file).
@smallexample
objdump [ -a ] [ -b @var{bfdname} ] [ -d ] [ -f ]
[ -h | +header ] [ -i ] [ -j @var{section} ] [ -l ]
[ -m @var{machine} ] [ -r | +reloc ] [ -s ]
[ -t | +syms ] [ -x ]
[ -h | --header ] [ -i ] [ -j @var{section} ] [ -l ]
[ -m @var{machine} ] [ -r | --reloc ] [ -s ]
[ --stabs ] [ -t | --syms ] [ -x ]
@var{objfiles}@dots{}
@end smallexample
@ -665,7 +665,7 @@ header information (in a format similar to @samp{ls -l}). Besides the
information you could list with @samp{ar tv}, @samp{objdump -a} shows
the object file format of each archive member.
@c suggest longname +target or +format or +bfd
@c suggest longname --target or --format or --bfd
@item -b @var{bfdname}
@cindex object code format
You can specify a particular object-code format for your object files as
@ -692,7 +692,7 @@ File header. Display summary information from the overall header of
each file in @var{objfiles}.
@item -h
@itemx +header
@itemx --header
@cindex section headers
Header. Display summary information from the section headers of the
object file.
@ -703,18 +703,18 @@ object file.
Display a list showing all architectures and object formats available
for specification with @code{-b} or @code{-m}.
@c suggest longname +section
@c suggest longname --section
@item -j @var{name}
@cindex section information
Display information only for section @var{name}
@c suggest longname +label or +linespec
@c suggest longname --label or --linespec
@item -l
@cindex source filenames for object files
Label the display (using debugging information) with the source filename
and line numbers corresponding to the object code shown.
@c suggest longname +architecture
@c suggest longname --architecture
@item -m @var{machine}
@cindex architecture
Specify the object files @var{objfiles} are for architecture
@ -722,7 +722,7 @@ Specify the object files @var{objfiles} are for architecture
option.
@item -r
@itemx +reloc
@itemx --reloc
@cindex relocation entries, in object file
Relocation. Print the relocation entries of the file.
@ -731,8 +731,21 @@ Relocation. Print the relocation entries of the file.
@cindex object file sections
Display the full contents of any sections requested.
@item --stabs
@cindex stab
@cindex .stab
@cindex debug symbols
@cindex ELF object file format
Display the full contents of any sections requested.
Display the contents of the .stab section from an ELF file.
This is only useful on systems (such as Solaris 2.0) in which
@code{.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 @samp{--syms}
output.
@item -t
@itemx +syms
@itemx --syms
@cindex symbol table entries, printing
Symbol Table. Print the symbol table entries of the file.
This is similar to the information provided by the @samp{nm} program.

View File

@ -22,7 +22,7 @@ objdump\(em\&display information from object files.
\&\|]
.RB "[\|" \-d "\|]"
.RB "[\|" \-f "\|]"
.RB "[\|" \-h | +header "\|]"
.RB "[\|" \-h | --header "\|]"
.RB "[\|" \-i "\|]"
.RB "[\|" "\-j\ "\c
.I section\c
@ -31,9 +31,10 @@ 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
\&.\|.\|.
@ -119,7 +120,7 @@ each file in \c
.TP
.B \-h
.TP
.B +header
.B --header
Header. Display summary information from the section headers of the
object file.
@ -160,17 +161,26 @@ 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 section 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