Descend

Descend is a proof of concept, showing the possibilities of creating an open source debugger UI with Mozilla XULRunner. Descend is distributed under the MPL/GPL/LGPL tri-license.

Getting Started

The Descend source code is available in a Mercurial repository. Mercurial can be downloaded from [1]. Windows users may find TortoiseHG useful.

Descend currently does not contain a local copy of XULRunner (and may never have one; It would be best to use a globally available XULRunner). You can use the XULRunner bundled with Firefox 3.x to run XULRunner.

Setup Your Mercurial Client

At the mimimum, you should configure your Mercurial client with a "username". For hg, add the following to your ~/.hgrc file (or create a new one)

 [ui]
 username = Real Name <[email protected]>

Development

Clone the Source Repository

Create a local repository with the following command:

 $ hg clone http://hg.kodewerx.org/descend

This will create a new subdirectory called "descend" containing all of the source code and repository history.

Push Changesets to hgkw

If you have developer access to push changesets to the hgkw repository, use the following commands:

 $ hg push http://hg.kodewerx.org/descend
 $ hg commit http://hg.kodewerx.org/descend -m "My commit message"

Running Descend

On Linux, run the included descend_linux shell script. (Tested on Ubuntu 8.10)

On Mac OS X, run the included descend_osx shell script.

On Windows, go to Start -> Run, and type:

 firefox --app "path/to/descend"

You can also create a batch script to do the same thing.