This page will teach you how to set Eclipse IDE to work on the latest source of GIMP from git.
- 1 About Eclipse
- 2 Preparations
- 3 Working with Eclipse
- 4 Miscellanous
- 5 Problems and solutions
Why use Eclipse to work on Babl, GEGL and GIMP?
Some of the features that are interesting for C/C++ developers are:
- cross-referencing: Ctrl click an identifier and it will take you to its definition,
- call hierarchy,
- comprehensive search capabilities,
- built in Git support,
- Autotools integration,
- graphical debugger,
- explore remote systems from within Eclipse,
- focus on the current task,
- Bugzilla integration,
- static code analysis.
and more. Eclipse runs on every platform that can run Java and has a graphical interface.
It is actively developed and maintained from a living community, see the Eclipse community forums.
Why not to use Eclipse to work on Babl, GEGL and GIMP?
Because it's not Emacs :-P
Eclipse is slow.
The following steps describe the process for Eclipse 4.3 'Kepler' on Linux. It is assumed that your workspace for all projects is /home/user/workspace and GIMP will be installed in /home/user/prefix/gimp.
The continuous example uses Babl, because it is small and easy for a start. Where necessary the tutorial describes the differences for GEGL and GIMP.
Prepare the build environment
clone the Babl Git repository into your workspace:
- cd /home/user/workspace
- git clone git://git.gnome.org/Babl
To the same for GEGL and GIMP.
The easiest way is simply to download Eclipse IDE for C/C++ Developers). If you already have a working Eclipse installation and want to upgrade it, then download the following plug-ins:
- CDT (for C/C++ development),
- Web Developer Tools (to edit HTML, XML and XSL),
- EGit (for Git integration),
- Subversive (for Subversion integration),
- Mylyn Task List (for Bugzilla integration and task focused working),
- Remote Systems Explorer (to manage files, search, execute commands and debug on remote systems).
Configure Eclipse to work on Babl, GEGL and GIMP
- Open the C/C++ perspective.
- Create the project: File/New/Makefile Project with Existing Code:
- Leave the field 'Project Name' empty. It will be filled in the next step.
- Click 'Browse' behind 'Existing Code Location' and select /home/user/workspace/babl.
- Languages: C (for GEGL also C++).
- Toolchain for Indexer settings: GNU Autotools Toolchain
- Tell Eclipse that it is an Autotools project, so you can build in Eclipse:
- Right click on the project
- From the context menu select New/Convert to a C/C++ Autotools project
- Candidates for conversion: babl; Convert to C or C++: C
- For Babl you're done, press 'Finish'. Otherwise hit 'Next' button two times.
- Referenced C/C++ projects: For GEGL: babl, For GIMP: babl and gegl
- Open the 'Git Repository Exploring' perspective.
- Open the 'Git Repositories' view.
- Add an existing local Git repositoriy to this view by clicking the button with this tooltip:
- Directory: Browse, select /home/user/workspace/babl.
- Make sure that Babl is checked in the search results list.
- Open the C/C++ perspective.
- Right click on the Babl project, select 'Team/Share Project...':
- Repository type: Git
- select repository: the Babl Git repository
It is important to have created the Git repository before connecting to it from Eclipse. Eclipse refuses trying to create the repository in Babl's workspace folder, so we have to keep this order.
Configure build environment
Configure Eclipse to work with XML files
XML files appear either obviously with the extension .xml, but also a some more file formats are based on XML. With Eclipse's XML plug-in you can edit the raw source code, but also work the XML tree structure of an XML file. The following files are known to be XML files:
- *.bundle Configuration files for gtk-mac-bundler
- *.modules Configuration files for JHBuild
- *.svg Vector graphics files
- *.plist OS X application metadata
- *.xml DocBook documents, D-Bus service configuration, menu descriptors, the authors list etc.
To be able to edit XML files as such:
- Open 'Help/Install new software...'. Install the plug-in XML Editors and Tools. If you want to edit XSL files, also install the XSL Developer Tools.
- Open 'Window/Preferences'. Select 'General/Content Types'. Select 'Text' and then 'XML'. Press the 'Add' button and add then enter *.bundle. Repeat the last step also for *.modules, *.plist etc.
Working with Eclipse
Problems and solutions
See the Problems and Solutions page.