From: Russ Allbery
Date: Mon, 14 Jul 2008 02:54:18 +0000 (+0000)
Subject: DEVEL15-man-page-html-generation-hack-20080713
X-Git-Tag: openafs-devel-1_5_50~20
X-Git-Url: https://git.michaelhowe.org/gitweb/?a=commitdiff_plain;h=988a6de64e5ad1b7f133be93df7b08c3d8624f13;p=packages%2Fo%2Fopenafs.git
DEVEL15-man-page-html-generation-hack-20080713
LICENSE BSD
Pod::Simple::Search ignores every POD file that doesn't "look right," which
means it skips files containing a period (like krb.conf.pod) unless you set
a search option. Pod::Simple::HTMLBatch has no way to set search options.
Apply a truly horrible hack to get around this.
(cherry picked from commit 2a92f43987cd08dc0134b775e0d118894d22d3e5)
---
diff --git a/doc/man-pages/generate-html b/doc/man-pages/generate-html
index 11d47c698..83570b1bb 100755
--- a/doc/man-pages/generate-html
+++ b/doc/man-pages/generate-html
@@ -37,6 +37,24 @@ $Pod::Simple::HTML::Tagmap{'/item-bullet'} = '
';
$Pod::Simple::HTML::Tagmap{'item-number'} = '';
$Pod::Simple::HTML::Tagmap{'/item-number'} = '
';
+# This horrific hack is required because Pod::Simple::HTMLBatch has no way
+# of setting search options and we have to set laborious to true in order
+# to pick up man pages like krb.conf(5).
+package OpenAFS::Search;
+
+use strict;
+use vars qw(@ISA);
+
+use Pod::Simple::Search;
+@ISA = qw(Pod::Simple::HTML);
+
+sub new {
+ my $class = shift;
+ my $object = Pod::Simple::Search->new;
+ $object->laborious (1);
+ return $object;
+}
+
package main;
use strict;
@@ -44,6 +62,9 @@ use strict;
use File::Copy;
use Pod::Simple::HTMLBatch;
+# Override the search class to set laborious.
+$Pod::Simple::HTMLBatch::SEARCH_CLASS = 'OpenAFS::Search';
+
our $HEADER = <<'EOH';