= Installing Descent =

First [http://www.eclipse.org/downloads/ download Eclipse] >= 3.4

You can choose any of the Eclipse versions listed. "Eclipse IDE for C/C++ Developers" is recommended since it's the ligther of the downloads. You can also [http://download.eclipse.org/eclipse/downloads/drops/R-3.5.1-200909170800/index.php download a bare Eclipse platform] (under "Platform runtime binary") which is even lighter.

'''Very Important:''' you will need Java 1.5 or greater.

 1. Run Eclipse. (as root to install system wide)
 1. Goto "Help -> Software updates -> Find and install..." and click Next.
 1. Select "Search for new features to install" and click Next.
 1. Click "New remote site...".
 1. Enter "Descent" in the name field.
 1. Enter "http://downloads.dsource.org/projects/descent/update-site" in the URL field.
 1. Click Ok.
 1. Click Finish.
 1. From here, check all the checkboxes found, and click Next.
 1. Accept the license agreement and click Next, and then finish.
 1. Make sure you [wiki:Configuring configure] the plugin properly after the installation finishes.

After the plugin installs, restart Eclipse.

Another alternative is to [http://downloads.dsource.org/projects/descent/update-site/descent.0.5.6.20091119.zip download a zip file containing the plugins and features directories] and doing and [http://www.venukb.com/2006/08/20/install-eclipse-plugins-the-easy-way/ offline installation].

Go to "File -> New -> Project". In the "D" category select "D Project", enter it's location and hit OK. 

= Installing Eclipse under Ubuntu 8.04 =

'''Useful links:'''
https://help.ubuntu.com/community/EclipseIDE

First, enable Universe and Multiverse repositories. See [https://help.ubuntu.com/community/Repositories/Ubuntu here] how to do it.

Install necessary packages
{{{
sudo apt-get install sun-java6-jdk eclipse
}}}

To make Eclipse to always run under Sun's JVM, edit the '''/etc/eclipse/java_home''' file so that the path to the Sun's JVM is at the top of the list
{{{
sudo vi /etc/eclipse/java_home
}}}

Then, install and configure Descent as described above

'''Note:''' due to this [https://bugs.launchpad.net/ubuntu/+source/eclipse/+bug/83779 bug], contents of '''/usr/lib/eclipse/eclipse.ini''' is not taken into consideration during Eclipse launch. If you see !OutOfMemory exceptions and want to increase amount of memory allocated to Eclipse, either pass appropriate parameters to eclipse in command line, or create file '''/home/<user>/.eclipse/eclipserc''' with just one line in it:
{{{
VMARGS="-Xms40m -Xmx512m -XX:PermSize=128M -XX:MaxPermSize=256M"
}}}

Other users have reported !OutOfMemory errors even with these settings. If you have sufficient RAM, you might want to use these instead:
{{{
VMARGS="-Xms128m -Xmx2048m"
}}}