LINUX SUPPORT
=============

This release includes two bash (yes, you need bash, not any shell) scripts that make these maps usable on a Unix system. However, they are not simply Unix versions of the windows batch files and operate quite differently, so please read this documentation. The scripts are

	1) linux_create_gmapsupp.img.sh -- create a gmapsupp.img file of the maps for you device
	2) linux_install_mapsource.sh -- make maps available in MapSource

See detailed instructions below.



linux_create_gmapsupp.img.sh
============================

Usage: linux_create_gmapsupp.img.sh STYLE

This script generates a gmapsupp.img file that can be placed on the device or on a memory card (recommended). It requires the native version of ``gmt'' which can be downloaded from <http://www.anpo.republika.pl/download.html> (place it in this directory).

You can choose from three slightly different rendering styles, in particular

	clas*   (optimized for Oregon/Colorado)
	wide*   (optimized for Vista/Legend series)
	thin*   (optimized for Gpsmap60/76 series)

run

	$ ./linux_create_gmapsupp.img.sh

to see which styles are actually available. Select one (e.g. clasde) and pass it to the script
	
	$ ./linux_create_gmapsupp.img.sh clasde

which then generates your gmapsupp.img.

Adding contour lines is easy: Simply place the 7*.img files from the contour line package in this directory. This script will then automatically include them in your gmapsupp.img build. All done!



linux_install_mapsource.sh
==========================

Usage: linux_install_mapsource.sh STYLE

This script enables the maps in MapSource for your viewing and routing pleasure. Please note that this is the only intended use -- sending the maps to the device is not supported.. Requirements:

	* wine (you need it anyway for MapSource)
	* MapTk Windows version <http://www.maptk.dnsalias.com/>, *must* be installed to C:\Garmin\maptk\ (careful, case-sensitive)

You can choose from four different rendering styles, in particular

	clas*   (NO CONTOUR LINES)
	wide*   (NO CONTOUR LINES)
	thin*   (NO CONTOUR LINES)
	srtm*   (WITH COUNTOUR LINES, if available)

run

	$ ./linux_install_mapsource.sh

to see which styles are actually available. Select one (e.g. clasde) and pass it to the script
	
	$ ./linux_install_mapsource.sh clasde

which then enables the maps in MapSource.

Contour lines are added if and only if they are places in this directory (7*.img) *and* you selected the srtm* style.
