home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / doc / libwww-perl / README < prev   
Encoding:
Text File  |  2008-09-24  |  2.5 KB  |  94 lines
  1.  
  2.                      L I B W W W - P E R L - 5
  3.                    -----------------------------
  4.  
  5.  
  6. The libwww-perl collection is a set of Perl modules which provides a
  7. simple and consistent application programming interface to the
  8. World-Wide Web.  The main focus of the library is to provide classes
  9. and functions that allow you to write WWW clients. The library also
  10. contain modules that are of more general use and even classes that
  11. help you implement simple HTTP servers.
  12.  
  13.  
  14. PREREQUISITES
  15.  
  16. In order to install and use this package you will need Perl version
  17. 5.6 or better.  Some modules within this package depend on other
  18. packages that are distributed separately from Perl.  We recommend that
  19. you have the following packages installed before you install
  20. libwww-perl:
  21.  
  22.   URI
  23.   MIME-Base64
  24.   HTML-Tagset
  25.   HTML-Parser
  26.   libnet
  27.   Digest-MD5
  28.   Compress-Zlib
  29.  
  30. If you want to access sites using the https protocol, then you need to
  31. install the Crypt::SSLeay or the IO::Socket::SSL module.  The
  32. README.SSL file will tell you more about how libwww-perl supports SSL.
  33.  
  34.  
  35. INSTALLATION
  36.  
  37. You install libwww-perl using the normal perl module distribution drill:
  38.  
  39.    perl Makefile.PL
  40.    make
  41.    make test
  42.    make install
  43.  
  44. If you don't want to install any programs (only the library files) then
  45. pass the '--no-programs' option to Makefile.PL:
  46.  
  47.    perl Makefile.PL --no-programs
  48.  
  49.  
  50. DOCUMENTATION
  51.  
  52. See the lib/LWP.pm file for an overview of the library. See the
  53. Changes file for recent changes.
  54.  
  55. POD style documentation is included in all modules and scripts.  These
  56. are normally converted to manual pages and installed as part of the
  57. "make install" process.  You should also be able to use the 'perldoc'
  58. utility to extract and read documentation from the module files
  59. directly.
  60.  
  61.  
  62. SUPPORT
  63.  
  64. Bug reports and suggestions for improvements can be sent to the
  65. <libwww@perl.org> mailing list.  This mailing list is also the place
  66. for general discussions and development of the libwww-perl package.
  67.  
  68.  
  69. AVAILABILITY
  70.  
  71. The latest version of libwww-perl is available from CPAN:
  72.  
  73.      http://search.cpan.org/dist/libwww-perl/
  74.  
  75. If you want to hack on the source it might be a good idea to grab the
  76. latest version with git using the command:
  77.  
  78.      git clone git://gitorious.org/libwww-perl/mainline.git lwp
  79.  
  80. You can also browse the git repository at:
  81.  
  82.      http://gitorious.org/projects/libwww-perl
  83.  
  84.  
  85. COPYRIGHT
  86.  
  87.   © 1995-2008 Gisle Aas. All rights reserved.
  88.   © 1995 Martijn Koster. All rights reserved.
  89.  
  90. This library is free software; you can redistribute it and/or modify
  91. it under the same terms as Perl itself.
  92.  
  93. Enjoy!
  94.