====================================================
Utilisation d'un outil externe d'édition des scripts
====================================================

Ce document montre comment éditer les scripts (Java) avec un editeur
externe. Dans ce document nous nous baserons sur l'éditeur Eclipse mais tout
autre éditeur fonctionne.


Pré-requis
==========

Il faut avoir les programmes suivant installés et fonctionnels:

- Une connection Internet durant l'utilisation de maven
- Eclipse http://www.eclipse.org
- Maven http://maven.apache.org


Création d'un projet Eclipse
============================

Grâce à Maven nous allons pouvoir créer les fichiers nécessaires à un
projet Eclipse.

Dans votre répertoire de data (sans doute $HOME/isis-database-3) lancer la
commande::

  mvn eclipse:eclipse


Import du projet dans Eclipse
=============================

- Allez dans le menu File->Import...
- Sélectionnez General/Existing Projects into Workspace
- Sélectionnez le répertoire de data
- Cliquez sur Finish

TODO decrire la selection des sources

Lancement d'isis
================

Il faut maintenant lancer isis avec l'option debug en premier argument::

  # sous Unix
  ./go.sh debug
  # sous Windows
  go.bat debug


Debuggage dans Eclipse
======================

- Allez dans le menu Run->Debug...
- Cliquez avec le bouton droit sur "Remote Java Application"
- Cliquez sur New

Dans l'onglet Connect:

- Donnez un nom pour le projet: isis-fish
- Modifier le port pour le mettre à 38000

Dans l'onglet Source

- Ajouter le nouveau projet

Maintenant cliqué sur Debug en bas de la fenêtre, Eclipse doit se connecter
à Isis. Il vous faut maintenant poser des points d'arret dans votre code
pour qu'Eclipse arrete l'execution et que vous puissiez faire du pas a pas à
partir de ces lignes.