README_Eclipse_MacOSX.md

Installation of Eclipse (Kepler) on MacOSX, with plugins for SCons, Git, GitHub, and Python

Install Eclipse

There exists an Eclipse plugin for SCons, called SConsolidator. As of January, 2014, this plugin works only with the Kepler version of Eclipse. To download and install this version of Eclipse, go to:

Eclipse Kepler SR1 Downloads

and download the MacOSX (Cocoa 64) version. The file should be called:

eclipse-cpp-kepler-SR1-macosx-cocoa-x86_64.tar.gz

Unpack this somewhere in your own user space. I chose to install it directly underneath my home directory, but of course you can install it where you like.

$ cd
$ sudo tar -xvzf ~/Downloads/eclipse-cpp-kepler-SR1-macosx-cocoa-x86_64.tar.gz

Start up Eclipse from the command line with:

$ ~/eclipse/eclipse

You might also find it useful to add the Eclipse app to your dock, permanently, to make it easier to start up in the future.

When you start up Eclipse, you will get a window asking you to choose a workspace. The default is usually /Users/****/Documents/workspace. This is fine, but you might want to choose someplace else. Make sure to click the 'Use this as the default ...' radio button so that you will not get asked this every time.

When Eclipse finally starts up, you can click on the "X" on the welcome page, and it should take you to the Project Explorer page. This is the main view that you will probably end up using most of the time.

Install the SConsolidator Plugin

In order for Eclipse to work with SCons, one has to install a plugin called SConsolidator. To do this, do the following:

a) Go to Help->Install New Software

b) In the Install window that comes up, in the "Work with" field, enter:

http://www.sconsolidator.com/update

and click on "Add..."

c) Specify the name as "SConsolidator"