akdebugger Files

Installation
=============
Install the plug-in jars net.sf.akdebugger.core_1.0.4.v20110716.jar and 
net.sf.akdebugger.ui_1.0.4.v20110716.jar in the Eclipse 3.6 plug-in directory (i.e. eclipse/plugins).
Delete old version.

Content Assist 
=============
You must use the keyboard shortcut Ctrl + Space in the editor window to enable it. The resulting dialog provides you with context sensitive coding help by making available a listing of all applicable lua code elements for the top stack frame. "Content Assist" shows the functions for the tables if the combination was put after chars "." or ":". "Content Assist" only works in debug mode. 
Changes made in the text in the debug mode will only apply in the next debug session. 


Configuration
=============

Setup debugging for "Standalone Lua" and "Embedded Lua"
******************************************************

1) Make a project
File -> New -> Project
will pop up a New Project wizard. Click next and in the "Project name" text 
box enter you project name. For this example, it will be "newProj". The "Use 
default location" check box should be checked. Click next again. Since this 
example will not reference any projects, click Finish.

2) Create a lua file
File -> New -> File

3) Set up a debug launch configuration
Run -> Debug Configurations -> Lua VM...
There are 6 fields to set here
a) "Program:" - Path in workspace of Eclipse to the Lua program to debug.
b) Debugging type: "Embedded Lua" 
	How to start if selected:
	1. Switch to The Debug perspective.
	2. Insert auto-generated string in Lua file.
	3. Start the debugging session (File that was specified above, will be created).
	4. Launch application with embedded Lua.
c) Debugging type: "Standalone Lua"
	"Interpreter of Lua" - The location of the lua.exe
d) "Use LuaSocket"
e) "LuaSocket port"
f) "Search for unused port"

Then debug the Lua application just as you would any application in Eclipse.

If the workspace has Lua files with identical names, 
it is sometimes necessary to use the context menu command: 
"Binding of this file to the selected stack frame Lua".


Setup debugging for Corona SDK on Windows (not tested on Mac)
*************************************************************

1) Make a project File -> New -> Project will pop up a New Project wizard. Click next and in the "Project name" text box enter you project name. For this example, it will be "Corona SDK". The "Use default location" check box should be checked. Click next again. Since this example will not reference any projects, click Finish.

2) Create a link to a folder in the menu File / New / Folder, enable "Link to folder in the file system" and select the folder "X:\Corona SDK\Sample Code".

3) Set up a debug launch configuration
3.1) "Program:" - Select the Lua file in workspace of Eclipse to debug.
3.2) "Debugging type:" - Select "Corona SDK on Windows"
3.3) "LuaSocket host:" - It is the computer on which the Eclipse debugger is running. (localhost is default). Lua program can run on another computer.
3.4) "LuaSocket port:" 8000 is default
3.5) "Stop on startup" - selected is default.
3.6) Press "Apply" button

4) Insert the string:

require("__________DEBUGGER_SCRIPT")

in the Lua file selected to in 3.1).

5) Start debugging in Eclipse.

6) Switch to The Debug perspective.

7) Open in Corona Simulator the Lua file selected to in 3.1).


Setup debugging for PSP
*************************************************************

1) Make a project File -> New -> Project will pop up a New Project wizard. Click next and in the "Project name" text box enter you project name. For this example, it will be "PSP". The "Use default location" check box should be checked. Click next again. Since this example will not reference any projects, click Finish.

2) Copy PGE Lua to c:\usbhost\pgelua 

3) Create a link to a folder in the menu File / New / Folder, enable "Link to folder in the file system" and select the folder "c:\usbhost\pgelua".

4) Set up a debug launch configuration
4.1) "Program:" - Select "script.lua" in workspace of Eclipse to debug.
4.2) "Debugging type:" - Select "PSP"
4.3) "Stop on startup" - selected is default.
4.4) Press "Apply" button

5) Insert the string:

require("__________DEBUGGER_SCRIPT")

in the Lua file selected to in 4.1).

6) Run "usbhostfs.exe c:\usbhost"

7) In IR-Shell (Version 5.2) to enable "Toggle USBHost Redirection".

8) Start debugging in Eclipse.

9) Switch to The Debug perspective.

10) In IR-Shell go into the folder "usbhosts0:/pgelua" and start EBOOT.PBP.

11) Click "Select Lua Source" and select the appropriate file script.lua.

12) Due to the fact that all the scripts have the same name "script.lua" for each script in the beginning of his debugging you need to use the context menu - "Binding of this file to the selected stack frame Lua".

13) Unable to debug usb function.


Main Changes by Version
=======================
  1.0.0  
  * Initial release of 1.0.0 version 
  1.0.1  
  * Added parser (luaj - http://luaj.sourceforge.net/). 
  * Added Expressions window. 
  * Added Outline window.
  1.0.2  
  * Added support for Corona SDK on Windows. 
  1.0.3  
  * Added support for PSP.
  * Fixed bugs.
  1.0.4  
  * Added support for Content Assist.