README for Module::Report::Versions Time-stamp: "2003-06-21 23:18:00 AHDT" NAME Module::Versions::Report -- report versions of all modules in memory SYNOPSIS use Module::Versions::Report; ...and any code you want... This will run all your code normally, but then as the Perl interpreter is about to exit, it will print something like: Perl v5.6.1 under MSWin32. Modules in memory: attributes; AutoLoader v5.58; Carp; Config; DynaLoader v1.04; Exporter v5.562; Module::Versions::Report v1.01; HTML::Entities v1.22; HTML::HeadParser v2.15; HTML::Parser v3.25; [... and whatever other modules were loaded that session...] Consider its use from the command line: % perl -MModule::Versions::Report -MLWP -e 1 Perl v5.6.1 under MSWin32. Modules in memory: attributes; AutoLoader v5.58; [...] DESCRIPTION I often get email from someone reporting a bug in a module I've written. I email back, asking what version of the module it is, what version of Perl on what OS, and sometimes what version of some relevent third library (like XML::Parser). They reply, saying "Perl 5". I say "I need the exact version, as reported by "perl -v"". They tell me. And I say "I, uh, also asked about the version of my module and XML::Parser [or whatever]". They say "Oh yeah. It's 2.27". "Is that my module or XML::Parser?" "XML::Parser." "OK, and what about my module's version?" "Ohyeah. That's 3.11." By this time, days have passed, and what should have been a simple operation -- reporting the version of Perl and relevent modules, has been needlessly complicated. This module is for simplifying that task. If you add "use Module::Versions::Report;" to a program (especially handy if your program is one that demonstrates a bug in some module), then when the program has finished running, you well get a report detailing the all modules in memory, and noting the version of each (for modules that defined a $VERSION, at least). COPYRIGHT AND DISCLAIMER Copyright 2001-2003 Sean M. Burke. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. AUTHOR Sean M. Burke, PREREQUISITES This suite requires Perl 5. INSTALLATION You install Module::Versions::Report, as you would install any Perl module distribution, by running these commands: perl Makefile.PL make make test make install If you want to install a private copy of Module::Versions::Report in your home directory, then you should try to produce the initial Makefile with something like this command: perl Makefile.PL LIB=~/perl See perldoc perlmodinstall for more information. DOCUMENTATION See the pod in Module::Versions::Report. SUPPORT Questions, bug reports, useful code bits, and suggestions for Worms should be sent to me at sburke@cpan.org AVAILABILITY The latest version of Module::Versions::Report is available from the Comprehensive Perl Archive Network (CPAN). Visit to find a CPAN site near you. COPYRIGHT Copyright 2001-2003, Sean M. Burke , all rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. AUTHOR Sean M. Burke