view release on metacpan or  search on metacpan

lib/Filter/Heredoc/Cookbook.pod  view on Meta::CPAN

=cut

=head1 DESCRIPTION

This is the L<Filter::Heredoc::Cookbook>.

This is intended to provide examples and food for thoughts
on the topic 'interesting here document concepts'.

=head1 POD AS HERE DOCUMENTS EMBEDDED IN SHELL SCRIPTS

Embedding documentation in source files as programmers reference
is an excellent strategy to keep them up to date. Embedding POD in
shell scripts as here documents achieves that goal.

Once documentation is in POD, tools like I<pod2pdf> and I<pod2html>
converts files with embedded documentation to pdf or html formats:

    pod2pdf diskusage > diskusage.pdf
    pod2html --infile=diskusage > diskusage.html