make_ext.pl: Add some general comments
authorKarl Williamson <khw@cpan.org>
Mon, 27 May 2019 18:04:58 +0000 (12:04 -0600)
committerKarl Williamson <khw@cpan.org>
Mon, 27 May 2019 18:12:24 +0000 (12:12 -0600)
I found myself recently not knowing how to deal with the build system.
Having these would have helped.

make_ext.pl

index 3175340..b963063 100644 (file)
@@ -54,6 +54,14 @@ my $ext_dirs_re = '(?:' . join('|', @ext_dirs) . ')';
 #       '# XXX hack for dependency # ordering'
 # below.
 #
+# The basic logic is:
+#   1) if there's a Makefile.PL in git for the module, use it. and call make
+#   2) If not, auto-generate one (normally)
+#   3) unless the auto-generation code figures out that the extension is
+#      *really* simple, in which case don't.  This will be for pure perl
+#      modules, and all that is needed to be done is to copy from the source
+#      to the dest directories.
+#
 # It may be deleted in a later release of perl so try to
 # avoid using it for other purposes.