NAME

Pod::Hlp - convert POD data to formatted VMS HLP Help module text.

SYNOPSIS

use Pod::Hlp;

pod2hlp("perlfunc.pod",$top_help_level,*Filehandle);

Also:

pod2hlp < input.pod

Also:

perl pod2hlb

DESCRIPTION

Pod::Hlp is a module that can convert documentation in the POD format (such as can be found throughout the Perl distribution) into formatted VMS *.HLP files. Such files can be inserted into an .HLB library through the LIBRARY/HELP/REPLACE system call, or via the use of the pod2hlb script supplied with the kit. A separate pod2hlp program is included that is primarily a wrapper for Pod::Hlp.

Termcap is optionally supported for boldface/underline, and can enabled via $Pod::Text::termcap=1. If termcap has not been enabled, then backspaces will be used to simulate bold and underlined text.

The single function pod2hlp() can take one, two, or three arguments. The first should be the name of a file to read the pod from, or "<&STDIN" to read from STDIN. A second argument, if provided, should be an integer indicating the help header level of the file as a whole where '1' is the default. A third argument, if provided, should be a filehandle glob where output should be sent.

AUTHOR

Peter Prymmer <pvhp@best.com>

based heavily on Pod::Text by:

Tom Christiansen <tchrist@mox.perl.com>

TODO

Cleanup work. OUTPUT formats need cleaning up, VT escapes should be substituted for the Term::Cap ones. The input and output locations need to be more flexible, termcap shouldn't be a global variable, and the terminal speed needs to be properly calculated.