]> git.vpit.fr Git - perl/modules/Test-Valgrind.git/commitdiff
A short note about the API
authorVincent Pit <vince@profvince.com>
Sat, 2 May 2009 11:49:00 +0000 (13:49 +0200)
committerVincent Pit <vince@profvince.com>
Sat, 2 May 2009 11:49:00 +0000 (13:49 +0200)
lib/Test/Valgrind.pm

index 1b4aa78a287fbdf4ebc3d2252f8967cb6bceb5a5..15dbd214b64efbe155d93633329b4036bf57668d 100644 (file)
@@ -38,6 +38,9 @@ This module is a front-end to the C<Test::Valgrind::*> API that lets you run Per
 If they aren't available yet, it will first generate suppressions for the current C<perl> interpreter and store them in the portable flavour of F<~/.perl/Test-Valgrind/suppressions/$VERSION>.
 The actual run will then take place, and tests will be passed or failed according to the result of the analysis.
 
+The complete API is much more versatile than this.
+It allows you to run I<any> executable under valgrind, generate the corresponding suppressions and convert the analysis output to TAP so that it can be incorporated into your project's testsuite.
+
 Due to the nature of perl's memory allocator, this module can't track leaks of Perl objects.
 This includes non-mortalized scalars and memory cycles. However, it can track leaks of chunks of memory allocated in XS extensions with C<Newx> and friends or C<malloc>.
 As such, it's complementary to the other very good leak detectors listed in the L</SEE ALSO> section.