doc: re-add missing 1.6 release notes

[public-inbox.git] / Makefile.PL

diff --git a/Makefile.PL b/Makefile.PL
index 3fe9acf80bc03321b70383d071adcfcf05035c1c..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;
@@ -10,7 +10,7 @@ my $v = {};
 my $t = {};
 
 # do not sort
-my @RELEASES = qw(v1.6.0 v1.5.0 v1.4.0 v1.3.0 v1.2.0 v1.1.0-pre1 v1.0.0);
+my @RELEASES = qw(v1.6.1 v1.6.0 v1.5.0 v1.4.0 v1.3.0 v1.2.0 v1.1.0-pre1 v1.0.0);
 
 $v->{news_deps} = [ map { "Documentation/RelNotes/$_.eml" } @RELEASES ];
 $v->{txt} = [ qw(INSTALL README COPYING TODO HACKING) ];
@@ -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);
@@ -107,12 +118,16 @@ my %man3 = map {; # semi-colon tells Perl this is a BLOCK (and not EXPR)
        my $mod = $base;
        $mod =~ s!/!::!g;
        $mod =~ s/\.\w+\z//;
-       "lib/PublicInbox/$_" => "blib/man3/PublicInbox::$mod.3"
+       "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',
-       VERSION => '1.6.0',
+       NAME => 'PublicInbox', # n.b. camel-case is not our choice
+
+       # XXX drop "PENDING" in .pod before updating this!
+       VERSION => '1.6.1',
+
        AUTHOR => 'Eric Wong <e@80x24.org>',
        ABSTRACT => 'public-inbox server infrastructure',
        EXE_FILES => \@EXE_FILES,
@@ -169,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 \$<
@@ -206,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
 }