NAME
    App::whichpm - locate a Perl module and it's version

SYNOPSIS
            use App::whichpm 'which_pm';
            my ($filename, $version) = which_pm('App::whichpm');
            my $filename = App::whichpm::find('App::whichpm');

    from shell:

            whichpm App::whichpm
            whichpm Universe::ObservableUniverse::Filament::SuperCluster::Cluster::Group::Galaxy::Arm::Bubble::InterstellarCloud::SolarSystem::Earth

DESCRIPTION
    Loads a given module and reports it's location and version.

    The similar function can be achieved via:

            perldoc -l Some::Module
            perl -MSome::Module -le 'print $INC{"Some/Module.pm"}'
            perl -MSome::Module -le 'print Some::Module->VERSION'
            pmpath Some::Module
            pmvers Some::Module

EXPORTS
  which_pm
    same as find only exported under `which_pm' name.

FUNCTIONS
  find($module_name)
    Loads the `$module_name'.

    In scalar context returns filename corresponding to `$module_name'. In
    array context returns filename and version.

    `$module_name' can be either `Some::Module::Name' or
    `Some/Module/Name.pm'

SEE ALSO
    http://perlmonks.org/?node=whichpm, pmpath, Module::InstalledVersion,
    Module::Info

AUTHOR
    Jozef Kutej

CONTRIBUTORS
    The following people have contributed to the File::is by committing
    their code, sending patches, reporting bugs, asking questions,
    suggesting useful advises, nitpicking, chatting on IRC or commenting on
    my blog (in no particular order):

            Jerrad Pierce
            Skye Shaw

LICENSE AND COPYRIGHT
    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.

    See http://dev.perl.org/licenses/ for more information.