* gprof.texi (Symspecs): Mention that you have to add any
authorIan Lance Taylor <ian@airs.com>
Mon, 7 Dec 1998 02:58:45 +0000 (02:58 +0000)
committerIan Lance Taylor <ian@airs.com>
Mon, 7 Dec 1998 02:58:45 +0000 (02:58 +0000)
underscore yourself when naming a symbol.

gprof/ChangeLog
gprof/gprof.texi

index 13ac90e6197f8544934867d18c1588658d39542a..6d8a78b8c4ac55355d91181effb1b1272f5aefc6 100644 (file)
@@ -1,3 +1,8 @@
+Sun Dec  6 21:57:50 1998  Ian Lance Taylor  <ian@cygnus.com>
+
+       * gprof.texi (Symspecs): Mention that you have to add any
+       underscore yourself when naming a symbol.
+
 Mon Nov  2 15:05:33 1998  Geoffrey Noer  <noer@cygnus.com>
 
         * configure.in: detect cygwin* instead of cygwin32*
index 6a61fc09b49965bdc6f5819c3b06ee77f927376e..96bc806a086a0f796f659856e0a9f8998fcc78b2 100644 (file)
@@ -669,34 +669,39 @@ following syntax:
 
 Here are some sample symspecs:
 
-@table @code
+@table @samp
 @item main.c
-Selects everything in file "main.c"---the
+Selects everything in file @file{main.c}---the
 dot in the string tells gprof to interpret
 the string as a filename, rather than as
 a function name.  To select a file whose
 name does not contain a dot, a trailing colon
-should be specified.  For example, "odd:" is
-interpreted as the file named "odd".
+should be specified.  For example, @samp{odd:} is
+interpreted as the file named @file{odd}.
 
 @item main
-Selects all functions named "main".  Notice
-that there may be multiple instances of the
-same function name because some of the
-definitions may be local (i.e., static).
-Unless a function name is unique in a program,
-you must use the colon notation explained
-below to specify a function from a specific
-source file.  Sometimes, function names contain
-dots.  In such cases, it is necessar to
-add a leading colon to the name.  For example,
-":.mul" selects function ".mul".
+Selects all functions named @samp{main}.
+
+Note that there may be multiple instances of the same function name
+because some of the definitions may be local (i.e., static).  Unless a
+function name is unique in a program, you must use the colon notation
+explained below to specify a function from a specific source file.
+
+Sometimes, function names contain dots.  In such cases, it is necessar
+to add a leading colon to the name.  For example, @samp{:.mul} selects
+function @samp{.mul}.
+
+In some object file formats, symbols have a leading underscore.  gprof
+will normally not print these underscores.  However, you must use the
+underscore when you name a symbol in a symspec.  You can use the
+@code{nm} program to see whether symbols have underscores for the object
+file format you are using.
 
 @item main.c:main
-Selects function "main" in file "main.c".
+Selects function @samp{main} in file @file{main.c}.
 
 @item main.c:134
-Selects line 134 in file "main.c".
+Selects line 134 in file @file{main.c}.
 @end table
 
 @node Output