= Welcome to Descent =

Descent is an [http://www.eclipse.org Eclipse] plugin that provides an IDE for writing, launching and debugging code in the [http://www.digitalmars.com/d/ D programming language] from Digital Mars.

== Documentation ==

 * [wiki:Installing Installing the plugin]
 * [wiki:Updating Updating the plugin]
 * '''[wiki:Configuring Configuring the plugin]'''
 * [wiki:ConfiguringProject Configuring a project]
 * [wiki:CompilingPrograms Compiling programs]
 * [wiki:RunningPrograms Running programs]
 * [wiki:DebuggingPrograms Debugging programs]

Descent tries to mimic [http://www.eclipse.org/jdt/ JDT], so it's documentation may be useful, although not all of it: http://help.eclipse.org/help32/topic/org.eclipse.jdt.doc.user/gettingStarted/qs-BasicTutorial.htm

Also check out [http://www.dsource.org/forums/viewforum.php?f=107 The Forum].

== Features ==

 * Syntax highlighting.
 * Awesome, flexible formatter.
 * Folding.
 * Automatic closing of strings, brackets, chars and comments.
 * Code templates.
 * Syntax errors and some semantic errors are shown with a reg squiggle.
 * Autocompletion which writes the imports for you.
 * Source on hover (shift+hover).
 * Go to definition (ctrl+hover).
 * Some compile-time function evaluation (ctrl+shift+hover).
 * Greying of inactive code.
 * Project Explorer.
 * Outline view.
 * Automatic generation of documentation comments (Params, Author, etc.).
 * Spell checking.
 * TODO tasks.
 * Ddoc view.
 * Declaration (source) view.
 * Highlighting of all occurrences of the current token under the cursor.
 * trace.log viewer
 * Runs and debugs programs within the IDE.

[wiki:Shortcuts Here's a list of useful shortcuts, hovers and autocompletions]

== Supported versions ==

D 1.x is fully supported.

D 2.x is not supported: you may be able to open the file, but you'll get syntax errors for enum manifest constants and invariant as attribute.

== Nightly Builds ==

You can download the most recent copy of Descent in [http://dsource.org/projects/descent/browser/downloads/nightly-builds here]. You need to replace any Descent feature and plugin from Eclipse with these.

Nightly builds are provided to test the latest features and bug fixes. If you submit a bug report and it is marked as fixed with a comment saying "fixed in trunk", please verify that it is indeed fixed by downloading the latest nightly build. The date of the build is indicated in the plugins: check that is it greater than the date the bug was fixed.

 * [wiki:UsingNightlyBuildsUnderWindows Using nightly builds under Windows (XP / Vista)]

== Future Directions ==

Now we are focusing in:

 * Making the build system.
 * Unittesting à la JUnit.

== Help us ==

As always with such an ambitious project, we need help! We're looking for testers, documentation writers, translators, and most of all developers. If you're interested in helping out, check [wiki:Development this].

== Contact Us ==

Here's where to reach those responsible for Descent:
 * [http://www.dsource.org/forums/viewforum.php?f=107 The Forum]
 * Via #d.descent at irc.freenode.org
 * Create tickets for suggestions, improvements, and things that don't work correctly