Net::Gopher, version 1.15 (STABLE).
===============================================================================


INTRODUCTION


Net::Gopher is the Perl Gopher/Gopher+ API. This library  will  enable  you  to
communicate with Gopher and Gopher+ servers using Perl. To  get  started  using
Net::Gopher, use the following commands after installation:
 $ perldoc Net::Gopher
 $ perldoc Net::Gopher::Request
 $ perldoc Net::Gopher::Response
 $ perldoc Net::Gopher::Response::MenuItem
 $ perldoc Net::Gopher::Response::InformationBlock
 $ perldoc Net::Gopher::Constants


INSTALLATION


Install Net::Gopher as you would most other modules:
 $ perl Makefile.PL
 $ make
 $ make test
 $ make install

You can also use Module::Build instead of GNU Make:
 $ perl Build.PL
 $ perl Build
 $ perl Build test
 $ perl Build install


PREREQUISITES


Net::Gopher requires these modules:
 IO (at least version 1.20);
 URI (at least version 1.27);


TESTING


The new test suite that comes with Net::Gopher as of  0.92  has  its  own  test
server. This server tries to listen on what ever ports  your  OS  will  let  it
listen on. If you have some kind of firewall or port  blocking  enabled,  tests
that require this server may inexplicably fail  when  you  "make  test".  Also,
live.t contains live tests that will be done using real-world  Gopherspaces  if
you're connected to the Internet. If these sites are  down  or  malfunctioning,
this tests will inexplicably fail too.


COPYRIGHT AND LICENSE


Copyright 2003-2004 by William G. Davis.

This library is free software released  under  the  terms  of  the  GNU  Lesser
General Public License (LGPL), the full terms of which  can  be  found  in  the
"COPYING" file that comes with the distribution.

This library is distributed in the hope that it will  be  useful,  but  WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY  or  FITNESS
FOR A PARTICULAR PURPOSE.