From 393dd300ac655dcc5c0f137e788b4c6a14e9dd17 Mon Sep 17 00:00:00 2001 From: Ian Lance Taylor Date: Mon, 7 Dec 1998 02:58:45 +0000 Subject: [PATCH] * gprof.texi (Symspecs): Mention that you have to add any underscore yourself when naming a symbol. --- gprof/ChangeLog | 5 +++++ gprof/gprof.texi | 39 ++++++++++++++++++++++----------------- 2 files changed, 27 insertions(+), 17 deletions(-) diff --git a/gprof/ChangeLog b/gprof/ChangeLog index 13ac90e6197..6d8a78b8c4a 100644 --- a/gprof/ChangeLog +++ b/gprof/ChangeLog @@ -1,3 +1,8 @@ +Sun Dec 6 21:57:50 1998 Ian Lance Taylor + + * 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 * configure.in: detect cygwin* instead of cygwin32* diff --git a/gprof/gprof.texi b/gprof/gprof.texi index 6a61fc09b49..96bc806a086 100644 --- a/gprof/gprof.texi +++ b/gprof/gprof.texi @@ -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 -- 2.30.2