IP::World is Copyright (C) 2010, Craig MacKenna <[email protected]>

DESCRIPTION

 IP::World returns the ISO-3166 country code associated with an IP4
 address.  It uses two free databases from WIPmania.com and MaxMind.com.

 The included application 'maint_ip_world_db' checks whether the
 included IP::World database needs updating during installation, and
 can be run or scheduled to keep it current.  WIPmania.com and
 MaxMind.com release new source data bimonthly and monthly,
 respectively.  On a server, 'maint_ip_world_db' can be scheduled
 (cron'ed on Unix/Linux) to run at an unbusy time.

LICENSE INFORMATION

 This module is free software; you may redistribute it and/or modify
 it under the same terms as Perl 5.10.1.  For more details, see the
 full text of the licenses at

 <http://www.perlfoundation.org/artistic_license_1_0> and
 <http://www.gnu.org/licenses/gpl-2.0.html>.

 This program is distributed in the hope that it will be useful, but
 it is provided "as is" and without any express or implied warranties.
 For details, see the full text of the licenses at the above URLs.

INSTALLATION

 During the installation you will be asked if you want to enter a
 command for 'maint_ip_world_db' to run when the database is updated.
 (The author enters a command to restart his Apache server at this point.)
 If you don't want to use this feature, just hit Return.

 Easy ways to install IP::World:

   $ perl -MCPAN -e "install IP::World"

   OR

   $ perl -MCPANPLUS -e 'fetch IP::World'

 The classic way:

   Choose a directory to use for installing.
   Move/download the distribution file IP-World-n.nn.tar.gz into that directory
   cd into the directory
   $ tar -xf IP-World-n.nn.tar.gz

   This will produce a new directory IP-World-n.n.

   $ cd IP-World-n.n
   $ perl Build.PL
   $ ./Build
   $ ./Build test

   Assuming those steps don't show any problems:

   $ sudo ./Build install  (or just ./Build install if you're superuser)

 Windows users can omit the './' and just type Build.

 Either of the above alternatives should install IP::World into the
 Perl library.

 See the POD documentation for further details. Once the module
 is installed, you should be able to read the documentation by
 typing the following from the command-line:

   $ perldoc IP::World

 Or if your man system is configured in a compatible way:

   $ man IP::World

NOTES

   This module requires perl 5.7.3 or later.

   The author uses it for customizing web pages on his server to the
   location of the visitor, particularly to quote prices of items
   for sale in the visitor's currency.  Also for server log analysis.

   Craig MacKenna <[email protected]>
   Apr 7 2010