What is RouteConverter?
=======================

RouteConverter is a popular open source tool to display, edit, enrich and convert routes, tracks and
waypoints licensed under the GNU Public License. See http://www.routeconverter.com/about/ for details
about features, supported formats and languages, screenshots, frequently asked questions and how you
can help.

Downloads
=========

Stable releases are available at http://www.routeconverter.com/releases/
Prereleases are frequently offered at http://www.routeconverter.com/prereleases/

If you want to contribute
=========================

Patches and pull requests are always welcome. If you minimize your diff, it's more likely that your
contribution will be applied to the code base. Please stick to the code standards and formatting
that you run across. And don't forget to add tests for your changes ;-)

CONTRIBUTORS.txt provides a list of the people who helped developing RouteConverter.

How to develop for RouteConverter
=================================

1. Install a recent Java 6 SDK from http://www.oracle.com/technetwork/java/javase/downloads/

2. Install Maven 3 from http://maven.apache.org/download.html

3. Clone RouteConverter from github:
   > git clone git@github.com:cpesch/RouteConverter.git

4. Open RouteConverter sources in an Integrated Development Environment (IDE)

   Install IntellijIDEA Community Edition from http://www.jetbrains.com/idea/download/
   Choose "File/Open Project..." and the root pom.xml.

   Install Eclipse IDE for Java Developers from http://www.eclipse.org/downloads/
   Install m2eclipse from http://m2eclipse.sonatype.org/sites/m2e
   Choose "File/Import..." and "General/Maven Projects" and the root directory.

5. Build RouteConverter

   Let JAVA_HOME refer to the Java 6 SDK
   > set JAVA_HOME=c:\Programme\Java\jdk1.6.0_23
   Put Maven into your PATH and call
   > mvn clean package

6. Run RouteConverter
   > java -jar RouteConverterCmdLine/target/RouteConverterCmdLine.jar
   > java -jar RouteConverterLinux/target/RouteConverterLinux.jar
   > java -jar RouteConverterLinux64/target/RouteConverterLinux64.jar
   > java -jar RouteConverterMac/target/RouteConverterMac.jar
   > java -jar RouteConverterMac64/target/RouteConverterMac64.jar
   > java -jar RouteConverterWindows/target/RouteConverterWindows.jar
   > java -jar RouteConverterWindows64/target/RouteConverterWindows64.jar

Have fun!
Christian