From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Tue, 27 Mar 2001 05:43:51 +0000 (+0000)
Subject: Pixie documenting.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=6e36760b26269f003d86cd387e73137c4c53b491;p=p5sagit%2Fp5-mst-13.2.git

Pixie documenting.

p4raw-id: //depot/perl@9373
---

diff --git a/Makefile.SH b/Makefile.SH
index fbfd531..5b4d46f 100644
--- a/Makefile.SH
+++ b/Makefile.SH
@@ -513,7 +513,7 @@ perl.config.dashg:
 
 perl.third.config: config.sh
 	@echo "To build perl.third you must Configure -Doptimize=-g -Uusemymalloc, checking..."
-	$(MAKE) perl.config.dashg
+	@$(MAKE) perl.config.dashg
 	@echo "Checking usemymalloc='n'..."
 	@grep "^usemymalloc=" config.sh
 	@grep -q "^usemymalloc='n'" config.sh || exit 1
@@ -525,7 +525,7 @@ perl.third: /usr/bin/atom perl.third.config perl
 
 perl.pixie.config: config.sh
 	@echo "To build perl.pixie you must Configure -Doptimize=-g, checking..."
-	$(MAKE) perl.config.dashg
+	@$(MAKE) perl.config.dashg
 
 perl.pixie.atom: /usr/bin/atom perl
 	atom -tool pixie -L. -all -toolargs="-quiet" perl
diff --git a/pod/perlhack.pod b/pod/perlhack.pod
index c557c80..33a15e3 100644
--- a/pod/perlhack.pod
+++ b/pod/perlhack.pod
@@ -1739,8 +1739,8 @@ You can build a profiled version of perl called "perl.pixie" by
 invoking the make target "perl.pixie" (in Tru64 a file called
 "perl.Addrs" will also be silently created, this file contains the
 addresses of the basic blocks).  Running the profiled version of Perl
-will create a new file called "Perl.Counts" which contains the basic
-block counts for that particular program execution.
+will create a new file called "perl.Counts" which contains the counts
+for the basic block for that particular program execution.
 
 To display the results you must use the "prof" utility.  The exact
 incantation depends on your operating system, "prof perl.Counts" in
@@ -1753,11 +1753,13 @@ In IRIX the following prof options are available:
 =item -h
 
 Reports the most heavily used lines in descending order of use.
+Useful for finding the hotspot lines.
 
 =item -l
 
 Groups lines by procedure, with procedures sorted in descending order of use.
 Within a procedure, lines are listed in source order.
+Useful for finding the hotspots of procedures.
 
 =back
 
@@ -1767,20 +1769,24 @@ In Tru64 the following options are available:
 
 =item -p
 
-Sorted in descending order by the number of cycles executed in each procedure.
+Procecures sorted in descending order by the number of cycles executed
+in each procedure.  Useful for finding the hotspot procedures.
 (This is the default option.)
 
 =item -h
 
-Sorted in descending order by the number of cycles executed in each line.
+Lines sorted in descending order by the number of cycles executed in
+each line.  Useful for finding the hotspot lines.
 
 =item -i
 
-The called procedures are sorted in descending order by number of calls.
+The called procedures are sorted in descending order by number of calls
+made to the procedures.  Useful for finding the most used procedures.
 
 =item -l
 
 Grouped by procedure, sorted by cycles executed per procedure.
+Useful for finding the hotspots of procedures.
 
 =item -testcoverage