X-Git-Url: http://git.vpit.fr/?p=perl%2Fmodules%2FTest-Valgrind.git;a=blobdiff_plain;f=README;h=ad23d16b1bcc524889188bd3c9da617cf11b1bc5;hp=ab84bdbe24936d151c9716eb220ec2c7b4068dd1;hb=1b06adb9788085e8aad3af42ea384153cd0a4fe6;hpb=cbc78ed3600426ed4bd21f069a0afb334a94a4b1 diff --git a/README b/README index ab84bdb..ad23d16 100644 --- a/README +++ b/README @@ -1,8 +1,9 @@ NAME - Test::Valgrind - Test Perl code through valgrind. + Test::Valgrind - Generate suppressions, analyse and test any command + with valgrind. VERSION - Version 1.01 + Version 1.02 SYNOPSIS # From the command-line @@ -30,6 +31,11 @@ DESCRIPTION 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 + *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 @@ -96,8 +102,8 @@ METHODS "import [ %options ]" In the parent process, "import" calls "analyse" with the arguments it received itself - except that if no "file" option was supplied, it tries - to pick the highest caller context that looks like a script. When the - analyse finishes, it exists with the status that was returned. + to pick the first caller context that looks like a script. When the + analyse ends, it exits with the status that was returned. In the child process, it just "return"s so that the calling code is actually run under "valgrind". @@ -105,7 +111,8 @@ METHODS VARIABLES $dl_unload When set to true, all dynamic extensions that were loaded during the - analysis will be unloaded at "END" time by DynaLoader::dl_unload_file. + analysis will be unloaded at "END" time by "dl_unload_file" in + DynaLoader. Since this obfuscates error stack traces, it's disabled by default.