From d6cdce0de5b3acf09a5d65a0a3027a6a08e08972 Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Tue, 12 Jul 2022 16:19:34 +0200 Subject: Doc: Update info about debugging - Update screenshots - Fix option names - Show existing screenshots in more places (where they are discussed in text) Task-number: QTCREATORBUG-27560 Change-Id: I16a45e5e05b8b50932431844e36851f693966201 Reviewed-by: Reviewed-by: hjk --- .../debugger/creator-only/creator-debugger.qdoc | 23 ++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) (limited to 'doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc') diff --git a/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc b/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc index c755cb9067..12495c11d2 100644 --- a/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc +++ b/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc @@ -406,6 +406,15 @@ applications. \li Select the \uicontrol {Break at "main"} check box to stop the debugger at the main function. + \li Select the \uicontrol {Use target extended-remote to connect} + check box to create the connection in the + \c {target extended-remote mode}. In this mode, when the debugged + application exits or you detach from it, the debugger remains + connected to the target. You can rerun the application, attach + to a running application, or use monitor commands specific to the + target. For example, GDB does not exit unless it was invoked using + the \c {--once} option, but you can make it exit by using the + \c {monitor exit} command. \li In the \uicontrol {Override SysRoot} field, specify the path to the \c sysroot to use instead of the default \c sysroot. \li In the \uicontrol {Init commands} field, enter the commands @@ -430,6 +439,10 @@ to manage the GDB process, see \l{Specifying GDB Settings} and \l{Specifying Extended GDB Settings}. + For more informaton about connecting with \c {target extended-remote} mode + in GDB, see \l{https://sourceware.org/gdb/onlinedocs/gdb/Connecting.html} + {Debugging with GDB: Connecting to a Remote Target}. + \section3 Using CDB In remote mode, the local CDB process talks to a CDB process that runs on @@ -864,7 +877,7 @@ Debugging helpers are always automatically used. To force a plain C-like display of structures, select \uicontrol Edit > \uicontrol Preferences > \uicontrol Debugger > \uicontrol {Locals & Expressions}, and then deselect - the \uicontrol {Use Debugging Helper} check box. This will still use the + the \uicontrol {Use Debugging Helpers} check box. This will still use the Python scripts, but generate more basic output. To force the plain display for a single object or for all objects of a given type, select the corresponding option from the context menu. @@ -893,6 +906,8 @@ \uicontrol Debugger > \uicontrol GDB > \uicontrol {Load system GDB pretty printers}. For more information, see \l{Specifying GDB Settings}. + \image qtcreator-gdb-options.png "GDB preferences" + \section2 Customizing Built-In Debugging Helpers You can have commands executed after built-in debugging helpers have @@ -968,7 +983,7 @@ installation in your file system and specify the location in \uicontrol Edit > \uicontrol Preferences > \uicontrol Debugger > \uicontrol {Locals & Expressions} > - \uicontrol {Extra Debugging Helpers}. + \uicontrol {Extra Debugging Helper}. \endlist The custom debugging helpers will be automatically picked up from @@ -1112,6 +1127,8 @@ selecting \uicontrol Edit > \uicontrol Preferences > \uicontrol Debugger > \uicontrol CDB > \uicontrol {Use Python dumper}. + \image qtcreator-cdb-options.png "CDB preferences" + \section3 Dumper Class The \c Dumper class contains generic bookkeeping, low-level, and convenience @@ -1549,6 +1566,8 @@ > \uicontrol Preferences > \uicontrol Debugger > \uicontrol GDB > \uicontrol {Use automatic symbol cache}. + \image qtcreator-gdb-options.png "GDB preferences" + Some slowness stems from maintaining breakpoints inside the debugger (under some circumstances all breakpoints need to be inserted and removed again for each step) and the evaluation of expressions after -- cgit v1.2.3