Author: gisle.aas
Date: Mon Oct 27 01:16:43 2008
New Revision: 556
Modified:
trunk/lib/Devel/NYTProf.pm
trunk/lib/Devel/NYTProf/Data.pm
trunk/lib/Devel/NYTProf/Reader.pm
Log:
Use consistent POD item lists
Modified: trunk/lib/Devel/NYTProf.pm
==============================================================================
--- trunk/lib/Devel/NYTProf.pm (original)
+++ trunk/lib/Devel/NYTProf.pm Mon Oct 27 01:16:43 2008
@@ -65,23 +65,77 @@
Devel::NYTProf is a powerful feature-rich perl source code profiler.
- * Performs per-line statement profiling for fine detail
- * Performs per-subroutine statement profiling for overview
- * Performs per-block statement profiling (the first profiler to do so)
- * Accounts correctly for time spent after calls return
- * Performs inclusive and exclusive timing of subroutines
- * Subroutine times are per calling location (a powerful feature)
- * Can profile compile-time activity, just run-time, or just END time
- * Uses novel techniques for efficient profiling
- * Sub-microsecond (100ns) resolution on systems with clock_gettime()
- * Very fast - the fastest statement and subroutine profilers for perl
- * Handles applications that fork, with no performance cost
- * Immune from noise caused by profiling overheads and I/O
- * Program being profiled can stop/start the profiler
- * Generates richly annotated and cross-linked html reports
- * Trivial to use with mod_perl - add one line to httpd.conf
- * Includes an extensive test suite
- * Tested on very large codebases
+=over
+
+=item *
+
+Performs per-line statement profiling for fine detail
+
+=item *
+
+Performs per-subroutine statement profiling for overview
+
+=item *
+
+Performs per-block statement profiling (the first profiler to do so)
+
+=item *
+
+Accounts correctly for time spent after calls return
+
+=item *
+
+Performs inclusive and exclusive timing of subroutines
+
+=item *
+
+Subroutine times are per calling location (a powerful feature)
+
+=item *
+
+Can profile compile-time activity, just run-time, or just END time
+
+=item *
+
+Uses novel techniques for efficient profiling
+
+=item *
+
+Sub-microsecond (100ns) resolution on systems with clock_gettime()
+
+=item *
+
+Very fast - the fastest statement and subroutine profilers for perl
+
+=item *
+
+Handles applications that fork, with no performance cost
+
+=item *
+
+Immune from noise caused by profiling overheads and I/O
+
+=item *
+
+Program being profiled can stop/start the profiler
+
+=item *
+
+Generates richly annotated and cross-linked html reports
+
+=item *
+
+Trivial to use with mod_perl - add one line to httpd.conf
+
+=item *
+
+Includes an extensive test suite
+
+=item *
+
+Tested on very large codebases
+
+=back
NYTProf is effectively two profilers in one: a statement profiler, and a
subroutine profiler.
@@ -325,13 +379,15 @@
Included in the bin directory of this distribution are two scripts
which implement the L<Devel::NYTProf::Reader> interface:
-=over 4
+=over 12
-=item *
-nytprofcsv - creates comma delimited profile reports
+=item nytprofcsv
-=item *
-nytprofhtml - creates attractive, richly annotated, and fully cross-linked
html
+creates comma delimited profile reports
+
+=item nytprofhtml
+
+creates attractive, richly annotated, and fully cross-linked html
reports (including statistics, source code and color highlighting)
=back
Modified: trunk/lib/Devel/NYTProf/Data.pm
==============================================================================
--- trunk/lib/Devel/NYTProf/Data.pm (original)
+++ trunk/lib/Devel/NYTProf/Data.pm Mon Oct 27 01:16:43 2008
@@ -446,12 +446,33 @@
The data normalized is:
- - profile timing data: set to 0
- - subroutines: timings are set to 0
- - attributes, like basetime, xs_version, etc., are set to 0
- - filenames: path prefixes matching absolute paths in @INC are changed
to "/.../"
- - filenames: eval sequence numbers, like "(re_eval 2)" are changed to 0
- - calls remove_internal_data_of() for files loaded from absolute paths in
@INC
+=over
+
+=item *
+
+profile timing data: set to 0
+
+=item *
+
+subroutines: timings are set to 0
+
+=item *
+
+attributes, like basetime, xs_version, etc., are set to 0
+
+=item *
+
+filenames: path prefixes matching absolute paths in @INC are changed
to "/.../"
+
+=item *
+
+filenames: eval sequence numbers, like "(re_eval 2)" are changed to 0
+
+=item *
+
+calls remove_internal_data_of() for files loaded from absolute paths in
@INC
+
+=back
=cut
Modified: trunk/lib/Devel/NYTProf/Reader.pm
==============================================================================
--- trunk/lib/Devel/NYTProf/Reader.pm (original)
+++ trunk/lib/Devel/NYTProf/Reader.pm Mon Oct 27 01:16:43 2008
@@ -619,22 +619,28 @@
=over
=item *
- Total calls
+
+Total calls
=item *
- Total time
+
+Total time
=item *
- Average time per call
+
+Average time per call
=item *
- Deviation of all of the above
+
+Deviation of all of the above
=item *
- Line number
+
+Line number
=item *
- Source code
+
+Source code
=back
--~--~---------~--~----~------------~-------~--~----~
You've received this message because you are subscribed to
the Devel::NYTProf Development User group.
Group hosted at: http://groups.google.com/group/develnytprof-dev
Project hosted at: http://perl-devel-nytprof.googlecode.com
CPAN distribution: http://search.cpan.org/dist/Devel-NYTProf
To post, email: [email protected]
To unsubscribe, email: [EMAIL PROTECTED]
-~----------~----~----~----~------~----~------~--~---