package Filter::Util::Exec ;

require 5.006 ;

require XSLoader;

our $VERSION = "1.58" ;

XSLoader::load('Filter::Util::Exec');

1 ;

__END__

=head1 NAME

Filter::Util::Exec - exec source filter

=head1 SYNOPSIS

    use Filter::Util::Exec;

=head1 DESCRIPTION

This module is provides the interface to allow the creation of I

Filters> which use a Unix coprocess.

See L<Filter::exec>, L<Filter::cpp> and L<Filter::sh> for examples of

the use of this module.

Note that the size of the buffers is limited to 32-bit.

=head2 B<filter_add()>

The function, C<filter_add> installs a filter. It takes one

parameter which should be a reference. The kind of reference used will

dictate which of the two filter types will be used.

If a CODE reference is used then a I<closure filter> will be assumed.

If a CODE reference is not used, a I<method filter> will be assumed.

In a I<method filter>, the reference can be used to store context

information. The reference will be I<blessed> into the package by

C<filter_add>.

See L<Filter::Util::Call> for examples of using context information

using both I<method filters> and I<closure filters>.

=head1 AUTHOR

Paul Marquess 

=head1 DATE

11th December 1995.

=cut