Tellervo Manual

Once installed, you can then launch Eclipse. To access the Tellervo source code you will need to install the

Subversive plugin to Eclipse. As of Eclipse v3.5 this can be done by going to Help : Install new software.

Select the main Update site in the `Work with' box, then locate the `Subversive SVN Team Provider' plugin

under `Collaboration'. If you are using an earlier version of Eclipse you may need to add a specic Subversive

update site. See the Subversive website (http://www.eclipse.org/subversive/) for more details. Once

installed you will need to restart Eclipse.

Next you will need to install the m2e Maven plugin to Eclipse. This can also be installed by going to Help

: Install new software, however, you may need to add the Maven update site as this plugin is not currently

available in the main Eclipse repository. You can do this by click the `Add' button and using the URL http:

//m2eclipse.sonatype.org/sites/m2e. Once again you will need to restart Eclipse before continuing.

Next you need to get the Tellervo source code. Go to File New : Project, then in the dialog select SVN :

Project from SVN. There are two methods of accessing the Tellervo repository: anonymously (in which case

you will have read only access); or with a username provided by the Tellervo development team. Anonymous

users will need to add a repository in the form: svn://svn.code.sf.net/p/tellervo/code-0/trunk and

full users will need to use svn+ssh://svn.code.sf.net/p/tellervo/code-0/trunk.

Once the project has downloaded to your workspace, you may need to set the compliance level. This can be

done by going to Project : Properties : Java compiler and choosing compliance level of 6.0. Tellervo uses a

handful of Java 6 specic functions, particularly with regards JAXB, so will not run successfully with Java 5.

To launch Tellervo, you will need to Run : Run Java application. Create a new run conguration with the

main class set to `org.tellervo.desktop.gui.Startup'.

13.3 Dependencies

As of June 2011, Maven is used to build Tellervo rather than the original Ant. One of the main benets of

Maven is that it handles dependencies much more dynamically than Ant. This has become more of an issue

as the Tellervo project as grown, as it is now dependent on over 80 dierent open source libraries.

In an ideal world, any libraries that your code is dependent on should be available in central Maven repositories

and downloaded and installed seamlessly as part of the build process. Maven should also handle transient

dependencies (i.e. dependencies of dependencies) automatically. Therefore if a developer knows he needs the

functions within a particular library, he simply needs to supply the details of this library without having to

worry about the other libraries that this new library is in turn dependent on. Maven also manages versions

...