wok view perl-extutils-makemaker/description.txt @ rev 25503
f3: include extra programs
| author | Hans-G?nter Theisgen |
|---|---|
| date | Fri Jan 27 10:37:43 2023 +0100 (15 months ago) |
| parents | |
| children |
line source
1 This utility is designed to write a Makefile for an extension module
2 from a Makefile.PL.
3 It is based on the Makefile.SH model provided by Andy Dougherty and
4 the perl5-porters.
6 It splits the task of generating the Makefile into several subroutines
7 that can be individually overridden. Each subroutine returns the text
8 it wishes to have written to the Makefile.
10 As there are various Make programs with incompatible syntax, which use
11 operating system shells, again with incompatible syntax, it is important
12 for users of this module to know which flavour of Make a Makefile has
13 been written for so they'll use the correct one and won't have to face
14 the possibly bewildering errors resulting from using the wrong one.
16 On POSIX systems, that program will likely be GNU Make;
17 on Microsoft Windows, it will be either Microsoft NMake, DMake or GNU Make.
19 ExtUtils::MakeMaker (EUMM) is object oriented. Each directory below the
20 current directory that contains a Makefile.PL is treated as a separate
21 object. This makes it possible to write an unlimited number of Makefiles
22 with a single invocation of WriteMakefile().
24 All inputs to WriteMakefile are Unicode characters, not just octets.
25 EUMM seeks to handle all of these correctly. It is currently still not
26 possible to portably use Unicode characters in module names, because
27 this requires Perl to handle Unicode filenames, which is not yet the
28 case on Windows.