treewide: "require" + "use" cleanup and docs

[public-inbox.git] / Makefile.PL

diff --git a/Makefile.PL b/Makefile.PL
index 0daa6107483214e3169fbfe05f5f0cc1bb74d363..3492d9653ece202ae1061970798828f4c9a3d78e 100644 (file)
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -71,7 +71,8 @@ $v->{xdocs} = [ map { "Documentation/.x/.$_.txt" } @xman ];
 $v->{xdocs_html} = [ map { "Documentation/.x/.$_.html" } @xman ];
 for (@{$v->{xdocs}}) {
        $t->{"$_ : | Documentation/.x"} = [
-               '$(PERL) -w Documentation/extman.perl >$@',
+               '$(PERL) -w Documentation/extman.perl $@ >$@+',
+               'mv $@+ $@'
        ];
        my $html = $_;
        $html =~ s/\.txt\z/.html/;
@@ -84,12 +85,12 @@ my $TGTS = join("\n", map {;
        my $tgt_prereq = $_;
        my $cmds = $t->{$_};
        "$tgt_prereq\n".join('', map { "\t$_\n" } @$cmds);
-} keys %$t);
+} sort keys %$t);
 
 my $VARS = join("\n", map {;
        my $varname = $_;
-       join('', map { "$varname += $_\n" } @{$v->{$varname}});
-} grep(!/^-/, keys %$v));
+       join('', map { "$varname += $_\n" } sort @{$v->{$varname}});
+} grep(!/^-/, sort keys %$v));
 
 # Don't waste user's disk space by installing some pods from
 # imported code or internal use only
@@ -136,7 +137,7 @@ WriteMakefile(
                # All Perl installs I know about have these, but RH-based
                # distros make them separate even though 'perl' pulls them in
                'File::Path' => 0,
-               'File::Temp' => '0.19',
+               'File::Temp' => '0.19', # for ->tmpdir support
                'Getopt::Long' => 0,
                'Exporter' => 0,
                # ExtUtils::MakeMaker # this file won't run w/o it...
@@ -146,6 +147,7 @@ WriteMakefile(
 
 sub MY::postamble {
   <<EOF;
+PROVE = prove
 # support using eatmydata to speed up tests (apt-get install eatmydata):
 # https://www.flamingspork.com/projects/libeatmydata/
 EATMYDATA =
@@ -165,10 +167,19 @@ changed = \$(shell git ls-files -m)
 dsyn :: \$(addsuffix .syntax, \$(filter \$(changed), \$(syn_files)))
 
 check-manifest :: MANIFEST
-       if git ls-files >\$?.gen 2>&1; then diff -u \$? \$?.gen; fi
+       if test -e .git && git ls-files >\$?.gen 2>&1; then \\
+               diff -u \$? \$?.gen; fi
 
-check:: pure_all check-manifest
-       \$(EATMYDATA) prove -bvw -j\$(N)
+# the traditional way running per-*.t processes:
+check-each :: pure_all check-manifest
+       \$(EATMYDATA) \$(PROVE) --state=save -bvw -j\$(N)
+
+# lightly-tested way to run tests, relies "--state=save" in check-each
+# for best performance
+check-run :: pure_all check-manifest
+       \$(EATMYDATA) \$(PROVE) -bvw t/run.perl :: -j\$(N)
+
+check :: check-each
 
 lib/PublicInbox/UserContent.pm :: contrib/css/216dark.css
        \$(PERL) -I lib \$@ \$?