README for Perl extension WWW::Curl

The perl module WWW::Curl provides an interface to the cURL library "libcurl".
See http://curl.haxx.se/ for more information on cURL and libcurl.

This module requires libcurl and the corresponding headerfiles to be
installed. You then may install this module via the usual way
(for installation on Windows please see README.Win32):

    perl Makefile.PL
    make
    make test
    make install

The Makefile.PL script will try to use the 'curl-config' command to find
the correct headers and libcurl path. If curl.h can't be found,
either through curl-config or the internal list of guesses, you can specify
an explicit path when building the Makefile:

    perl Makefile.PL /home/foo/curl/include

Minimum version requirements:

This module, starting from version 4 requires at least Perl 5.6 and libcurl 7.10.8.
These releases are more than 5 years old and they have multiple security vulnerabilities,
it is advised that you upgrade as soon as possible to a more recent, secure version.
Anything older than these versions of Perl and libcurl respectively are not supported.

Windows specific fixes and patches are welcome as testing is mainly focused on linux.

The module provides the same functionality, except as noted in the documentation, 
as libcurl provides to C programs. Please refer to the documentation of libcurl for the
general interface description and the WWW::Curl POD for the differences.

This software is distributed AS IS, WITHOUT WARRANTY OF ANY KIND, either
express or implied.

History:

The author of the original relase of this software is Georg Horn <horn at koblenz-net.de>

Parts of the callback support were added Forrest Cahoon
<forrest.cahoon at merrillcorp.com>

More callback support, many tests additional documentation and Makefile
features have been added by Cris Bailiff <c.bailiff+curl at devsecure.com>

Curl multi support has been added by Sebastian Riedel <sri at oook.de>

The current maintainer is Cris Bailiff <c.bailiff+curl at devsecure.com>

The latest version can be downloaded from http://curl.haxx.se/libcurl/perl/ or
found on CPAN as the module WWW::Curl
 
Copyright (C) 2000-2005, 2008 Daniel Stenberg, Cris Bailiff , 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.