(Executing the Program): Add documentation on how to use bbconv.pl.

diff --git a/gprof/ChangeLog b/gprof/ChangeLog
index 9946afc54c9d2a076beec5a27d5c50c6b1a326dd..4245e66801f52dda13ce4e8da074a57b63a68dd2 100644 (file)
--- a/gprof/ChangeLog
+++ b/gprof/ChangeLog
@@ -1,3 +1,8 @@
+2002-07-29  Ulrich Drepper  <drepper@redhat.com>
+
+       * gprof.texi (Executing the Program): Add documentation on how to use
+       bbconv.pl.  Patch by Eric Hanchrow.
+
 2002-07-25  Nick Clifton  <nickc@redhat.com>
 
        * po/es.po: Updated Spanish translation.

diff --git a/gprof/gprof.texi b/gprof/gprof.texi
index a1c6335333f5012a4a051d58a678edfcc391d936..9789ac7d9934477f3774d57ed4309bea43f3e47e 100644 (file)
--- a/gprof/gprof.texi
+++ b/gprof/gprof.texi
@@ -357,7 +357,21 @@ appearance of a human-readable @file{bb.out} means the basic-block
 counts didn't get written into @file{gmon.out}.
 The Perl script @code{bbconv.pl}, included with the @code{gprof}
 source distribution, will convert a @file{bb.out} file into
-a format readable by @code{gprof}.
+a format readable by @code{gprof}.  Invoke it like this:
+
+@smallexample
+bbconv.pl < bb.out > @var{bh-data}
+@end smallexample
+
+This translates the information in @file{bb.out} into a form that
+@code{gprof} can understand.  But you still need to tell @code{gprof}
+about the existence of this translated information.  To do that, include
+@var{bb-data} on the @code{gprof} command line, @emph{along with
+@file{gmon.out}}, like this:
+
+@smallexample
+gprof @var{options} @var{executable-file} gmon.out @var{bb-data} [@var{yet-more-profile-data-files}@dots{}] [> @var{outfile}]
+@end smallexample
 
 @node Invoking
 @chapter @code{gprof} Command Summary