
******************************************************************************

Starting from Xrmap-2.0, the binary format of the CIA World Data Bank II
used by xrmap HAS CHANGED. The new format is referred to as the JPD
format; it is approximately 4 times more compact than the earlier REZ
format, and allows a substantially quicker access to the data.

As a result, xrmap can NO LONGER ACCESS the previous CIA_map.rez file.
However, it is POSSIBLE TO CONVERT the REZ file into JPD format by
usning the 'rez2else' utility from the  tools/rez2else/ subdirectory.
Just 'cd' to there and type 'make' to compile 'rez2else'. Then type
something like

rez2else -format jpd -rezfile /usr/share/rmap/CIA_map.rez -output CIA_WDB2.jpd

(or possibly ./rez2else if ./ is not in your path). Then copy CIA_WDB2.jpd
into the SHAREDIR directory of xrmap (/usr/share/rmap by default). You can
erase 'CIA_map.rez' unless you still want to use rmap or the older versions 
of xrmap. The 'jpd2else' utility can convert back to REZ format if needed.

Starting from Xrmap-2.10, the format of the 'Locations' file has changed
a lot and is NO LONGER COMPATIBLE with earlier versions. You can now set
a list of PRESELECTED locations at startup - check EXAMPLE.rc,
e.g. via 'xrmap -rcfile EXAMPLE.rc'.

Xrmap can now play National hymns ! For this, you have to install a MIDI
player together with GUS samples (see README and midi_cfg/README).

Starting with Xrmap-2.12, the default distribution does no longer include
the DATA FILES. You should therefore download them SEPARATELY, and 
uncompress them in SHAREDIR (/usr/share/rmap by default) :

Required:
   7430228 CIA_WDB2.jpd.gz             (CIA vector map data)

Recommended:
     95748 anthems-1.1.tgz             (national anthems)
   1199839 flags-1.1.tgz               (national flags)
    612060 hymns-1.2.tgz               (national hymns in MIDI format)
    699410 factbook_text_2002.tar.bz2  (CIA factbook, ASCII format)

Optional:
   4321312 factbook_html_2002.tar.bz2  (CIA factbook, HTML format + maps)
  26111867 pdfmaps-1.1.tar.bz2         (PDF maps from United Nations)
  29194589 eawpats12.tar.bz2           (GUS samples for the MIDI player)

available from ftp://ftp.ac-grenoble.fr/ge/geosciences/xrmap/data

Starting with Xrmap-2.20, xrmap can be used to EDIT THE MAPS. Check MAPEDIT
for details. 

Notice that the CIA_WDB2.jpd data bank has been upgraded on May 9, 2003,
to include the NEW INTERNATIONAL BORDER LINES appeared after 1990. 

We recommend to download the new data, or to upgrade the old ones
via xrmap itself (only version 2.28 or later can auto-upgrade).
The script 'tools/upgrade/upgrade_WDB2' should do it for you.

******************************************************************************
