1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
|
=cut
TITLE=podhtml
DESCRIPTION=podhtml is yet another POD-to-HTML translator
KEYWORDS=POD,HTML
DOCTOP=index
DOCPREV=genmenu
DOCNEXT=podlatex
=pod
=head1 podhtml - translate a POD file to HTML
=head2 Usage:
=exec ../podhtml -h 2>&1
=head2 Description:
See the docs for C<pod2html>. The only changes that I made
intentionally from how C<pod2html> does things are:
=over 4
=item if a line looks blank it's treated as blank. I prefer
to avoid surprises.
=item I added a new C<=exec> which executes a command line and
inserts the output of stdout into the resulting HTML as a <PRE>
section. This was so that I could get the latest usage message
from programs inserted without having to run each program separately,
save its output in a file, and manually insert the file into
the POD file.
=item I also caused it to append to a file called C<podhtml--rawindex>
for each =head1 and =head2, a URL for that page and section and the
contents of that =headN. This is used by L<genindex> to make an index.
=back 4
I wrote this version in frustration with the way pod2html does
links. Or doesn't. I could never tell without trying whether
it would generate a link or not.
|
