Perl6::Perldoc is a Perl module that allows you to use Perl 6 documentation in a Perl 5 program.

SYNOPSIS

 use Perl6::Perldoc;

 =comment
 Now you can use Perl 6 style documentation

 =for DATA
 Including Perl 6 style DATA sections

 print < DATA >;

 =for DATA
 Of which there can be more than one

This module preprocesses your code from the point at which the module is first used, stripping out any Perl 6 documentation (as specified in Synopsis 26).

This means that, so long as your program starts with:

 use Perl6::Perldoc;

you can document it using the new Pod mark-up notation and it will still run correctly under the Perl 5 interpreter.

In addition, the module detects any =DATA sections in the stripped documentation and makes them available to your program in three ways:

 * As a single concatentated string, in the $DATA package variable
 * As a sequence of strings (one per =DATA block) in the @DATA package variable
 * As a single concatenated input stream in the *DATA filehandle.


Product's homepage

Requirements:

· Perl