xref: /openbsd-src/gnu/usr.bin/perl/ext/Pod-Html/bin/pod2html (revision 898184e3e61f9129feb5978fad5a8c6865f00b92)
1=pod
2
3=head1 NAME
4
5pod2html - convert .pod files to .html files
6
7=head1 SYNOPSIS
8
9    pod2html --help --htmlroot=<name> --infile=<name> --outfile=<name>
10             --podpath=<name>:...:<name> --podroot=<name>
11             --recurse --norecurse --verbose
12             --index --noindex --title=<name>
13
14=head1 DESCRIPTION
15
16Converts files from pod format (see L<perlpod>) to HTML format.
17
18=head1 ARGUMENTS
19
20pod2html takes the following arguments:
21
22=over 4
23
24=item help
25
26  --help
27
28Displays the usage message.
29
30=item htmlroot
31
32  --htmlroot=name
33
34Sets the base URL for the HTML files.  When cross-references are made,
35the HTML root is prepended to the URL.
36
37=item infile
38
39  --infile=name
40
41Specify the pod file to convert.  Input is taken from STDIN if no
42infile is specified.
43
44=item outfile
45
46  --outfile=name
47
48Specify the HTML file to create.  Output goes to STDOUT if no outfile
49is specified.
50
51=item podroot
52
53  --podroot=name
54
55Specify the base directory for finding library pods.
56
57=item podpath
58
59  --podpath=name:...:name
60
61Specify which subdirectories of the podroot contain pod files whose
62HTML converted forms can be linked-to in cross-references.
63
64=item index
65
66  --index
67
68Generate an index at the top of the HTML file (default behaviour).
69
70=item noindex
71
72  --noindex
73
74Do not generate an index at the top of the HTML file.
75
76
77=item recurse
78
79  --recurse
80
81Recurse into subdirectories specified in podpath (default behaviour).
82
83=item norecurse
84
85  --norecurse
86
87Do not recurse into subdirectories specified in podpath.
88
89=item title
90
91  --title=title
92
93Specify the title of the resulting HTML file.
94
95=item verbose
96
97  --verbose
98
99Display progress messages.
100
101=back
102
103=head1 AUTHOR
104
105Tom Christiansen, E<lt>tchrist@perl.comE<gt>.
106
107=head1 BUGS
108
109See L<Pod::Html> for a list of known bugs in the translator.
110
111=head1 SEE ALSO
112
113L<perlpod>, L<Pod::Html>
114
115=head1 COPYRIGHT
116
117This program is distributed under the Artistic License.
118
119=cut
120
121use Pod::Html;
122
123pod2html @ARGV;
124