summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPedro Alves <pedro@palves.net>2021-06-04 17:12:41 +0100
committerPedro Alves <pedro@palves.net>2021-07-02 16:31:20 +0100
commit90b044ef102df5bf7929c71fc9465f23279eabdd (patch)
treea65083f9f836ab2968a488fc9b259e874be55591
parent49910fd88dcd2ec3d0d9e56120ceb56a6a64b7b8 (diff)
downloadbinutils-gdb-90b044ef102df5bf7929c71fc9465f23279eabdd.tar.gz
Document TUI improvements in the manual & NEWS
gdb/ChangeLog: yyyy-mm-dd Pedro Alves <pedro@palves.net> Hannes Domani <ssbssa@yahoo.de> * 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 <pedro@palves.net> * gdb.texinfo (TUI): <TUI Mouse Support>: New node/section. Co-Authored-By: Hannes Domani <ssbssa@yahoo.de> Change-Id: I0d79a795d8ac561fd28cdc5184bff029ba28bc64
-rw-r--r--gdb/ChangeLog8
-rw-r--r--gdb/NEWS16
-rw-r--r--gdb/doc/ChangeLog4
-rw-r--r--gdb/doc/gdb.texinfo18
4 files changed, 46 insertions, 0 deletions
diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index d1091792b26..6febad5ee7d 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,11 @@
+2021-07-02 Pedro Alves <pedro@palves.net>
+ Hannes Domani <ssbssa@yahoo.de>
+
+ * 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 <pedro@palves.net>
PR mi/15729
diff --git a/gdb/NEWS b/gdb/NEWS
index 7f3ed4f02f0..1e474eca90a 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 c9f30e565e1..0df8399caa3 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,7 @@
+2021-07-02 Pedro Alves <pedro@palves.net>
+
+ * gdb.texinfo (TUI): <TUI Mouse Support>: New node/section.
+
2021-06-25 Andrew Burgess <andrew.burgess@embecosm.com>
* gdb.texinfo (Symbols): Document new output format for 'info
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index f1c3e7ba847..a16a3825ebb 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