Author:admin

Date:2008-09-17T13:53:28.000000Z


git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@3 abb3cda0-5349-4a8f-a601-0c33ac3a8c38

documentation/current/eiffelstudio/eiffelstudio-reference/debugger/breakpoints/breakpoint-commands.wiki

@@ -0,0 +1,11 @@
+[[Property:title|Breakpoint commands]]
+[[Property:weight|2]]
+Located in the '''debug''' menu and the '''project''' toolbar, these three commands allow to change the state of set [[Breakpoints: Introduction|breakpoints]]  in the system. 
+
+Enable breakpoints (  [[Image:16x16--breakpoints-enable-icon]]  ), disable breakpoints (  [[Image:16x16--breakpoints-disable-icon]]  ) and remove breakpoints (  [[Image:breakpoints-delete-icon]]  ) have all global and local actions. Left-clicking on them has a global action: all set breakpoints of the system will be respectively enabled, disabled, or discarded. However, it is also possible to [[Pick-and-drop mechanism|drop]]  a feature or a class onto them, in which case only set breakpoints of the feature/class will be affected. 
+
+Note that these commands work only on set breakpoints (that is, enabled or disabled breakpoints). Therefore, discarded breakpoints cannot be set again thanks to these commands.
+
+
+
+

documentation/current/eiffelstudio/eiffelstudio-reference/debugger/breakpoints/breakpoint-editing.wiki

@@ -0,0 +1,62 @@
+[[Property:title|Breakpoint editing]]
+[[Property:weight|1]]
+In all flat views ( [[Feature formatters: Flat view|feature flat view]]  and [[Class formatters: Flat view|class flat view]] ), a margin is displayed on the left of the editor. [[Breakpoints: Introduction|Breakpoints]]  are there symbolized as circles, of a different appearance depending on their state: enabled (  [[Image:bp-enabled-icon]]  ), disabled (  [[Image:bp-disabled-icon]]  ) or not set (  [[Image:bp-slot-icon]]  ). A small question mark in the circle (  [[Image:bp-enabled-conditional-icon]] ,  [[Image:bp-disabled-conditional-icon]]  )indicates [[Breakpoint menu|conditional breakpoints]] . 
+
+Right-clicking on any breakpoint pops up a context menu:
+
+<center> [[Image:breakpoint-context-menu]]  </center>
+
+The first line provides the breakpoint slot index of the selected breakpoint(i.e: the one used in call stack or exception trace output). <br/>
+Clicking one of the three first entries of the context menu changes the state of the breakpoint that was right-clicked. The last entry ( '''Run to breakpoint''') launches the debugged application so that it will stop as soon as the selected breakpoint is encountered, as if the breakpoint had been enabled. <br/>
+
+
+"Edit This Breakpoint" allows the user to edit the parameters of the breakpoint (condition, hit count, when hits actions...) thanks to the breakpoint dialog. This dialog provides on hte first tab "Context": access to the associated tags, condition, and hit count control. And on the second tab, it allows to associate "When hits..." action(s) to the breakpoint. 
+<center>
+{| 
+|- 
+| 
+Context's tab
+ [[Image:breakpoint-dialog-context|Context's tab]]  
+| 
+When hits action 's tab
+ [[Image:breakpoint-dialog-when-hits-action|When hits... 's tab]]  
+|}
+</center>
+
+* The tags allow to identified a collection of breakpoints, either from the [[Breakpoint information command|breakpoints tool]] , or even in the parameters of "When hits .." actions. <br/>
+Note that any existing breakpoint can be referenced by an implicit tag with ''"'''bp:'''cluster.{CLASS}.feature@index"'' (cluster is not mandatory).<br/>
+
+{{sample|For instance "'''bp:'''elks.{LINKED_LIST}.extend@2"}}
+
+* the "Condition" allows the user to set a condition for stopping. 
+* the "Hit count" allows the user to set a condition on hitcount for stopping. 
+* And the "When Hits..." allows to associate specific actions to the breakpoint: 
+** Print message: display the expanded message to the output (there are predefined variables, and you can also evaluate expressions).
+** Disable/Restore Assertion Checking: this might be useful to desactivate assertion checking on a specific part of the execution.
+** Record Execution: start or stop the execution recording (cf: [[Execution record and replay|Execution recording and replay]] )
+** Enable/Disable Breakpoints: either use tags or implicit tags (ex: ''"bp:elks.{LINKED_LIST}.extend@2"''), to reference a set of existing breakpoints. This can be pretty useful to enable a breakpoint only if the execution takes a specific execution path.
+** Reset Hits count
+
+
+
+
+"Edit Condition" allows the user to set a condition for stopping, it opens the same dialog as "EditThis Breakpoint", but focus on the "condition" field. 
+
+<center> [[Image:breakpoint-dialog-condition]]  </center>
+
+"Hit count" allows the user to set a condition on hitcount for stopping 
+
+<center> [[Image:breakpoint-dialog-hit-count]]  </center>
+
+"When hits ..." allows the user to do an action when we actually stopped on this breakpoint. This can be for instance `print message'. 
+
+<center> [[Image:breakpoint-dialog-when-hits]]  </center>
+
+{{seealso| '''See Also''' <br/>
+[[Breakpoint commands|Breakpoint commands]]  <br/>
+[[Breakpoint information command|Breakpoint information command]]  <br/>
+}}
+
+
+
+

documentation/current/eiffelstudio/eiffelstudio-reference/debugger/breakpoints/breakpoint-information-command.wiki

@@ -0,0 +1,26 @@
+[[Property:title|Breakpoint information command]]
+[[Property:weight|3]]
+The breakpoint information command, located in the '''debug''' menu and in the '''project''' toolbar (  [[Image:tool-breakpoints-icon]]  ), displays the list of all set breakpoints in the system (enabled or disabled). 
+
+<center>Display all breakpoints in a grid<br/>
+ [[Image:breakpoints-list]]  </center>
+
+Note: the * shows that the breakpoint has a [[Breakpoint menu|condition]] .<br/>
+Note: you can edit the selected breakpoint by double clicking on it, or pressing [enter] which show the menu.<br/>
+Note: you can disable/enable the selected breakpoint(s) by pressing [space].<br/>
+Note: you can sort by clicking the column, especially the first column which provide tree, flat or sorted view. 
+
+<center>Display all breakpoints in a list<br/>
+ [[Image:breakpoints-list-flat]]  </center>
+
+<center>Display all breakpoints in a list filtered by a tag using button  [[Image:breakpoints-list-filter-button]]  <br/>
+ [[Image:breakpoints-list-filter]]  </center>
+
+{{seealso| '''See Also''' <br/>
+[[Breakpoint commands|Breakpoints commands]]  <br/>
+[[Breakpoint information command|Breakpoint information command]]  <br/>
+}}
+
+
+
+

documentation/current/eiffelstudio/eiffelstudio-reference/debugger/breakpoints/breakpoint-menu.wiki

@@ -0,0 +1,25 @@
+[[Property:title|Breakpoint menu]]
+[[Property:weight|4]]
+A condition breakpoint is a breakpoint in which debugger will stop if a certain condition is met. To set a conditional breakpoint use the [[Breakpoint editing|breakpoint menu]]  and choose `Set conditional breakpoint': 
+
+[[Image:breakpoint-context-menu]]  
+
+Once done a dialog pops up where you can enter a condition:
+
+[[Image:breakpoint-dialog-condition]]  
+
+The condition is a Boolean expression that follows the same rule as the expression you can enter in the [[Expression evaluation|expression evaluation tool]] . <br/>
+
+
+{{warning|'''Caution''': if you enter an expression that is not supported or which raises an error during evaluation, by default the condition is considered as True (then the debugger will stop) }}
+
+{{seealso| '''See Also''' <br/>
+[[Breakpoint editing|Breakpoint menu]]  <br/>
+[[Breakpoint commands|Breakpoints commands]]  <br/>
+[[Breakpoint information command|Breakpoint information command]]  <br/>
+[[Expression evaluation|Expression evaluation tool]]  <br/>
+}}
+
+
+
+

documentation/current/eiffelstudio/eiffelstudio-reference/debugger/breakpoints/index.wiki

@@ -0,0 +1,11 @@
+[[Property:title|Breakpoints]]
+[[Property:weight|-14]]
+*  [[Breakpoints: Introduction|Introduction]]  
+*  [[Breakpoint editing|Breakpoint menu]]  
+*   [[Image:16x16--breakpoints-enable-icon]]   [[Image:16x16--breakpoints-disable-icon]]   [[Image:breakpoints-delete-icon]]  [[Breakpoint commands|Breakpoint commands]]  
+*   [[Image:tool-breakpoints-icon]]  [[Breakpoint information command|Breakpoint information command]]  
+*  [[Breakpoint menu|Conditional breakpoints]]  
+
+
+
+