Changeset 27183

Show
Ignore:
Timestamp:
15.04.2013 20:49:36 (7 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 modified

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 <libwww@perl.org>