Prerequisites

1. Download and install the Java SDK version 5 or 6.
2. Download and install the Eclipse IDE forJava or Java EE.
3. Install the subclipse plugin for Eclipse to get code directly from the Subversion repository.

Getting the project from SVN

1. Launch Eclipse
2. Open the "SVN Repository Exploring" Perspective
3. Add a new SVN Repository
4. Enter the URL to the GedLynk SVN repository: https://gedlynk.svn.sourceforge.net/svnroot/gedlynk
5. Expand the trunk folder so that you see the three projects. You should see something similar to this image:
   
6. Right-click on the "JavaGedcom" project and select the "Checkout..." menu item.
7. In the check wizard, select the option to "Check out as a project configured using the New Project Wizard" and select the Head Revision. Your window should look similar to the image below:
   
8. Then click Finish to continue
9. In the New Project Wizard, select "Java Project" as the type of project to check out and click Next.
10. For the name of the project, enter"JavaGedcom" or the name of the SVN folder you are checking out. Again for the rest of the options, the default values should be sufficient.
11. Eclipse will then checkout the files and setup the project
12. Repeat steps 6-11 for the JavaFS-API project and the gedlynk project

Setup the Build Path

1. Next you need to update the build path for the JavaFS-API project
   1. Right-click on the JavaFS-API project and select the "Properties" option from the context menu
   2. From the list of options on the left select the "Java Build Path"
   3. From the Tabs on the right, select the projects tab and add the JavaGedcom project to it.
   4. Then from the Libraries tab click the"Add Jars" button and add the following jars from the project's lib directory:
      1. commons-codec-1.3.jar
      2. commons-httpclient-3.1.jar
      3. commons-logging-1.1.1.jar
   5. Click "OK" to finish.
   6. All of the compile errors should now be gone for the JavaFS-API project
2. Finally we need to update the build path for the gedlynk project
   1. Right-click on the "gedlynk" project and select the "Properties" option from the context menu
   2. From the list of options on the left select the "Java Build Path"
   3. From the Tabs on the right, select the projects tab and add the JavaGedcom project and the JavaFS-API project to it.
   4. Then from the Libraries tab click the"Add Jars" button and add the following jars from the project's lib directory:
      1. commons-codec-1.3.jar
      2. commons-httpclient-3.1.jar
      3. commons-logging-1.1.1.jar
      4. hsqldb.jar
      5. swing-worker-1.1.jar
      6. toplink-essentials.jar
   5. Click "OK" to finish.
   6. All of the compile errors should now be gone for the GedLynk project

Running the Projects

1. To run the example application for the JavaGedcom project
   1. Expand the edu.neumont.gedcom.example package
   2. Right click on the LoadExample.java file and select Run As->Java Application from the context menu
   3. This will launch the example project in the eclipse console
   4. You will be asked to enter a GEDCOM file to parse
   5. You will then be asked to enter the GEDCOM xref id of the record you would like to view details for
2. To run the example application for the JavaFS-API project
   1. Expand the edu.neumont.fsapi.sample package
   2. Right-click on the PersonRead.jave file and select Run As->Java Application from the context menu
   3. This will launch the example project in the eclipse console
   4. You will be asked to login to the FamilySearch reference system
   5. You will then be prompted to follow the menu items to search and display information from new FamilySearch
3. To run GedLynk
   1. Expand the edu.neumont.gedlynk.control package
   2. Right-click on the Controller.java file and elect Run As->Java Application from the context menu
   3. You should see the GedLynk splash screen and be taken to through the first run wizard.