Requirements
============
These are the "hard" requirements.

 - PHP 5.6+ including the PHP commandline interpreter
   (lately tested with PHP 7.3)
 - 'gd' module for PHP
 - A sane and working /bin/sh (bash or dash, for example)
 - 'convert' utility of ImageMagick or GraphicsMagick.
 - Mercurial (Hg) DVCS.
 - Pupunen Maputils ( https://tnsp.org/hg/batmud/maputils/ ) and
   th-libs utility library ( https://tnsp.org/hg/th-libs/ )
   and their depencies.

NOTICE! Running "makegmaps.php" will automatically fetch maputils
and th-libs, assuming you have Mercurial installed.


How to install
==============
Steps for producing your own fancy Google Maps -style BatMap:

1. Run tools/makegmaps.php:

   $ cd tools
   $ php makegmaps.php

   If running for the first time, you will be prompted for some data.

2. Possibly check/edit config.inc.php , it is generated by makegmaps.php

3. Some web-server configuration may be necessary.

4. ???

5. Profit.


How to keep up to date
======================

1. To update gmap repo:

   $ hg pull && hg up

2. For the rest, just run makegmaps.php, it should take care of
   things automagically.

Sometimes it _may_ be necessary to delete contents of tools/cache/
and/or remove tilecache from tiles/ (achieved most easily by running
"hg clean --all ." under tiles/ directory.)