1Module::Install::ExternUasle(r3)Contributed Perl DocumenMtoadtuiloen::Install::External(3)
2
3
4

NAME

6       Module::Install::External - Specify dependencies on external non-Perl
7       things
8

DESCRIPTION

10       "Module::Install::External" provides command that allow you to
11       declaratively specify a dependency on a program or system that is not
12       Perl.
13
14       The commands it provides are similar to those in Module::Install::Can,
15       except that they implement an explicit dependency, in addition to just
16       working out if the particular thing is available.
17

COMMANDS

19   requires_xs
20         requires_xs;
21
22       The "requires_xs" command explicitly specifies that a C compiler and
23       the perl header files are required in order to build (at make-time) the
24       distribution (specifically XS files).
25
26       It does not take any params, and aborts the Makefile.PL execution in a
27       way that an automated installation or testing system will interpret as
28       a "NA" ("not applicable to this platform") result.
29
30       This may be changed to an alternative abort result at a later time.
31
32       Returns true as a convenience.
33
34   requires_external_cc
35         requires_external_cc;
36
37       The "requires_external_cc" command explicitly specifies that a C
38       compiler is required in order to build (at make-time) the distribution.
39
40       It does not take any params, and aborts the Makefile.PL execution in a
41       way that an automated installation or testing system will interpret as
42       a "NA" ("not applicable to this platform") result.
43
44       This may be changed to an alternative abort result at a later time.
45
46       Returns true as a convenience.
47
48   requires_external_bin
49         requires_external_bin 'cvs';
50
51       The "requires_external_bin" command takes the name of a system command
52       or program, similar to the "can_run" command, except that
53       "requires_external_bin" checks in a way that is a declarative explicit
54       dependency.
55
56       The takes a single param of the command/program name, and aborts the
57       "Makefile.PL" execution in a way that an automated installation or
58       testing system will interpret as a "NA" ("not applicable to this
59       platform") result.
60
61       Returns true as a convenience.
62

TO DO

64       Work out how to save the external dependency metadata, in agreement
65       with the larger Perl community.
66
67       Implement the agreed external dependency metadata solution.
68

AUTHORS

70       Adam Kennedy <adamk@cpan.org>
71

SEE ALSO

73       Module::Install
74

76       Copyright 2006 Adam Kennedy.
77
78       This program is free software; you can redistribute it and/or modify it
79       under the same terms as Perl itself.
80
81       See <http://www.perl.com/perl/misc/Artistic.html>
82
83
84
85perl v5.36.0                      2023-01-20      Module::Install::External(3)
Impressum