doc: re-add missing 1.6 release notes

[public-inbox.git] / Makefile.PL

diff --git a/Makefile.PL b/Makefile.PL
index be3471a6a4c8d0fac8977793bf3a08a14e899fdc..9d0a361a46d881e4f556e8ba7c927e599e56ae7a 100644 (file)
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -1,5 +1,5 @@
 #!/usr/bin/perl -w
-# Copyright (C) 2013-2020 all contributors <meta@public-inbox.org>
+# Copyright (C) 2013-2021 all contributors <meta@public-inbox.org>
 # License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
 use strict;
 use ExtUtils::MakeMaker;
@@ -31,9 +31,20 @@ my @syn = (@EXE_FILES, grep(m!^lib/.*\.pm$!, @manifest), @scripts);
 @syn = grep(!/SaPlugin/, @syn) if !eval { require Mail::SpamAssasin };
 $v->{syn_files} = \@syn;
 $v->{my_syntax} = [map { "$_.syntax" } @syn];
-$v->{-m1} = [ map { (split('/'))[-1] } @EXE_FILES ];
+my @no_pod;
+$v->{-m1} = [ map {
+               my $x = (split('/'))[-1];
+               my $pod = "Documentation/$x.pod";
+               if (-f $pod) {
+                       $x;
+               } else {
+                       warn "W: $pod missing\n";
+                       push @no_pod, $x;
+                       ();
+               }
+       } @EXE_FILES ];
 $v->{-m5} = [ qw(public-inbox-config public-inbox-v1-format
-               public-inbox-v2-format) ];
+               public-inbox-v2-format public-inbox-extindex-format) ];
 $v->{-m7} = [ qw(public-inbox-overview public-inbox-tuning) ];
 $v->{-m8} = [ qw(public-inbox-daemon) ];
 my @sections = (1, 5, 7, 8);
@@ -109,6 +120,7 @@ my %man3 = map {; # semi-colon tells Perl this is a BLOCK (and not EXPR)
        $mod =~ s/\.\w+\z//;
        "lib/PublicInbox/$_" => "blib/man3/PublicInbox::$mod.\$(MAN3EXT)"
 } qw(Git.pm Import.pm WWW.pod SaPlugin/ListMirror.pod);
+my $warn_no_pod = @no_pod ? "\n\t\@echo W: missing .pod: @no_pod\n" : '';
 
 WriteMakefile(
        NAME => 'PublicInbox', # n.b. camel-case is not our choice
@@ -172,6 +184,8 @@ $VARS
 -include Documentation/include.mk
 $TGTS
 
+check-man ::$warn_no_pod
+
 # syntax checks are currently GNU make only:
 %.syntax :: %
        @\$(PERL) -w -I lib -c \$<
@@ -209,5 +223,22 @@ Makefile.PL : MANIFEST
        touch -r MANIFEST \$@
        \$(PERLRUN) \$@
 
+# Install symlinks to ~/bin (which is hopefuly in PATH) which point to
+# this source tree.
+# prefix + bindir matches git.git Makefile:
+prefix = \$(HOME)
+bindir = \$(prefix)/bin
+symlink-install :
+       mkdir -p \$(bindir)
+       lei=\$\$(realpath lei.sh) && cd \$(bindir) && \\
+       for x in \$(EXE_FILES); do \\
+               ln -sf "\$\$lei" \$\$(basename "\$\$x"); \\
+       done
+
+update-copyrights :
+       \@case '\$(GNULIB_PATH)' in '') echo >&2 GNULIB_PATH unset; false;; esac
+       git ls-files | UPDATE_COPYRIGHT_HOLDER='all contributors' \\
+               UPDATE_COPYRIGHT_USE_INTERVALS=2 \\
+               xargs \$(GNULIB_PATH)/build-aux/update-copyright
 EOF
 }