   ___ ____           ____ _     _             
  |_ _|  _ \   _ _   / ___| |__ (_)_ __   __ _ 
   | || |_) | (_|_) | |   | '_ \| | '_ \ / _` |
   | ||  __/   _ _  | |___| | | | | | | | (_| |
  |___|_|     (_|_)  \____|_| |_|_|_| |_|\__,_|
                                               


This is the README for IP::China version 20180703.

IP::China is a "module" for the Perl computer programming language, a
library of computer code to install on a computer.  This document contains
four sections:

1. About - what the module does

2. Documentation - how to learn more about the module

3. Installation - how to install this module on a computer

4. Help - what to do if you get stuck

-----------------------------------------------------------------------------

1. ABOUT

IP::China - decide whether an internet address is from China

Decide whether an IP address originates from China.

-----------------------------------------------------------------------------

2. DOCUMENTATION

You can read the documentation for the module online at the following
websites:

    * http://search.cpan.org/perldoc?IP::China
    * http://metacpan.org/release/IP-China

(These links go to the latest version of the module.)

After installing the module, you can read the documentation on your
computer using

    perldoc IP::China

-----------------------------------------------------------------------------

3. INSTALLATION

This module requires Perl version 5.6.1 or later.

To install the module from CPAN, use

    cpan IP::China

If you have the App::cpanminus installer, you may prefer

    cpanm IP::China

To install the module from the source file, IP-China-20180703.tar.gz,
follow this sequence of commands:

    tar xfz IP-China-20180703.tar.gz
    cd IP-China-20180703
    perl Makefile.PL
    make
    make install

If you want to test the module before installing it, use "make test" after
"make" and before "make install".

-----------------------------------------------------------------------------

4. HELP

To get help with the module, you can email the author, Ben Bullock, at
<bkb@cpan.org>. If you think there is a problem in the module, you can
report a bug at 

<https://github.com/benkasminbullock/chinese-ip/issues>,

or if you want to alter the source code of IP::China, try the public
repository on github at 

<https://github.com/benkasminbullock/chinese-ip>. 

-----------------------------------------------------------------------------

This README was written on Wed Jul 11 15:45:42 2018.

-----------------------------------------------------------------------------
