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.