NAME

Apache::Pod::HTML - base class for converting Pod files to prettier forms

VERSION

Version 0.02

$Header: /home/cvs/apache-pod/lib/Apache/Pod/HTML.pm,v 1.5 2002/09/30 04:42:05 andy Exp $

SYNOPSIS

A simple mod_perl handler to easily convert Pod to HTML or other forms. You can also emulate perldoc.

CONFIGURATION

Pod-to-HTML conversion

Add the following lines to your httpd.conf.

    <Files *.pod>
	SetHandler perl-script
	PerlHandler Apache::Pod::HTML
    </Files>

All *.pod files will magically be converted to HTML.

perldoc emulation

The following configuration should go in your httpd.conf

<Location /perldoc>
  SetHandler perl-script
  PerlHandler Apache::Pod::HTML
</Location>

You can then get documentation for a module Foo::Bar at the URL http://your.server.com/perldoc/Foo::Bar

Note that you can also get the standard Perl documentation with URLs like http://your.server.com/perldoc/perlfunc or just http://your.server.com/perldoc for the main Perl docs.

Finally, you can search for a particular Perl keyword with http://your.server.com/perldoc/f/keyword The 'f' is used by analogy with the -f flag to perldoc.

AUTHOR

Andy Lester <andy@petdance.com>, adapted from Apache::Perldoc by Rich Bowen <rbowen@ApacheAdmin.com>

LICENSE

This package is licensed under the same terms as Perl itself.