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

2 files changed, 20 insertions, 1 deletions

diff --git a/gprof/ChangeLog b/gprof/ChangeLog
index 9946afc54c9..4245e66801f 100644
--- 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 a1c6335333f..9789ac7d993 100644
--- 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