Better document build dependency ordering
authorKarl Williamson <khw@cpan.org>
Mon, 27 May 2019 17:51:23 +0000 (11:51 -0600)
committerKarl Williamson <khw@cpan.org>
Mon, 27 May 2019 18:12:24 +0000 (12:12 -0600)
Makefile.SH
make_ext.pl

index dd5b25d..9ae1723 100755 (executable)
@@ -192,7 +192,8 @@ for f in $dynamic_ext; do
    esac
 done
 
-: Prepare dependency lists for Makefile.
+: Prepare dependency lists for Makefile.  Non-Unix systems likely will also
+: require changes in make_ext.pl
 dynamic_list=' '
 dynamic_ext_re="lib/auto/re/re.$dlext"
 extra_dep='
index 9bc4718..3175340 100644 (file)
@@ -48,6 +48,12 @@ my $ext_dirs_re = '(?:' . join('|', @ext_dirs) . ')';
 # by an '!ext' and are appropriate to the type of building being done.
 # An extensions follows the format of Foo/Bar, which would be extension Foo::Bar
 
+# To fix dependency ordering, on *nix systems, edit Makefile.SH to create a
+# rule.  That isn't sufficient for other systems; you also have to do
+# something in this file.  See the code at
+#       '# XXX hack for dependency # ordering'
+# below.
+#
 # It may be deleted in a later release of perl so try to
 # avoid using it for other purposes.
 
@@ -201,7 +207,7 @@ elsif (IS_VMS) {
     push @extspec, 'DynaLoader' if $dynaloader;
 }
 
-{
+{ # XXX hack for dependency ordering
     # Cwd needs to be built before Encode recurses into subdirectories.
     # Pod::Simple needs to be built before Pod::Functions
     # lib needs to be built before IO-Compress