EclipseFP The Haskell plug-in for Eclipse

Home

Features

Installation

FAQ

Development

---

EclipseFP is done of three main components:

• BuildWrapper is a Haskell library and executable that wraps the GHC API and the Cabal executable to provide the functionality needed for IDEs.
• EclipseFP itself is a set of Eclipse plug-ins programmed mostly in Java. The development was started by Leif Frenzel, with contributions of (in alphabetical order) Andrei de A. Formiga, Thiago Arrais, Scott Michel, JP Moresmau, Alejandro Serrano (during his 2011 Google Summer of Code), and B. Thomas ten Cate (during his 2009 Google Summer of Code). JP Moresmau is the current maintainer.
• Scion Browser is a Haskell library that reads Hoogle documentation files for installed packaged and provides a way to navigate them. This component is mostly work of Alejandro Serrano.

The code is hosted in GitHub:

• BuildWrapper: https://github.com/JPMoresmau/BuildWrapper
• EclipseFP: https://github.com/JPMoresmau/eclipsefp
• Scion Browser: https://github.com/JPMoresmau/scion-class-browser

but the mailing list is hosted in the old site in SourceForge.

Building from source

As usual, this assumes that you have GHC, cabal-install, and Git. This should work on all platforms.

1. Get Eclipse, the distribution named Eclipse Classic. Extraction equals installation.
2. You need to install the BIRT Charting Engine to be able to build EclipseFP. The update site is http://download.eclipse.org/birt/update-site/3.7 for Eclipse 3.7 (Indigo). For Eclipse 4.2, install the BIRT Engine OSGi Runtime SDK Feature from http://download.eclipse.org/birt/update-site/4.2.
3. Get the BuildWrapper source: git clone git://github.com/JPMoresmau/BuildWrapper.git
   
4. Build and install BuildWrapper, (it will install both the library as well as the exectuable program):
   cd BuildWrapper
cabal install

5. Get the EclipseFP source: git clone git://github.com/JPMoresmau/eclipsefp.git
6. Import all Eclipse projects from these repositories into Eclipse.
7. Build all projects or set your workspace to automatically build all projects for you
8. Hit Run > Run Configurations. Add a new launch Eclipse Application launch configuration. The default settings for this launch configuration should work, so just click Run.
9. In the new Eclipse window that (hopefully) pops up, check the location of the BuildWrapper executable via Window > Preferences > Haskell > Helper Executables. You may want to use the location of a locally built version of BuildWrapper if you've made changes to it.
10. If something doesn't work, turn on tracing. In the Run Configurations dialog, on the Tracing tab, you can enable tracing options for various plug-ins. These will output to the Console at the bottom of the host Eclipse window. Also in preferences turn on debug mode for BuildWrapper, that will show you the output from BuildWrapper.