Roadnav
Copyright (c) 2004 - 2007 Richard L. Lynch <rllynch@users.sourceforge.net>

Roadnav is an open source street navigation solution capable of running
on a variety of operating systems. It can obtain your position from a GPS
unit, plot a map of your area, and provide directions to locations in the
USA. It can also verbalize directions using Microsoft SAPI 5.1, Festival, 
flite, and OS X's built in text to speech engine.

Roadnav uses the free TIGER/Line (Topologically Integrated Geographic 
Encoding and Referencing) files from the US Census Bureau to build the 
maps, along with the GNIS state and topical gazetteer data from the USGS 
to identify locations. It has experimental support for scripting, 
LCDproc, importing OpenStreetMap data, and importing GPX waypoints and 
tracks.

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

1. INSTALLATION

Unix Prerequisites:
- wxWindows 2.6.2 or newer
- LibRoadnav
- g++
- make

Windows Prerequisites:
- wxWindows 2.6.2 or newer
- LibRoadnav
- Microsoft SAPI 5.1 SDK
- Microsoft Visual C++ 2005

Linux installation is simply a matter of entering './configure' and 
'make install' at the command prompt. Windows users wanting to compile
Roadnav should refer to the Roadnav wiki since configuring the
development environment is somewhat involved. Precompiled packages are 
available for Windows, Mac OS X, Fedora, PCLinuxOS, and Debian from the 
Roadnav web site. Gentoo Ebuilds are available through the Gentoo 
portage system.

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

2. USAGE

Ensure you have an internet connection.  Execute the Roadnav program. Roadnav 
will automatically download many of the data files it needs.  Go into the
map menu and select "Set Address".  Enter an address in the United States. 
Roadnav will proceed to download the necessary files, and once it is done,
it will display a map centered on the requested address.  Zoom in or out
using the zoom in/out buttons in the main window.

Detailed documentation is available on the Roadnav web site.

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

3. LICENSING

Roadnav is licensed under version 2 of the GNU General Public License.
Please read the COPYING file for a complete copy of the license.

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

4. OTHER

Feature type abbreviation data extracted from the TIGER/Line documentation.

State name and abbreviation extracted from the FIPS web site.

Zip code mappings came from a dump of the US Census Bureau's 1999 ZIP code
database (http://www.census.gov/geo/www/tiger/zip1999.html).

TIGER/Line is a registered trademark of the U.S. Census Bureau

Roadnav uses the TinyXml XML parser, originally written be Lee Thomason.
TinyXml has been slightly modified to prevent it from reenabling some 
warnings under MSVC++.
