NAME

       Padre::Perl - A more nuanced "Where is Perl" module than Probe::Perl

DESCRIPTION

       Even though it has only had a single release, Probe::Perl is the "best practice" method
       for finding the current Perl interpreter, so that we can make a system call to a new
       instance of the same Perl environment.

       However, during the development of Padre we have found the feature set of Probe::Perl to
       be insufficient.

       "Padre::Perl" is an experimental attempt to improve on Probe::Perl and support a wider
       range of situations. The implementation is being contained to the Padre project until we
       have competently "solved" all of the problems that we care about.

   GUI vs Command Line
       On some operating systems, different Perl binaries need to be called based on whether the
       process will be executing in a graphical environment versus a command line environment.

       On Microsoft Windows perl.exe is the command line Perl binary and wperl.exe is the
       windowing Perl binary.

       On Mac OS X (Darwin) perl.exe is the command line Perl binary and wxPerl.exe is a
       wxWidgets-specific Perl binary.

   PAR Support
       PAR executables do not typically support re-invocation, and implementations that do are
       only a recent invention, and do not support the normal Perl flags.

       Once implemented, we may try to implement support for them here as well.

FUNCTIONS

   "perl"
       The "perl" function is equivalent to (and passes through to) the "find_perl_interpreter"
       method of Probe::Perl.

       It should be used when you simply need the "current" Perl executable and don't have any
       special needs. The other functions should only be used once you understand your needs in
       more detail.

       Returns the location of current perl executable, or "undef" if it cannot be found.

   "cperl"
       The "cperl" function is a Perl executable location function that specifically tries to
       find a command line Perl. In some situations you may critically need a command line Perl
       so that proper "STDIN", "STDOUT" and "STDERR" handles are available.

       Returns a path to a command line Perl, or "undef" if one cannot be found.

   "wxperl"
       The "wxperl" function is a Perl executable location function that specifically tries to
       find a windowing Perl for running wxWidgets applications. In some situations you may
       critically need a wxWidgets Perl so that a command line box is not show (Windows) or so
       that Wx starts up properly at all (Mac OS X).

       Returns a path to a Perl suitable for the execution of Wx-based applications, or "undef"
       if one cannot be found.

COPYRIGHT & LICENSE

       Copyright 2008-2013 The Padre development team as listed in Padre.pm.

       This program is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.

       The full text of the license can be found in the LICENSE file included with this module.