Eclipse Plugin

#summary Overview, building and installing.

= Introduction =

The Seco Eclipse Plugin(seco.eclipse.plugin) is a Seco extension which is capable to run as a plug-in under Eclipse. It aims to retain all the original Seco functionality and to provide tighter interoperability with the leading open-source IDE, which will greatly benefit both environments.

== Feature Summary ==

• All the Seco functionality
• Go to Declaration (F3) similiar to Eclipse command
• Predefined scripting variables: "workspace", "plugin"
• Execution in the Eclipse JVM, which give access to all the Eclipse internals

== Downloading and Installing Seco Eclipse Plugin ==

All official release packages are located at the [http://code.google.com/p/seco/downloads/list Google Code downloads area].

Seco Eclipse Plugin releases are distributed in compressed archive files (.tar.gz for Unix platforms and .zip for Windows). To install a distribution, just unzip the archive into a directory of your own choosing. Then read the instructions below on how to use it.

== Distribution Archive Content ==

The unzipped archive has typical Eclipse Plug-in structure and contains the following:

|| site.xml || Description file used for the legacy Eclipse Update Site. || || features/ || Directory with the features. || || plugins/ || Directory with the pluginss. ||

== Installing Seco Eclipse Plugin==

Eclipse support few different types of plug-in installation, but unfortunately most of them prove to be very unreliable as of time of this writing. The only method that works (tested under Eclipse 3.4.X, 3.5.X and 3.6.X) is the so called "link file". Here's a step-by-step description.

• Unzip the archive in a dir: c:/seco_plugin/eclipse. You should have the following dir structure: seco_plugin --eclipse ----features ----plugins

• Create a txt file containing the following line: path= c:/seco_plugin

• Save this file as seco.link in <eclipse.home>/dropins dir, where <eclipse.home> is the root of your Eclipse installation.

• Start Eclipse and you should see the Seco icon in the Eclipse toolbar.

== Building from Source Code ==

The Seco Eclipse Plugin source code resides in the [http://code.google.com/p/seco/source/checkout Subversion repository] and it's part of the Seco source tree, under the directory eclipse_plugin.

== Compiling the Source ==

Seco Eclipse Plugin uses the [http://ant.apache.org ANT build system]. You can compile, build and zip the distribution with the top-level ant script. The only prerequisite is the value of the "eclipse_plugins_dir" property, which should point to <eclipse.home>/plugins dir, where <eclipse.home> is the root of your Eclipse installation.

The following table describes the three targets used to build Seco Eclipse Plugin for deployment:

|| Target || Result || Contents || || headless_plugin_export || dist dir || Creates the directory with all the needed jars. || || dist-zip || seco.eclipse.plugin_1.0.0.zip || Creates zipped distribution. || || dist-tar.gz || seco.eclipse.plugin_1.0.0.tar.gz || Creates tar-gzipped distribution. ||

Tip: Use the command ant -p to list all available targets for a project script.