forked from Perl-Toolchain-Gang/ExtUtils-MakeMaker
/
NOTES
96 lines (74 loc) · 3.37 KB
/
NOTES
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
The Simplified MakeMaker class hierarchy
****************************************
What most people need to know.
(Subclasses on top.)
MY
|
ExtUtils::MakeMaker
|
ExtUtils::MM_{Current OS}
|
ExtUtils::MM_Unix
|
ExtUtils::MM_Any
The object actually used is of the class MY which allows you to
override bits of MakeMaker inside your Makefile.PL by declaring
MY::foo() methods.
The Real MakeMaker class hierarchy
**********************************
You wish it was that simple.
Here's how it really works.
PACK### (created each call to ExtUtils::MakeMaker->new)
. |
(mixin) |
. |
MY (created by ExtUtils::MY) |
| |
ExtUtils::MY MM (created by ExtUtils::MM)
| |
ExtUtils::MM
| | |-----------------------
| | |
ExtUtils::Liblist ExtUtils::MakeMaker |
| |
ExtUtils::Liblist::Kid |
|
|
|
ExtUtils::MM_{Current OS} (if necessary)
|
ExtUtils::MM_Unix
|
ExtUtils::MM_Any
NOTE: Yes, this is a mess. See
http://archive.develooper.com/makemaker@perl.org/msg00134.html
for some history.
NOTE: When ExtUtils::MM is loaded it chooses a superclass for MM from
amongst the ExtUtils::MM_* modules based on the current operating
system.
NOTE: ExtUtils::MM_{Current OS} represents one of the ExtUtils::MM_*
modules except ExtUtils::MM_Any chosen based on your operating system.
NOTE: The main object used by MakeMaker is a PACK### object, *not*
ExtUtils::MakeMaker. It is, effectively, a subclass of MY,
ExtUtils::Makemaker, ExtUtils::Liblist and ExtUtils::MM_{Current OS}
NOTE: The methods in MY are simply copied into PACK### rather than
MY being a superclass of PACK###. I don't remember the rationale.
NOTE: ExtUtils::Liblist should be removed from the inheritence hiearchy
and simply be called as functions.
NOTE: Modules like File::Spec and Exporter have been omitted for clarity.
The MM_* hierarchy
******************
MM_Win95 MM_NW5
\ /
MM_BeOS MM_Cygwin MM_OS2 MM_VMS MM_Win32 MM_DOS MM_UWIN
\ | | | / / /
------------------------------------------------
| |
MM_Unix |
| |
MM_Any
NOTE: Each direct MM_Unix subclass is also an MM_Any subclass. This
is a temporary hack because MM_Unix overrides some MM_Any methods with
Unix specific code. It allows the non-Unix modules to see the
original MM_Any implementations.
NOTE: Modules like File::Spec and Exporter have been omitted for clarity.