From 90b044ef102df5bf7929c71fc9465f23279eabdd Mon Sep 17 00:00:00 2001 From: Pedro Alves Date: Fri, 4 Jun 2021 17:12:41 +0100 Subject: Document TUI improvements in the manual & NEWS gdb/ChangeLog: yyyy-mm-dd Pedro Alves Hannes Domani * NEWS: Add new "TUI Improvements" section and mention mouse support and that unrecognized special keys are now passed to GDB. Mention Python Window.click in the Python improvements section. gdb/doc/ChangeLog: yyyy-mm-dd Pedro Alves * gdb.texinfo (TUI): : New node/section. Co-Authored-By: Hannes Domani Change-Id: I0d79a795d8ac561fd28cdc5184bff029ba28bc64 --- gdb/ChangeLog | 8 ++++++++ gdb/NEWS | 16 ++++++++++++++++ gdb/doc/ChangeLog | 4 ++++ gdb/doc/gdb.texinfo | 18 ++++++++++++++++++ 4 files changed, 46 insertions(+) diff --git a/gdb/ChangeLog b/gdb/ChangeLog index d109179..6febad5 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,11 @@ +2021-07-02 Pedro Alves + Hannes Domani + + * NEWS: Add new "TUI Improvements" section and mention mouse + support and that unrecognized special keys are now passed to + GDB. Mention Python Window.click in the Python improvements + section. + 2021-07-01 Pedro Alves PR mi/15729 diff --git a/gdb/NEWS b/gdb/NEWS index 7f3ed4f..1e474ec 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -108,6 +108,18 @@ registers of a target. The precise requirements of this register feature are documented in the GDB manual. +* TUI improvements + + ** TUI windows now support mouse actions. The mouse wheel scrolls + the appropriate window. + + ** Key combinations that do not have a specific action on the + focused window are passed to GDB. For example, you now can use + Ctrl-Left/Ctrl-Right to move between words in the command window + regardless of which window is in focus. Previously you would + need to focus on the command window for such key combinations to + work. + * New commands set debug event-loop @@ -266,6 +278,10 @@ QMemTags gdb.BreakpointEvent rather than a gdb.StopEvent. The gdb.Breakpoint attached to the event will have type BP_CATCHPOINT. + ** Python TUI windows can now receive mouse click events. If the + Window object implements the click method, it is called for each + mouse click event in this window. + *** Changes in GDB 10 * There are new feature names for ARC targets: "org.gnu.gdb.arc.core" diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index c9f30e5..0df8399 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,7 @@ +2021-07-02 Pedro Alves + + * gdb.texinfo (TUI): : New node/section. + 2021-06-25 Andrew Burgess * gdb.texinfo (Symbols): Document new output format for 'info diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index f1c3e7b..a16a382 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -28387,6 +28387,7 @@ enable} or @kbd{C-x C-a}. @xref{TUI Commands, ,TUI Commands}, and * TUI Overview:: TUI overview * TUI Keys:: TUI key bindings * TUI Single Key Mode:: TUI single key mode +* TUI Mouse Support:: TUI mouse support * TUI Commands:: TUI-specific commands * TUI Configuration:: TUI configuration variables @end menu @@ -28676,6 +28677,23 @@ If @value{GDBN} was built with Readline 8.0 or later, the TUI SingleKey keymap will be named @samp{SingleKey}. This can be used in @file{.inputrc} to add additional bindings to this keymap. +@node TUI Mouse Support +@section TUI Mouse Support +@cindex TUI mouse support + +If the curses library supports the mouse, the TUI supports mouse +actions. + +The mouse wheel scrolls the appropriate window under the mouse cursor. + +The TUI itself does not directly support copying/pasting with the +mouse. However, on Unix terminals, you can typically press and hold +the @key{SHIFT} key on your keyboard to temporarily bypass +@value{GDBN}'s TUI and access the terminal's native mouse copy/paste +functionality (commonly, click-drag-release or double-click to select +text, middle-click to paste). This copy/paste works with the +terminal's selection buffer, as opposed to the TUI's buffer. + @node TUI Commands @section TUI-specific Commands @cindex TUI commands -- cgit v1.1