The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

pod2html -- replacement for buggy pod2hmtl that comes with the perl distribution

SYNOPSIS

   pod2html *.pod

DESCRIPTION

I was sadly disappointed with the pod2html program that came with the perl distribution. (Try running it on the makepp pod files and compare the output with the output from this program! It's full of bugs.) This program fixes the bugs that I know of, and includes the following refinements:

  • Correctly handles links with special characters in them.

  • Correctly formats lists like

       =over 4
    
       =item *
    
       This is an item
    
       =back
  • Finds a lot more candidate links, because it analyzes a group of related pod files all at once.

This is a simple replacement that is designed to handle linking between different related pod files better.

parse_files

Parse a group of related pod files. For each .pod file, writes out a corresponding .html file in the same directory.

    pod2html("html_output_dir", glob("*.pod"));

AUTHOR

Gary Holt (holt-makepp@gholt.net)

29 June 2003