SliTaz Repositories

     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/perl-extutils-makemaker/description.txt	Fri Dec 31 17:41:39 2021 +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.