package WWW::Curl::Multi;

use strict;
use WWW::Curl;

1;
__END__

=head1 NAME

WWW::Curl::Multi - Perl extension interface for libcurl

=head1 SYNOPSIS

    use WWW::CURL::Multi;
    my $curlm = new WWW::Curl::Multi;
    $curlm->add_handler($curl);
    $curlm->perform;
    $curlm->remove_handler($curl);

=head1 DESCRIPTION

WWW::Curl::Multi is an extension to WWW::Curl::Easy
which makes it possible to process multiple easy
handles parallel.

=head1 METHODS

    $curlm = new WWW::Curl::Multi
        This method constructs a new WWW::Curl::Multi object.

    $curlm->add_handler( $curl )
        This method adds a WWW::Curl::Easy object to the multi stack.

    $curlm->perform
        This method parallel perlforms all WWW::Curl::Easy objects
        on the stack.
	
	*Warning* - this does not perform exactly the
	same functions as the direct libcurl function - for example,
	there's no opportunity to get the fdset back at any time, so
	this interface could change in future as those functions
	are added.

    $curl->remove_handler( $curl )
        This method removes a WWW::Curl::Easy object from the stack.

=head1 AUTHOR

Sebastian Riedel (sri@cpan.org)

=head1 COPYRIGHT

Copyright (C) 2004 Sebastian Riedel, et al.
                                                                                
You may opt to use, copy, modify, merge, publish, distribute and/or sell
copies of the Software, and permit persons to whom the Software is furnished
to do so, under the terms of the MPL or the MIT/X-derivate licenses. You may
pick one of these licenses.

=head1 SEE ALSO
                                                                                
WWW::Curl, WWW::Curl::Easy, http://curl.haxx.se/