## Filter::Heredoc 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 $ sudo ./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, BUGS 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 find source and look for more information at: GitHub: https://github.com/bkron/Filter-Heredoc Search CPAN https://metacpan.org/pod/Filter::Heredoc Report BUGS here https://github.com/bkron/Filter-Heredoc/issues ### LICENSE AND COPYRIGHT Copyright (C) 2011-2018 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.