Changeset 27183


Ignore:
Timestamp:
2013-04-15T20:49:36+12:00 (11 years ago)
Author:
davidb
Message:

Changing to using installed version of LWP that comes from libwww-perl, which is more self-contained than v6.x

Location:
main/trunk/greenstone2/perllib/cpan
Files:
30 added
1 edited

Legend:

Unmodified
Added
Removed

  • main/trunk/greenstone2/perllib/cpan/LWP.pm

    r27174 r27183  
    11package LWP;
    22
    3 $VERSION = "6.05";
     3$VERSION = "5.837";
    44sub Version { $VERSION; }
    55
    6 require 5.008;
     6require 5.005;
    77require LWP::UserAgent;  # this should load everything you need
    88
    … …  
    1010
    1111__END__
    12 
    13 =encoding utf-8
    1412
    1513=head1 NAME
    … …  
    102100
    103101Let us start with this quote from the HTTP specification document
    104 <URL:http://www.w3.org/Protocols/>:
     102<URL:http://www.w3.org/pub/WWW/Protocols/>:
    105103
    106104=over 3
    … …  
    155153=item *
    156154
    157 B<method> is a short string that tells what kind of
     155The B<method> is a short string that tells what kind of
    158156request this is.  The most common methods are B<GET>, B<PUT>,
    159157B<POST> and B<HEAD>.
    … …  
    161159=item *
    162160
    163 B<uri> is a string denoting the protocol, server and
     161The B<uri> is a string denoting the protocol, server and
    164162the name of the "document" we want to access.  The B<uri> might
    165163also encode various other parameters.
    … …  
    167165=item *
    168166
    169 B<headers> contains additional information about the
     167The B<headers> contain additional information about the
    170168request and can also used to describe the content.  The headers
    171169are a set of keyword/value pairs.
    … …  
    173171=item *
    174172
    175 B<content> is an arbitrary amount of data.
     173The B<content> is an arbitrary amount of data.
    176174
    177175=back
    … …  
    186184=item *
    187185
    188 B<code> is a numerical value that indicates the overall
     186The B<code> is a numerical value that indicates the overall
    189187outcome of the request.
    190188
    191189=item *
    192190
    193 B<message> is a short, human readable string that
     191The B<message> is a short, human readable string that
    194192corresponds to the I<code>.
    195193
    196194=item *
    197195
    198 B<headers> contains additional information about the
     196The B<headers> contain additional information about the
    199197response and describe the content.
    200198
    201199=item *
    202200
    203 B<content> is an arbitrary amount of data.
     201The B<content> is an arbitrary amount of data.
    204202
    205203=back
    … …  
    214212=item is_success()
    215213
    216 The request was successfully received, understood or accepted.
     214The request was was successfully received, understood or accepted.
    217215
    218216=item is_error()
    … …  
    254252=item *
    255253
    256 B<timeout> specifies how much time we give remote servers to
     254The B<timeout> specifies how much time we give remote servers to
    257255respond before the library disconnects and creates an
    258256internal I<timeout> response.
    … …  
    260258=item *
    261259
    262 B<agent> specifies the name that your application uses when it
     260The B<agent> specifies the name that your application should use when it
    263261presents itself on the network.
    264262
    265263=item *
    266264
    267 B<from> can be set to the e-mail address of the person
     265The B<from> attribute can be set to the e-mail address of the person
    268266responsible for running the application.  If this is set, then the
    269267address will be sent to the servers with every request.
    … …  
    271269=item *
    272270
    273 B<parse_head> specifies whether we should initialize response
     271The B<parse_head> specifies whether we should initialize response
    274272headers from the E<lt>head> section of HTML documents.
    275273
    276274=item *
    277275
    278 B<proxy> and B<no_proxy> specify if and when to go through
    279 a proxy server. <URL:http://www.w3.org/History/1994/WWW/Proxies/>
    280 
    281 =item *
    282 
    283 B<credentials> provides a way to set up user names and
     276The B<proxy> and B<no_proxy> attributes specify if and when to go through
     277a proxy server. <URL:http://www.w3.org/pub/WWW/Proxies/>
     278
     279=item *
     280
     281The B<credentials> provide a way to set up user names and
    284282passwords needed to access certain services.
    285283
    … …  
    559557provide.  The L<lwpcook> manpage is the libwww-perl cookbook that contain
    560558examples of typical usage of the library.  You might want to take a
    561 look at how the scripts L<lwp-request>, L<lwp-download>, L<lwp-dump>
    562 and L<lwp-mirror> are implemented.
     559look at how the scripts L<lwp-request>, L<lwp-rget> and L<lwp-mirror>
     560are implemented.
    563561
    564562=head1 ENVIRONMENT
    … …  
    585583L<LWP::UserAgent>.
    586584
    587 =item PERL_LWP_ENV_PROXY
    588 
    589 If set to a TRUE value, then the C<LWP::UserAgent> will by default call
    590 C<env_proxy> during initialization.  This makes LWP honor the proxy variables
    591 described above.
    592 
    593 =item PERL_LWP_SSL_VERIFY_HOSTNAME
    594 
    595 The default C<verify_hostname> setting for C<LWP::UserAgent>.  If
    596 not set the default will be 1.  Set it as 0 to disable hostname
    597 verification (the default prior to libwww-perl 5.840.
    598 
    599 =item PERL_LWP_SSL_CA_FILE
    600 
    601 =item PERL_LWP_SSL_CA_PATH
    602 
    603 The file and/or directory
    604 where the trusted Certificate Authority certificates
    605 is located.  See L<LWP::UserAgent> for details.
     585=item PERL_LWP_USE_HTTP_10
     586
     587Enable the old HTTP/1.0 protocol driver instead of the new HTTP/1.1
     588driver.  You might want to set this to a TRUE value if you discover
     589that your old LWP applications fails after you installed LWP-5.60 or
     590better.
    606591
    607592=item PERL_HTTP_URI_CLASS
    … …  
    662647as well as:
    663648
    664   http://github.com/libwww-perl/libwww-perl
     649  http://github.com/gisle/libwww-perl
    665650
    666651The best place to discuss this code is on the <[email protected]>
Note: See TracChangeset for help on using the changeset viewer.