The changes are:
A few minor white-space changes that I missed in the previous batch.
Remove unnecessary () in conditions
Add tmp: prefix to tags that are just used by the style logic, so it is
clear they don't have special meaning to the mkgmap code and don't
overwrite osm tags. There are still a few tags created in relation that
I think should be renamed (mkgmap:boundary_name, mkgmap:relref,
mkgmap:fast_road, mkgmap:us_interstate, mkgmap:us_usroute,
mkgmap:us_state) but I won't do this yet.
Ferries default to mkgmap:toll=yes
add a few new points:
amenity=charging_station
amenity=grave_yard, crematorium
amenity=post_box
amenity=recycling
amenity=restaurant, cuisine=curry, fish_and_chips, indian, seafood
amenity=swimming_pool
tourism=bed_and_breakfast
add default name, either as [default_name ...] or {add name=...} to:
amenity=fast_food
amenity=prison
amenity=restaurant
amenity=playground
amenity=recreation_ground
shop=*
tourism=*
man_made=*
Improve Embassy name
git-svn-id: http://svn.mkgmap.org.uk/mkgmap/trunk@425725d90789-57f7-4ee0-8453-03a3dfeeeb

README

The goal of the project is to take the map data fromOpenStreetMap <http://www.openstreetmap.org>and to generate a map in the Garmin file format sothat it can be loaded onto Garmin GPS units.

The original motivation was to help plan mapping sessions,but now the maps are becoming useful in their own right.

Using=====

This program requires Java 1.6 or above to run.

Producing a map is simple. Save OpenStreetMap data from JOSM or by any other method to a file and copy it to the mkgmapdirectory. In the following examples this file is called data.osm.

Run the command:

java -jar mkgmap.jar data.osm

This will produce a file called 63240001.img.

You can copy the map to your Garmin GPS unit in any way you know how.It is best to use a SD card, since then if anything goes wrong youcan remove it from the unit and all should be well again.

Copy it to the file "Garmin/gmapsupp.img" on the card.On many modern Garmin devices, you can use a differentname so that you can have more than one set of maps.

*NOTE* this will overwrite any other map you have onthere, make sure that you are not overwriting a valuable map.

Another way would be to use a USB memory card writer andfor a large map this is quicker as many GPS's have a slow USBconnection.

There are also various programs that can send a map to thedevice.

You should (depending on the particular Garmin model) see a OSMcopyright message on starting up, and the map name 'OSM Street map'should appear in the map setup section.

For more help see: http://www.mkgmap.org.uk/doc/index.html

Invoking mkgmap--------------

Most of the default names mentioned in the previous section can be alteredby suitable options. Run

java -jar mkgmap.jar --help=options

to obtain an up to date and complete listing of options.

Processing more than one file at a time---------------------------------------

The Garmin map format was designed so that a map is made of a numberof tiles, and if your map has more data than can fit into a singletile, you will have to split the map.

See: http://www.mkgmap.org.uk/doc/splitter.html for a program thatcan do this.

You can compile all of the map tiles that are created by splitterall at once, by simply listing them all on the command line.

Acknowledgements================

This project is almost entirely based on the file format specificationdocument written by John Mechalas at the SourceForge project athttp://sourceforge.net/projects/garmin-img. The 'imgdecode' programfrom the same source was also very important in checking that I wason the right lines to producing a good file. Thanks.