Difference between revisions of "Debug Tab"

Revision as of 12:45, 17 January 2018

Under Construction

The App Inspector

The App Inspector is your best friend during development as it provides a complete overview of your App.

It is organized into Tabs. Each Tab is relevant to a particular workspace. You can double click a Tab to detach it into its own floating window.

Clicking the small icon on the far right of the App Inspector title bar will detach it into its own floating window.

Double clicking the window title bar when it is floating will attach it back into place.

The Debug Tab

The Debug Tab contains the Lianja/VFP Debugger. The tabbed upper container contains an output panel and the files currently loaded in the Debugger. The lower tabbed container contains the following:

Command Window
Breakpoints Grid
Watches Grid
Call Stack Grid
Errors Window
Log Window

Below these are a message line showing the current operation and an actionbar.

Activating the Debugger

As with all App Inspector tabs, the Debug Tab can be selected by clicking on its tab and double-clicking on the tab undocks it into its own floating window.

It can also be opened in the following ways:

Clicking on Debug in the Modebar (opens the Debug Tab undocked).
Automatically, when a running program issues the debugger command.
Issuing the command debug <filename> or debugger <filename> in the Lianja/VFP Command Window (Console Tab, Console Workspace or Command Window).

Loading Files in the Debugger

Programs containing the debugger command or specified with the debug <prg-filename> or debugger <prg-filename> commands are automatically loaded into the debugger when the command is issued.

Programs can also be loaded from the Apps Workspace. Open the file (double-click the filename) in the Script Editor then click the Open file in Debugger toolbutton.

Select the Debug Tab or click Debug in the Modebar to debug the file.

Called programs are automatically loaded when referenced by a program being debugged and 'Step Into' is clicked.

Breakpoints

Watches

Call Stack

Errors

Log

Actionbar

Action	Description
Run/Continue	Run or continue running the program to the next breakpoint or watch point or to the end if no breakpoints or watch points are set.
Stop	Stop debugging.
Edit Code	Put the currently selected file into edit mode.
Save Code	Displayed when edit mode (Edit Code above) has been selected. Click to save any changes and exit edit mode.
Revert Code	Displayed when edit mode (Edit Code above) has been selected. Click to cancel any changes and exit edit mode.
Refresh all files	Refresh all files in the debugger. This will update them with any changes made using the Script Editor in the Apps Workspace or Library Workspace.
Step Over
Step Into
Step Out
Toggle Breakpoint
Toggle Watch
Remove All Breakpoints
Remove All Watches
List Status	Lists the current data environment in the Output window.
List Memory	Lists the current memory variables in the Output window.
List Structure	Lists the structure of the currently selected table or cursor in the Output window.

Dock Tab

To dock the tab back in the App Inspector, click the [x] or double-click the window title bar.

@@ Line 68: / Line 68: @@
 |-
 |valign="top"|Edit Code
-|valign="top"|
+|valign="top"|Put the currently selected file into edit mode.
 |-
 |valign="top"|Save Code
-|valign="top"|
+|valign="top"|Displayed when edit mode ('''Edit Code''' above) has been selected.  Click to save any changes and exit edit mode.
 |-
 |valign="top"|Revert Code
-|valign="top"|
+|valign="top"|Displayed when edit mode ('''Edit Code''' above) has been selected.  Click to cancel any changes and exit edit mode.
 |-
 |valign="top"|Refresh all files
-|valign="top"|
+|valign="top"|Refresh all files in the debugger.  This will update them with any changes made using the [[Script Editor]] in the [[Apps Workspace]] or [[Library Workspace]].
 |-
 |valign="top"|Step Over