svn commit: r1102279 - /incubator/wookie/site/trunk/content/wookie/docs/develop.mdtext

[rg...@apache.org]

Author: rgardler
Date: Thu May 12 13:11:12 2011
New Revision: 1102279

URL: http://svn.apache.org/viewvc?rev=1102279&view=rev
Log:
Add Eclipse info

Modified:
    incubator/wookie/site/trunk/content/wookie/docs/develop.mdtext

Modified: incubator/wookie/site/trunk/content/wookie/docs/develop.mdtext
URL: http://svn.apache.org/viewvc/incubator/wookie/site/trunk/content/wookie/docs/develop.mdtext?rev=1102279&r1=1102278&r2=1102279&view=diff
==============================================================================
--- incubator/wookie/site/trunk/content/wookie/docs/develop.mdtext (original)
+++ incubator/wookie/site/trunk/content/wookie/docs/develop.mdtext Thu May 12 13:11:12 2011
@@ -37,6 +37,15 @@ On Linux based systems this is in ~/.sub
 
 On Windows this is normally found at C:\Documents and Settings\{username}\Application Data\Subversion\config
 
+## Debugging
+
+You can start Wookie in debug mode using JDSPA with the following command:
+
+
+    ant -Djvmargs="-Xdebug -Xrunjdwp:transport=dt_socket,address=8001,server=y,suspend=n" clean-db run
+
+Once Wookie is running in debug mode you need to connect to it using your chosen debugger.
+
 ## Eclipse
 
 This section describes specific configuration for using Eclipse to develop Wookie.
@@ -47,14 +56,42 @@ We use Apache Ivy for dependency managem
 
 ### Subclipse
 
-[Subclipse is an Eclipse plugin that allows you to use Subversoin easily. Install it from the Subclipse update site](http://subclipse.tigris.org/update_1.6.x).
+Subclipse is an Eclipse plugin that allows you to use Subversoin easily. Install it from the Subclipse [update site](http://subclipse.tigris.org/update_1.6.x).
+
+### Code Style and Templates
 
-### Code Style
+In Eclipse:
 
-In Eclipse choose Window -> Preferences -> Java -> Code Style -> Formatter. Select "Import" and choose the file in 
+  - choose Window -> Preferences -> Java -> Code Style -> Formatter. Select "Import" and choose the file in 
 /etc/eclipse/code_style.xml
+  - choose Window -> Preferences -> Java -> Code Style -> Templates. Select "Import" and choose the file in 
+/etc/eclipse/code_templates.xml
+
+### Debugging in Eclipse
+
+To connect Eclipse to Wookie running in debug mode on your local machine you would:
+
+    Run -> Debug Configurations...
+
+Select "Remote Java Application"
+
+Click "New Launch Configuration"
+
+Set as follows:
+
+    Name: Wookie Debug (Localhost)
+    Project: Click "Browse" and select your Wookie project
+    PORT: 8001
+
+Now click the "Debug" button (note you must be running Wookie in debug mode, 
+see above, first).
+
+You can now set breakpoints etc. as if you were running from within Eclipse.
+
+Once you have set up this "debug configuration" you can quickly access it from 
+your debug menu.
 
-### Code Templates
+For more on remote debugging with Eclipse see the [Eclipse documentation](http://www.eclipsezone.com/eclipse/forums/t53459.html)
 
 ## Miscellaneous