]> Sergey Matveev's repositories - public-inbox.git/commitdiff
Fix manpage section of perl module documentation
authorUwe Kleine-König <uwe@kleine-koenig.org>
Fri, 18 Dec 2020 11:56:14 +0000 (12:56 +0100)
committerEric Wong <e@80x24.org>
Fri, 18 Dec 2020 12:10:11 +0000 (12:10 +0000)
On Debian (at least) perl documentation is supposed to be installed in
section 3pm. With the build system hardcoding this to 3 instead this
results in a warning by the Debian package linter:

W: public-inbox: wrong-manual-section usr/share/man/man3/PublicInbox::Git.3.gz:74 3 != 3pm
W: public-inbox: wrong-manual-section usr/share/man/man3/PublicInbox::Import.3.gz:74 3 != 3pm
W: public-inbox: wrong-manual-section usr/share/man/man3/PublicInbox::SaPlugin::ListMirror.3.gz:74 3 != 3pm
W: public-inbox: wrong-manual-section ... use --no-tag-display-limit to see all (or pipe to a file/program)

So use "$(MAN3EXT)" instead of "3".

Makefile.PL

index 8e710df2a31379fe616b7fab18120e9592c8b5ab..57592378c76d554cda85daa343250a02f25bedb4 100644 (file)
@@ -118,7 +118,7 @@ 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" : '';