Filter::Heredoc version 0.01 Search and extract "any" here document embedded in scripts from STDIN or an input file. Pipe output to an external program such as hunspell or aspell. Filter::Heredoc extracts here documents from POSIX IEEE Std 1003.1-2008 compliant shell scripts. Perl have derived a similar here document syntax but is at the same time different in many details. Perls here document will be supported but is in the initial version experimental. SYNOPSIS use 5.010; use Filter::Heredoc qw( hd_getstate hd_init hd_labels ); my $line; my %state; my %label = hd_labels(); while ( defined( $line = )) { %state = hd_getstate( $line ); print $line if ( $state{statemarker} eq $label{heredoc} ); } See the 'examples' directory for code snippets. INSTALLATION The last command requires root/sudo privileges when installing system wide. To install this module, run the following commands: $ perl Build.PL $ ./Build $ ./Build test # ./Build install DEPENDENCIES Filter::Heredoc requires Perl 5.10 (or any later version). LIMITATIONS Filter::Heredoc complies with *nix POSIX shells here document syntax. Non-compliant shells on e.g. MSWin32 platform is not supported. SUPPORT AND DOCUMENTATION When you install Filter::Heredoc, manual pages will automatically be installed. On *nix systems, type "man Filter::Heredoc" or "perldoc Filter::Heredoc". See also "perldoc Filter::Heredoc::Cookbook" You can look for more information at: RT, CPAN's request tracker (report bugs here) http://rt.cpan.org/NoAuth/Bugs.html?Dist=Filter-Heredoc AnnoCPAN, Annotated CPAN documentation http://annocpan.org/dist/Filter-Heredoc CPAN Ratings http://cpanratings.perl.org/d/Filter-Heredoc Search CPAN http://search.cpan.org/dist/Filter-Heredoc/ LICENSE AND COPYRIGHT Copyright (C) 2011 Bertil Kronlund This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See http://dev.perl.org/licenses/ for more information.