Difference between revisions of "IDE Window: Breakpoints"

From Free Pascal wiki
m (Important)
m
Line 1: Line 1:
{{IDE Window: Break Points}}
+
{{IDE Window:Break Points}}
  
 
<center>[[Image:Breakpoint_list.png]]</center>
 
<center>[[Image:Breakpoint_list.png]]</center>
Line 6: Line 6:
 
You must setup the debugger and start the project to debug it. Only then the breakpoints are useful.
 
You must setup the debugger and start the project to debug it. Only then the breakpoints are useful.
  
== State ==
+
== Dialog ==
 +
=== State ===
  
 
A breakpoint can be enabled or disabled. If it is enabled, then each time the program reaches the breakpoint, the condition is checked and if results true, the action(s) set for the breakpoint will be performed.
 
A breakpoint can be enabled or disabled. If it is enabled, then each time the program reaches the breakpoint, the condition is checked and if results true, the action(s) set for the breakpoint will be performed.
  
== Filename/Address ==
+
=== Filename/Address ===
  
 
Depending on the type of the breakpoint the following is displayed:
 
Depending on the type of the breakpoint the following is displayed:
Line 23: Line 24:
 
:The address of the variable (or memory location)
 
:The address of the variable (or memory location)
  
== Line/Length ==
+
=== Line/Length ===
  
 
Depending on the type of the breakpoint the following is displayed:
 
Depending on the type of the breakpoint the following is displayed:
Line 36: Line 37:
 
:The size of the variable watched
 
:The size of the variable watched
  
== Condition ==
+
=== Condition ===
  
 
Normally a reached breakpoint performs the break action(s). When a condition is defined, this condition is evaluated. If this condition evaluates to True, the break action(s) are performed.
 
Normally a reached breakpoint performs the break action(s). When a condition is defined, this condition is evaluated. If this condition evaluates to True, the break action(s) are performed.
  
== Action ==
+
=== Action ===
  
 
The following actions are available: Break, Enable/Disable group(s), Log message, Evaluate expression, Ignore/Handle Exceptions. A complete description of these actions can be found on the [[IDE Window:Breakpoint properties|Breakpoint properties]] page.
 
The following actions are available: Break, Enable/Disable group(s), Log message, Evaluate expression, Ignore/Handle Exceptions. A complete description of these actions can be found on the [[IDE Window:Breakpoint properties|Breakpoint properties]] page.
 
Only Break is currently implemented.
 
Only Break is currently implemented.
  
== Pass Count ==
+
=== Pass Count ===
  
 
How many times the enabled breakpoint has been reached. If a passcount is defined for this breakpoint, the debugger will  perform the break action(s) when this count is reached (not implemented yet)
 
How many times the enabled breakpoint has been reached. If a passcount is defined for this breakpoint, the debugger will  perform the break action(s) when this count is reached (not implemented yet)
  
== Group ==
+
=== Group ===
  
 
(not implemented)
 
(not implemented)
 
The group where this breakpoint belongs to. This allows to quickly enabled/disable several breakpoints at once.
 
The group where this breakpoint belongs to. This allows to quickly enabled/disable several breakpoints at once.
 +
 +
== Popup menu ==
 +
<center>[[Image:Breakpoint_list_popmenu.png]]</center>

Revision as of 00:39, 18 July 2006

Template:IDE Window:Break Points

Breakpoint list.png

Important

You must setup the debugger and start the project to debug it. Only then the breakpoints are useful.

Dialog

State

A breakpoint can be enabled or disabled. If it is enabled, then each time the program reaches the breakpoint, the condition is checked and if results true, the action(s) set for the breakpoint will be performed.

Filename/Address

Depending on the type of the breakpoint the following is displayed:

Source Breakpoint
The name of the file where the breakpoint is set.
Address Breakpoint
(not implemented)
The address of the breakpoint.
This type of breakpoint is usefull if there is no source available.
Data Breakpoint
(not implemented)
The address of the variable (or memory location)

Line/Length

Depending on the type of the breakpoint the following is displayed:

Source Breakpoint
The linenumber where the breakpoint is set.
If you edit the source, this position can change. For example, if you insert a line in front, the breakpoint will move. :But this has no effect the line numbers in the debugging information of the executable. It will still contain the old numbers. So, better stop debugging (i.e. stop the program) before editing.
Address Breakpoint
(not implemented)
(if supported by the choosen debugger) The adress range where the execution stops
Data Breakpoint
(not implemented)
The size of the variable watched

Condition

Normally a reached breakpoint performs the break action(s). When a condition is defined, this condition is evaluated. If this condition evaluates to True, the break action(s) are performed.

Action

The following actions are available: Break, Enable/Disable group(s), Log message, Evaluate expression, Ignore/Handle Exceptions. A complete description of these actions can be found on the Breakpoint properties page. Only Break is currently implemented.

Pass Count

How many times the enabled breakpoint has been reached. If a passcount is defined for this breakpoint, the debugger will perform the break action(s) when this count is reached (not implemented yet)

Group

(not implemented) The group where this breakpoint belongs to. This allows to quickly enabled/disable several breakpoints at once.

Popup menu

Breakpoint list popmenu.png