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