Add Stephane Carrez

[binutils.git] / binutils / nm.1

diff --git a/binutils/nm.1 b/binutils/nm.1
index aedabb4e27743a2b6bb60f1357ae9f782cf4234b..c2ad99e559a147e1c28e1743693060bb0a249135 100644 (file)
--- a/binutils/nm.1
+++ b/binutils/nm.1
@@ -25,7 +25,9 @@ nm \- list symbols from object files.
 .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 "\|]"
@@ -93,7 +95,7 @@ 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.
 
@@ -145,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
@@ -153,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 ),
@@ -166,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