## 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 = <ARGV> )) {
        %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.