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


This is the README for Geo::Postcodes::JP version 0.014.

Geo::Postcodes::JP 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

Geo::Postcodes::JP - handle Japan Post Office postal code data

This package contains a series of modules for handling the files of
postcodes supplied by Japan Post. "Geo::Postcodes::JP::Update"
downloads the data files.  "Geo::Postcodes::JP::Process" parses the
data files, and can improve the data.  "Geo::Postcodes::JP::DB"
inserts the postcode data read by the processing module into an SQLite
database. The main module provides a way to access the postcodes in an
existing SQLite database.

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

2. DOCUMENTATION

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

    * http://search.cpan.org/perldoc?Geo::Postcodes::JP
    * http://metacpan.org/release/Geo-Postcodes-JP

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

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

    perldoc Geo::Postcodes::JP

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

3. INSTALLATION

This module requires Perl version 5.8.9 or later.

To install the module from CPAN, use

    cpan Geo::Postcodes::JP

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

    cpanm Geo::Postcodes::JP

To install the module from the source file, Geo-Postcodes-JP-0.014.tar.gz,
follow this sequence of commands:

    tar xfz Geo-Postcodes-JP-0.014.tar.gz
    cd Geo-Postcodes-JP-0.014
    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/Geo-Postcodes-JP/issues>,

or if you want to alter the source code of Geo::Postcodes::JP, try the public
repository on github at 

<https://github.com/benkasminbullock/Geo-Postcodes-JP>. 

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

This README was written on Fri Feb  7 00:18:26 2014.

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