* MAINTAINERS: Add myself to 'Write After Approval' list

[deliverable/binutils-gdb.git] / binutils / nm.1

diff --git a/binutils/nm.1 b/binutils/nm.1
index e62586b1291eb68b46ae4aaebea3d00735476abc..c2ad99e559a147e1c28e1743693060bb0a249135 100644 (file)
--- a/binutils/nm.1
+++ b/binutils/nm.1
@@ -8,7 +8,7 @@
 ..
 
 .SH NAME
-nm\(em\&list symbols from object files.
+nm \- list symbols from object files.
 
 .SH SYNOPSIS
 .hy 0
@@ -17,12 +17,17 @@ nm\(em\&list symbols from object files.
 .B nm
 .RB "[\|" \-a | \-\-debug\-syms "\|]" 
 .RB "[\|" \-g | \-\-extern\-only "\|]"
+.RB "[\|" \-B "\|]"  
+.RB "[\|" \-C | \-\-demangle "\|]" 
+.RB "[\|" \-D | \-\-dynamic "\|]" 
 .RB "[\|" \-s | \-\-print\-armap "\|]" 
 .RB "[\|" \-o | \-\-print\-file\-name "\|]"  
 .RB "[\|" \-n | \-\-numeric\-sort "\|]" 
 .RB "[\|" \-p | \-\-no\-sort "\|]"
 .RB "[\|" \-r | \-\-reverse\-sort "\|]" 
+.RB "[\|" \-\-size\-sort "\|]" 
 .RB "[\|" \-u | \-\-undefined\-only "\|]"  
+.RB "[\|" \-l | \-\-line\-numbers "\|]"
 .RB "[\|" \-\-help "\|]"  
 .RB "[\|" \-\-version "\|]"  
 .RB "[\|" "\-t \fIradix" | \-\-radix=\fIradix "\|]"
@@ -71,10 +76,26 @@ The same as
 .B \-\-format=bsd
 (for compatibility with the MIPS \fBnm\fP).
 
+.TP
+.B \-C
+.TP
+.B \-\-demangle
+Decode (\fIdemangle\fP) low-level symbol names into user-level names.
+Besides removing any initial underscore prepended by the system, this
+makes C++ function names readable.
+
+.TP
+.B \-D
+.TP
+.B \-\-dynamic
+Display the dynamic symbols rather than the normal symbols.  This is
+only meaningful for dynamic objects, such as certain types of shared
+libraries.
+
 .TP
 .B "\-f \fIformat"
 Use the output format \fIformat\fP, which can be ``bsd'',
-``sysv'', or ``posix''.  The default is `bsd''.
+``sysv'', or ``posix''.  The default is ``bsd''.
 Only the first character of \fIformat\fP is significant; it can be
 either upper or lower case.
 
@@ -126,6 +147,12 @@ contain definitions for what names.
 Reverse the sense of the sort (whether numeric or alphabetic); let the
 last come first.
 
+.TP
+.B \-\-size\-sort 
+Sort symbols by size.  The size is computed as the difference between
+the value of the symbol and the value of the symbol with the next higher
+value.  The size of the symbol is printed, rather than the value.
+
 .TP
 .B "\-t \fIradix"
 .TP
@@ -134,8 +161,7 @@ Use \fIradix\fP as the radix for printing the symbol values.  It must be
 ``d'' for decimal, ``o'' for octal, or ``x'' for hexadecimal.
 
 .TP
-.BI "\-\-target=" "bfdname"\c
-\&
+.BI "\-\-target=" "bfdname"
 Specify an object code format other than your system's default format.
 See 
 .BR objdump ( 1 ),
@@ -147,6 +173,16 @@ for information on listing available formats.
 .B \-\-undefined\-only 
 Display only undefined symbols (those external to each object file).
 
+.TP
+.B \-l
+.TP
+.B \-\-line\-numbers
+For each symbol, use debugging information to try to find a filename and
+line number.  For a defined symbol, look for the line number of the
+address of the symbol.  For an undefined symbol, look for the line
+number of a relocation entry which refers to the symbol.  If line number
+information can be found, print it after the other symbol information.
+
 .TP
 .B \-V
 .TP