wok-6.x diff perl-extutils-makemaker/description.txt @ rev 25138
updated phppgadmin (7.12.1 -> 7.13.0)
author | Hans-G?nter Theisgen |
---|---|
date | Wed Jun 29 11:15:15 2022 +0100 (2022-06-29) |
parents | |
children |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/perl-extutils-makemaker/description.txt Wed Jun 29 11:15:15 2022 +0100 1.3 @@ -0,0 +1,28 @@ 1.4 +This utility is designed to write a Makefile for an extension module 1.5 +from a Makefile.PL. 1.6 +It is based on the Makefile.SH model provided by Andy Dougherty and 1.7 +the perl5-porters. 1.8 + 1.9 +It splits the task of generating the Makefile into several subroutines 1.10 +that can be individually overridden. Each subroutine returns the text 1.11 +it wishes to have written to the Makefile. 1.12 + 1.13 +As there are various Make programs with incompatible syntax, which use 1.14 +operating system shells, again with incompatible syntax, it is important 1.15 +for users of this module to know which flavour of Make a Makefile has 1.16 +been written for so they'll use the correct one and won't have to face 1.17 +the possibly bewildering errors resulting from using the wrong one. 1.18 + 1.19 +On POSIX systems, that program will likely be GNU Make; 1.20 +on Microsoft Windows, it will be either Microsoft NMake, DMake or GNU Make. 1.21 + 1.22 +ExtUtils::MakeMaker (EUMM) is object oriented. Each directory below the 1.23 +current directory that contains a Makefile.PL is treated as a separate 1.24 +object. This makes it possible to write an unlimited number of Makefiles 1.25 +with a single invocation of WriteMakefile(). 1.26 + 1.27 +All inputs to WriteMakefile are Unicode characters, not just octets. 1.28 +EUMM seeks to handle all of these correctly. It is currently still not 1.29 +possible to portably use Unicode characters in module names, because 1.30 +this requires Perl to handle Unicode filenames, which is not yet the 1.31 +case on Windows.