* 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.)

3 files changed, 42 insertions, 16 deletions

diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index f2c7398..8b076b8 100644
--- a/binutils/ChangeLog
+++ b/binutils/ChangeLog
@@ -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)
 
diff --git a/binutils/binutils.texi b/binutils/binutils.texi
index b75fb81..2ae674a 100644
--- a/binutils/binutils.texi
+++ b/binutils/binutils.texi
@@ -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.
diff --git a/binutils/objdump.1 b/binutils/objdump.1
index 63d1678..7344fa2 100644
--- a/binutils/objdump.1
+++ b/binutils/objdump.1
@@ -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,7 +161,7 @@ option.
 .TP
 .B \-r
 .TP
-.B +reloc
+.B --reloc
 Relocation.  Print the relocation entries of the file.
 
 .TP
@@ -168,9 +169,18 @@ Relocation.  Print the relocation entries of the file.
 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