REQUIRES

perl5.004, Pod::Select, Term::Cap, Exporter, Carp

EXPORTS

pod2plaintext()

DESCRIPTION

Pod::PlainText is a module that can convert documentation in the POD format (such as can be found throughout the Perl distribution) into formatted ASCII. Termcap is optionally supported for boldface/underline, and can be enabled via $Pod::PlainText::termcap=1. If termcap has not been enabled, then backspaces will be used to simulate bold and underlined text.

A separate pod2plaintext program is included that is primarily a wrapper for Pod::PlainText::pod2plaintext().

The single function pod2plaintext() can take one or two 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 a filehandle glob where output should be sent.