1Padre::Perl(3)        User Contributed Perl Documentation       Padre::Perl(3)
2
3
4

NAME

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

DESCRIPTION

9       Even though it has only had a single release, Probe::Perl is the "best
10       practice" method for finding the current Perl interpreter, so that we
11       can make a system call to a new instance of the same Perl environment.
12
13       However, during the development of Padre we have found the feature set
14       of Probe::Perl to be insufficient.
15
16       "Padre::Perl" is an experimental attempt to improve on Probe::Perl and
17       support a wider range of situations. The implementation is being
18       contained to the Padre project until we have competently "solved" all
19       of the problems that we care about.
20
21   GUI vs Command Line
22       On some operating systems, different Perl binaries need to be called
23       based on whether the process will be executing in a graphical
24       environment versus a command line environment.
25
26       On Microsoft Windows perl.exe is the command line Perl binary and
27       wperl.exe is the windowing Perl binary.
28
29       On Mac OS X (Darwin) perl.exe is the command line Perl binary and
30       wxPerl.exe is a wxWidgets-specific Perl binary.
31
32   PAR Support
33       PAR executables do not typically support re-invocation, and
34       implementations that do are only a recent invention, and do not support
35       the normal Perl flags.
36
37       Once implemented, we may try to implement support for them here as
38       well.
39

FUNCTIONS

41   "perl"
42       The "perl" function is equivalent to (and passes through to) the
43       "find_perl_interpreter" method of Probe::Perl.
44
45       It should be used when you simply need the "current" Perl executable
46       and don't have any special needs. The other functions should only be
47       used once you understand your needs in more detail.
48
49       Returns the location of current perl executable, or "undef" if it
50       cannot be found.
51
52   "cperl"
53       The "cperl" function is a Perl executable location function that
54       specifically tries to find a command line Perl. In some situations you
55       may critically need a command line Perl so that proper "STDIN",
56       "STDOUT" and "STDERR" handles are available.
57
58       Returns a path to a command line Perl, or "undef" if one cannot be
59       found.
60
61   "wxperl"
62       The "wxperl" function is a Perl executable location function that
63       specifically tries to find a windowing Perl for running wxWidgets
64       applications. In some situations you may critically need a wxWidgets
65       Perl so that a command line box is not show (Windows) or so that Wx
66       starts up properly at all (Mac OS X).
67
68       Returns a path to a Perl suitable for the execution of Wx-based
69       applications, or "undef" if one cannot be found.
70

72       Copyright 2008-2011 The Padre development team as listed in Padre.pm.
73
74       This program is free software; you can redistribute it and/or modify it
75       under the same terms as Perl itself.
76
77       The full text of the license can be found in the LICENSE file included
78       with this module.
79
80
81
82perl v5.28.1                      2011-08-16                    Padre::Perl(3)
Impressum