Update comments. It doesn't do MiniMON, it does UDI!

[binutils.git] / binutils / binutils.texi

diff --git a/binutils/binutils.texi b/binutils/binutils.texi
index d3bf221dcc054a315514c360ec3074c357bd81c0..d53cbc1228ac7e7680a01fd5ee6d7418a1a48cf5 100644 (file)
--- a/binutils/binutils.texi
+++ b/binutils/binutils.texi
@@ -4,15 +4,36 @@
 @ifinfo
 @format
 START-INFO-DIR-ENTRY
 @ifinfo
 @format
 START-INFO-DIR-ENTRY

-
-* Binutils: (binutils).        
-               The GNU binary utilities "ar", "ld", "objdump", "nm",
-               "size", "strip", and "ranlib".
-
+* Binutils: (binutils).                The GNU binary utilities "ar", "ld", "objdump",
+                               "nm", "size", "strip", and "ranlib".

 END-INFO-DIR-ENTRY
 @end format
 @end ifinfo
 
 END-INFO-DIR-ENTRY
 @end format
 @end ifinfo
 

+@ifinfo
+Copyright @copyright{} 1991 Free Software Foundation, Inc.
+
+Permission is granted to make and distribute verbatim copies of
+this manual provided the copyright notice and this permission notice
+are preserved on all copies.
+
+@ignore
+Permission is granted to process this file through TeX and print the
+results, provided the printed document carries a copying permission
+notice identical to this one except for the removal of this paragraph
+(this paragraph not being relevant to the printed manual).
+
+@end ignore
+
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided also that
+the entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+
+Permission is granted to copy and distribute translations of this manual
+into another language, under the above conditions for modified versions.
+@end ifinfo
+

 @synindex ky cp
 @c
 @c This file documents the GNU binary utilities "ar", "ld", "objdump", "nm", 
 @synindex ky cp
 @c
 @c This file documents the GNU binary utilities "ar", "ld", "objdump", "nm", 


@@ -23,17 +44,15 @@ END-INFO-DIR-ENTRY
 @c This text may be freely distributed under the terms of the GNU
 @c General Public License.
 @c
 @c This text may be freely distributed under the terms of the GNU
 @c General Public License.
 @c

-@c $Id$
-@iftex
-@finalout
-@c @smallbook
-@end iftex
-@c @cropmarks
+

 @setchapternewpage odd
 @settitle GNU Binary Utilities
 @titlepage
 @setchapternewpage odd
 @settitle GNU Binary Utilities
 @titlepage

+@finalout
+@c @smallbook
+@c @cropmarks

 @title The GNU Binary Utilities
 @title The GNU Binary Utilities

-@subtitle Version 1.90
+@subtitle Version 1.97

 @sp 1
 @subtitle October 1991
 @author Roland H. Pesch
 @sp 1
 @subtitle October 1991
 @author Roland H. Pesch


@@ -68,7 +87,9 @@ into another language, under the above conditions for modified versions.
 
 @cindex version
 This brief manual contains preliminary documentation for the GNU binary
 
 @cindex version
 This brief manual contains preliminary documentation for the GNU binary

-utilities (collectively version 1.90): 
+utilities (collectively version 1.97): 
+
+@iftex

 @table @code
 @item ar
 Create, modify, and extract from archives
 @table @code
 @item ar
 Create, modify, and extract from archives


@@ -88,50 +109,20 @@ List section sizes and total size
 @item strip
 Discard symbols
 @end table
 @item strip
 Discard symbols
 @end table

-
-@ifinfo
-Copyright @copyright{} 1991 Free Software Foundation, Inc.
-
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-@ignore
-Permission is granted to process this file through TeX and print the
-results, provided the printed document carries a copying permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
-
-@end ignore
-
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided also that
-the entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions.
-@end ifinfo
+@end iftex

 
 @menu
 
 @menu

-* ar::                          ar
-* ld::                          ld
-* nm::                          nm
-* objdump::                     objdump
-* ranlib::                      ranlib
-* size::                        size
-* strip::                       strip
-* Index::                       Index
-
- --- The Detailed Node Listing ---
-
-ar
-
-* ar-cmdline::                  Controlling @code{ar} on the command line
-* ar-scripts::                  Controlling @code{ar} with a script
+* ar::                          Create, modify, and extract from archives
+* ld:(ld)Overview.              Combine object and archive files
+* nm::                          List symbols from object files
+* objdump::                     Display information from object files
+* ranlib::                      Generate index to archive contents
+* size::                        List section sizes and total size
+* strip::                       Discard symbols
+* Index::                       

 @end menu
 
 @end menu
 

-@node ar, ld, Top, Top
+@node ar, nm, Top, Top

 @chapter ar
 
 @kindex ar
 @chapter ar
 
 @kindex ar


@@ -540,15 +531,16 @@ Requires prior use of @code{OPEN} or @code{CREATE}.
 
 @end table
 
 
 @end table
 

-
-@node ld, nm, ar, Top
+@iftex
+@node ld

 @chapter ld
 @cindex linker
 @kindex ld
 The GNU linker @code{ld} is now described in a separate manual.
 @chapter ld
 @cindex linker
 @kindex ld
 The GNU linker @code{ld} is now described in a separate manual.

-@xref{Top,, Overview,, GLD: the GNU linker}.
+@xref{Top,, Overview,, Using LD: the GNU linker}.
+@end iftex

 
 

-@node nm, objdump, ld, Top
+@node nm, objdump, ar, Top

 @chapter nm
 @cindex symbols
 @kindex nm
 @chapter nm
 @cindex symbols
 @kindex nm


@@ -638,9 +630,9 @@ Display only undefined symbols (those external to each object file).
 
 @smallexample
   objdump [ -a ]  [ -b @var{bfdname} ]  [ -d ]  [ -f ]
 
 @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
 
           @var{objfiles}@dots{}
 @end smallexample
 


@@ -666,7 +658,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.
 
 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
 @item -b @var{bfdname}
 @cindex object code format
 You can specify a particular object-code format for your object files as


@@ -693,7 +685,7 @@ File header.  Display summary information from the overall header of
 each file in @var{objfiles}.
 
 @item -h
 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.
 @cindex section headers
 Header.  Display summary information from the section headers of the
 object file.


@@ -704,18 +696,18 @@ object file.
 Display a list showing all architectures and object formats available
 for specification with @code{-b} or @code{-m}.
 
 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}
 
 @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.
 
 @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
 @item -m @var{machine}
 @cindex architecture
 Specify the object files @var{objfiles} are for architecture


@@ -723,7 +715,7 @@ Specify the object files @var{objfiles} are for architecture
 option. 
 
 @item -r
 option. 
 
 @item -r

-@itemx +reloc
+@itemx --reloc

 @cindex relocation entries, in object file
 Relocation.  Print the relocation entries of the file.
 
 @cindex relocation entries, in object file
 Relocation.  Print the relocation entries of the file.
 


@@ -732,8 +724,21 @@ Relocation.  Print the relocation entries of the file.
 @cindex object file sections
 Display the full contents of any sections requested.
 
 @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 and .stab.index and .stab.excl sections 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
 @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.
 @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.