OALDERS / LWP-Protocol-GHTTP-6.17 / README 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

              
NAME
    LWP::Protocol::GHTTP - (DEPRECATED) Provide GHTTP support for
    LWP::UserAgent via HTTP::GHTTP.
SYNOPSIS
        use strict;
        use warnings;
        use LWP::UserAgent;
     
        # create a new object
        LWP::Protocol::implementor('http', 'LWP::Protocol::GHTTP');
        my $ua = LWP::UserAgent->new();
        my $res = $ua->get('http://www.example.com');
        # note that we can only support the GET HEAD and POST verbs.
DESCRIPTION
    This module depends on the GNOME libghttp
    http://ftp.gnome.org/pub/gnome/sources/libghttp project. That project
    is no longer in development. If you are trying to use this module,
    you'd likely do better to just use LWP::Protocol::http or
    LWP::Protocol::https.
    LWP::Protocol::GHTTP is only capable of dispatching requests using the
    GET, POST, or HEAD verbs.
    You have been warned.
    The LWP::Protocol::GHTTP module provides support for using HTTP schemed
    URLs with LWP. This module is a plug-in to the LWP protocol handling,
    but since it takes over the HTTP scheme, you have to tell LWP we want
    to use this plug-in by calling LWP::Protocol's implementor function.
    This module used to be bundled with libwww-perl, but it was unbundled
    in v6.16 in order to be able to declare its dependencies properly for
    the CPAN tool-chain. Applications that need GHTTP support can just
    declare their dependency on LWP::Protocol::GHTTP and will no longer
    need to know what underlying modules to install.
CAVEATS
    WARNING!
    This module depends on the GNOME libghttp
    http://ftp.gnome.org/pub/gnome/sources/libghttp project. That project
    is no longer in development. If you are trying to use this module,
    you'd likely do better to just use LWP::Protocol::http or
    LWP::Protocol::https.
    Also, LWP::Protocol::GHTTP is only capable of dispatching requests
    using the GET, POST, or HEAD verbs.
FUNCTIONS
    LWP::Protocol::GHTTP inherits all functions from LWP::Protocol and
    provides the following overriding functions.
 request
        my $response = $ua->request($request, $proxy, undef);
        my $response = $ua->request($request, $proxy, '/tmp/sss');
        my $response = $ua->request($request, $proxy, \&callback, 1024);
    Dispatches a request over the HTTP protocol and returns a response
    object. Refer to LWP::UserAgent for description of the arguments.
AUTHOR
    Gisle Aas <gisle@ActiveState.com>
CONTRIBUTORS
      * Chase Whitener <capoeirab@cpan.org>
BUGS
    Please report any bugs or feature requests on GitHub
    https://github.com/genio/lwp-protocol-ghttp/issues. We appreciate any
    and all criticism, bug reports, enhancements, or fixes.
LICENSE AND COPYRIGHT
    Copyright 1997-2011 Gisle Aas.
    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.