wok annotate perl-extutils-makemaker/description.txt @ rev 24300
updated tcsh (6.22.02 -> 6.23.02)
| author | Hans-G?nter Theisgen |
|---|---|
| date | Sat Jan 15 16:54:59 2022 +0100 (2022-01-15) |
| 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. |