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

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index d1091792b2605415e99361e2b4973c0a9b160bb8..6febad5ee7dc4c2435aeb0bf433d8f650e948f0b 100644 (file)
--- 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 7f3ed4f02f08fe7c5b68fc9ae256dbfe48626034..1e474eca90af02106828f9bca01bfd181ccd7e29 100644 (file)
--- 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 c9f30e565e1ee8d3bf18e4c65e7fd80597074796..0df8399caa30207ff13246f322b0818ef29059df 100644 (file)
--- 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 f1c3e7ba847df4afa526a75921dada2840b477d3..a16a3825ebb82502f952c60fbb236b09b9b92388 100644 (file)
--- 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