fix #52 - support for selecting parent frames from the call stack view

or the ctx menu

Code was there for long time but deactivated because not working.
Nowadays that works, maybe older GDB versions had a bug ?

CHANGELOG.md

@@ -3,6 +3,8 @@
 ## Enhancements
 
 - messages, search results: exclude backticks if the option _backTicksHighlight_ is enabled.
+- GDB commander: double click on the call stack to select a frame and refresh the different views.
+  This is especially useful to go back to the frame where a D Exception is thrown. (#52)
 
 ## Bugs fixed
 

docs/widgets_gdb_commander.md

@@ -7,7 +7,8 @@ GDB commander is a GUI front-end for the [GNU debugger](https://www.sourceware.o
 
 ![](img/gdb_commander.png)
 
-It allows to debug the project output (if it's an application) but also the [runnable modules](features_runnables.html).
+It allows to debug the project output (if it's an application), [runnable modules](features_runnables.html), or
+a custom executable.
 
 ## Breakpoints
 
@@ -18,22 +19,38 @@ After a break, the following icons may be displayed in the gutter:
 - ![](icons/other/camera_go.png): A watch point is reached. For now the only watchpoints supported are those that monitor a variable (see the toolbar description).
 - ![](icons/other/step.png): The program execution stopped here for another reason. It may be caused by step by step execution or because an unexpected signal has been received.
 
-## Target options
+## Top panel
+
+### Call Stack
+
+This page displays the current call stack, from most recent (top) to older (bottom).
+When the debugger is paused it is possible to select a particular frame by double-click or using the context menu.
+This option is for example useful to handle automatic break on D exceptions.
+D exceptions are detected using a call to a runtime function but the place where and Exception is thrown is at least 2 frames lower.
+
+### Target options
 
 This page allows to edit the options passed to the debugger target (also called _the inferior_).
 
 ![](img/gdb_commander_debugeeopts.png)
 
-- **arguments**: Allows to set the target command line arguments. One item per line. Items can include [symbolic strings](features_symbolic_strings.html).
+- **arguments**: Allows to set the target command line arguments. One item per line. Items can include [symbolic strings](features_symbolic_strings.html) and be deactiviated by prepending `\\`.
 - **environmentPaths**: Allows to add additional folders to the PATH variable. One item per line.
 - **queryArguments**: When checked and when the debugging cession starts a small input dialog is displayed. It can be used to pass more **--para --meters** to the target.
 - **target**: Read-only. Indicates clearly which is the project or the runnable module that will be debugged.
 - **workingDirectory**: Allows to set the target working directory. Can include [symbolic strings](features_symbolic_strings.html).
 
+## Canter panel
+
+### Assembler
+
+Disassembly of the current function.
+Using the context menu and when the debugger is paused it is possible to resume execution until a particular instruction is reached.
+
 ## CPU inspector
 
 This page shows the content of the CPU registers. Each value can be modified.
-Note that for now SSE registers are not supported by the inspector.
+Note that for now SSE registers are not displayed.
 
 ## Toolbar
 
@@ -47,7 +64,7 @@ Note that for now SSE registers are not supported by the inspector.
 - ![](icons/other/list.png): Updates the call stack list.
 - ![](icons/window/watch_window.png): Updates the local variables list.
 - ![](icons/other/camera_add.png): Allows to set or remove a watch point. When the button is clicked, a watch is added for the variable that's selected in the variables list. A context menu at the right allows to define the access for which the debugger breaks.
-- ![](icons/other/evaluate_formula.png): Allows to evaluate either the variable or the dereference of the variable selected in the variable list, or a custom expression. To select the mode, use the menu attached to the right of the icon. Note that a specific shortcut allows to repeat the command when the mode is set to "Evaluate Custom Expression", so that the input dialog step is skipped.
+- ![](icons/other/evaluate_formula.png): Allows to evaluate either the variable or the dereference of the variable selected in the variable list, or a custom expression. To select the mode, use the menu attached to the right of the icon. Note that a specific shortcut allows to repeat the command when the mode is set to "Evaluate Custom Expression", so that the input dialog step is skipped. Note that it is usually more conveniant to position the mouse over an expression in the code editor to evaluate.
 
 ## Custom commands
 
@@ -79,16 +96,16 @@ The text following the symbol is written to the input stream, with an implicit n
 
 ![](img/options_gdb_commander.png)
 
-- **asmSyntax**: Sets the assembler syntax used in the _Assembly_ tab. Intel or AT&T.
+- **asmSyntax**: Sets the assembler syntax used in the _Assembler_ tab. Intel or AT&T.
 - **autoDemangle**: Sets if the GDB output is automatically filtered by [ddemangle](https://github.com/dlang/tools#d-tools). Mostly useful for the _Call stack_ page.
 - **autoDisassemble**: Sets if the assembly output is automatically updated when the execution breaks.
 - **autoGetCallStack**: Sets if the call stack is automatically updated when the execution breaks.
 - **autoGetRegisters**: Sets if the CPU view is automatically updated when the execution breaks.
 - **autoGetThreads**: Sets if the thread list is automatically updated when the execution breaks.
 - **autoGetVariables**: Sets if the list of the local variables is automatically updated when the execution breaks.
-- **commandHistory**: Container that stores the custom GDB commands.
+- **commandHistory**: List that stores the custom GDB commands.
 - **coreBreakingSymbols**: List of the symbols specific to the D language, which allow, among other things, to automatically break on `throw`.
-- **customEvalHistory**: Container that stores the custom expressions that have been evaluated.
+- **customEvalHistory**: List that stores the custom expressions that have been evaluated.
 - **hideCpuView**: When checked the CPU inspector is not visible anymore.
 - **ignoredSignals**: Sets the signals that won't break the execution.
 - **keepRedirectedStream**: Sets if the files that contain the inferior I/O history are kept on the disk. These files stands in the target directory with the extensions _.inferiorin_ and _.inferiorout_.

src/u_gdb.pas

@@ -1246,6 +1246,7 @@ end;
 constructor TGdbWidget.create(aOwner: TComponent);
 var
   asmBreak: TMenuItem;
+  selFrame: TMenuItem;
 begin
   inherited;
   EntitiesConnector.addObserver(self);
@@ -1266,7 +1267,14 @@ begin
   fBreakPoints := TPersistentBreakPoints.create(self);
   fSynchronizedDocuments := TStringList.Create;
 
-  TListViewCopyMenu.create(lstCallStack);
+  with TListViewCopyMenu.create(lstCallStack) do
+  begin
+    selFrame          := TMenuItem.Create(self);
+    selFrame.Caption  := 'Select Frame';
+    selFrame.OnClick  := @lstCallStackDblClick;
+    addAdditionalItem(selFrame);
+  end;
+
   TListViewCopyMenu.create(lstVariables);
   TListViewCopyMenu.create(lstThreads);
 
@@ -3003,11 +3011,16 @@ begin
   doc := fDocHandler.findDocument(nme);
   if doc.isAssigned then
     doc.CaretY:= itm.line;
-  {gdbCommand('-stack-select-frame ' + intToStr(lstCallStack.ItemIndex));
+  gdbCommand('-stack-select-frame ' + intToStr(lstCallStack.ItemIndex));
   if fOptions.autoGetVariables then
     infoVariables;
   if fOptions.autoGetRegisters then
-    infoRegs;}
+    infoRegs;
+  if fOptions.autoDisassemble then
+  begin
+    fLastLine := lstCallStack.Selected.SubItems[2];
+    infoAsm(lstCallStack.Selected.SubItems[1]);
+  end;
 end;
 
 procedure TGdbWidget.lstThreadsDblClick(Sender: TObject);