2002-06-15 H.J. Lu (hjl@gnu.org)

[deliverable/binutils-gdb.git] / binutils / doc / binutils.texi

diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index 22c903c66f60815694226790bef929885d500234..2b91f8ee3abdcae6c8a42faf5420e99a4031385a 100644 (file)
--- a/binutils/doc/binutils.texi
+++ b/binutils/doc/binutils.texi
@@ -1,6 +1,6 @@
 \input texinfo       @c                    -*- Texinfo -*-
 @setfilename binutils.info
-@c Copyright 2001 Free Software Foundation, Inc.
+@c Copyright 2001, 2002 Free Software Foundation, Inc.
 
 @include config.texi
 
@@ -29,7 +29,7 @@ END-INFO-DIR-ENTRY
 
 @ifinfo
 @c man begin COPYRIGHT
-Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
+Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001, 2002 Free Software Foundation, Inc.
 
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.1
@@ -53,7 +53,7 @@ notice identical to this one except for the removal of this paragraph
 @c This file documents the GNU binary utilities "ar", "ld", "objcopy",
 @c  "objdump", "nm", "size", "strings", "strip", "readelf" and "ranlib".
 @c
-@c Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
+@c Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001, 2002 Free Software Foundation, Inc.
 @c 
 @c This text may be freely distributed under the terms of the GNU
 @c Free Documentation License.
@@ -78,7 +78,7 @@ notice identical to this one except for the removal of this paragraph
 @end tex
 
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 1998, 2000, 2001 Free Software Foundation, Inc.
+Copyright @copyright{} 1991, 92, 93, 94, 95, 96, 97, 1998, 2000, 2001, 2002 Free Software Foundation, Inc.
 
       Permission is granted to copy, distribute and/or modify this document
       under the terms of the GNU Free Documentation License, Version 1.1
@@ -659,7 +659,8 @@ The @sc{gnu} linker @command{ld} is now described in a separate manual.
 @c man begin SYNOPSIS nm
 nm [@option{-a}|@option{--debug-syms}] [@option{-g}|@option{--extern-only}]
    [@option{-B}] [@option{-C}|@option{--demangle}[=@var{style}]] [@option{-D}|@option{--dynamic}]
-   [@option{-s}|@option{--print-armap}] [@option{-A}|@option{-o}|@option{--print-file-name}]
+   [@option{-S}|@option{--print-size}] [@option{-s}|@option{--print-armap}]
+   [@option{-A}|@option{-o}|@option{--print-file-name}]
    [@option{-n}|@option{-v}|@option{--numeric-sort}] [@option{-p}|@option{--no-sort}]
    [@option{-r}|@option{--reverse-sort}] [@option{--size-sort}] [@option{-u}|@option{--undefined-only}]
    [@option{-t} @var{radix}|@option{--radix=}@var{radix}] [@option{-P}|@option{--portability}]
@@ -851,6 +852,10 @@ encountered.
 Use the POSIX.2 standard output format instead of the default format.
 Equivalent to @samp{-f posix}.
 
+@item -S
+@itemx --print-size
+Print size of defined symbols for the @code{bsd} output format.
+
 @item -s
 @itemx --print-armap
 @cindex symbol index, listing
@@ -1685,6 +1690,7 @@ relocation entries.  Using @option{-x} is equivalent to specifying all of
 @itemx --wide
 @cindex wide output, printing
 Format some lines for output devices that have more than 80 columns.
+Also do not truncate symbol names when they are displayed.
 @end table
 
 @c man end
@@ -1756,7 +1762,9 @@ ar(1), nm(1), and the Info entries for @file{binutils}.
 @smallexample
 @c man begin SYNOPSIS size
 size [@option{-A}|@option{-B}|@option{--format=}@var{compatibility}]
-     [@option{--help}] [@option{-d}|@option{-o}|@option{-x}|@option{--radix=}@var{number}]
+     [@option{--help}]
+     [@option{-d}|@option{-o}|@option{-x}|@option{--radix=}@var{number}]
+     [@option{-t}|@option{--totals}]
      [@option{--target=}@var{bfdname}] [@option{-V}|@option{--version}]  
      [@var{objfile}@dots{}]
 @c man end
@@ -1839,6 +1847,10 @@ values (8, 10, 16) are supported.  The total size is always given in two
 radices; decimal and hexadecimal for @option{-d} or @option{-x} output, or
 octal and hexadecimal if you're using @option{-o}.
 
+@item -t
+@itemx --totals
+Show totals of all objects listed (Berkeley format listing mode only).
+
 @item --target=@var{bfdname}
 @cindex object code format
 Specify that the object-code format for @var{objfile} is
@@ -1970,7 +1982,7 @@ and the Info entries for @file{binutils}.
 strip [@option{-F} @var{bfdname} |@option{--target=}@var{bfdname} ]
       [@option{-I} @var{bfdname} |@option{--input-target=}@var{bfdname} ]
       [@option{-O} @var{bfdname} |@option{--output-target=}@var{bfdname} ]
-      [@option{-s}|@option{--strip-all}] [@option{-S}|@option{-g}|@option{--strip-debug}]
+      [@option{-s}|@option{--strip-all}] [@option{-S}|@option{-g}|@option{-d}|@option{--strip-debug}]
       [@option{-K} @var{symbolname} |@option{--keep-symbol=}@var{symbolname} ]
       [@option{-N} @var{symbolname} |@option{--strip-symbol=}@var{symbolname} ]
       [@option{-x}|@option{--discard-all} ] [@option{-X} |@option{--discard-locals}]
@@ -2027,6 +2039,7 @@ Remove all symbols.
 
 @item -g
 @itemx -S
+@itemx -d
 @itemx --strip-debug
 Remove debugging symbols only.
 
@@ -2731,14 +2744,14 @@ when @option{--export-all-symbols} is used.
 Specifies the path, including the filename, of the assembler to be used
 to create the exports file.
 
-@item -f @var{switches}
-@itemx --as-flags @var{switches}
-Specifies any specific command line switches to be passed to the
+@item -f @var{options}
+@itemx --as-flags @var{options}
+Specifies any specific command line options to be passed to the
 assembler when building the exports file.  This option will work even if
 the @option{-S} option is not used.  This option only takes one argument,
 and if it occurs more than once on the command line, then later
 occurrences will override earlier occurrences.  So if it is necessary to
-pass multiple switches to the assembler they should be enclosed in
+pass multiple options to the assembler they should be enclosed in
 double quotes.
 
 @item -D @var{name}
@@ -3121,7 +3134,7 @@ command line option: @option{-b} or @option{--format}
 
 @item
 script command @code{TARGET}
-(@pxref{Option Commands,,Option Commands,ld.info,Using LD})
+(@pxref{Format Commands,,Format Commands,ld.info,Using LD})
 
 @item
 environment variable @code{GNUTARGET}
@@ -3143,7 +3156,7 @@ command line option: @option{-oformat}
 
 @item
 script command @code{OUTPUT_FORMAT}
-(@pxref{Option Commands,,Option Commands,ld.info,Using LD})
+(@pxref{Format Commands,,Format Commands,ld.info,Using LD})
 
 @item
 the linker input target (see ``Linker Input Target'' above)
@@ -3198,7 +3211,7 @@ Ways to specify:
 @enumerate
 @item
 script command @code{OUTPUT_ARCH}
-(@pxref{Option Commands,,Option Commands,ld.info,Using LD})
+(@pxref{Miscellaneous Commands,,Miscellaneous Commands,ld.info,Using LD})
 
 @item
 the default architecture from the linker output target