diff --git a/doc/qtcreator/images/qtcreator-debugger-attach-to-running-debug-server.png b/doc/qtcreator/images/qtcreator-debugger-attach-to-running-debug-server.png index 296d4e6e6f2..6d8292818be 100644 Binary files a/doc/qtcreator/images/qtcreator-debugger-attach-to-running-debug-server.png and b/doc/qtcreator/images/qtcreator-debugger-attach-to-running-debug-server.png differ diff --git a/doc/qtcreator/images/qtcreator-debugging-helper-options.png b/doc/qtcreator/images/qtcreator-debugging-helper-options.png index a73e6144bd4..43a106aed5c 100644 Binary files a/doc/qtcreator/images/qtcreator-debugging-helper-options.png and b/doc/qtcreator/images/qtcreator-debugging-helper-options.png differ diff --git a/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc b/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc index c755cb90679..12495c11d25 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 diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc index 678e7b02cb8..ade62623dc5 100644 --- a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc +++ b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc @@ -195,7 +195,8 @@ If an instance of a class is derived from QObject, and you would like to find all other objects connected to one of your object's slots using Qt's signals and slots mechanism, select \uicontrol Edit > \uicontrol Preferences - > \uicontrol{Debugger} > \uicontrol{Locals} > \uicontrol{Use Debugging Helper}. + > \uicontrol {Debugger} > \uicontrol {Locals & Expressions} > + \uicontrol {Use Debugging Helpers}. In the \uicontrol{Locals} view, expand the object's entry and open the slot in the \e slots subitem. The objects connected to this slot are @@ -214,9 +215,9 @@ \list 1 \li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Debugger > - \uicontrol{Locals}. - - \li Uncheck the \uicontrol{Use Debugging Helper} checkbox. + \uicontrol {Locals & Expressions}. + \image qtcreator-debugging-helper-options.png "Locals & Expressions preferences" + \li Deselect \uicontrol {Use Debugging Helpers}. \endlist @@ -229,9 +230,8 @@ \li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Debugger > \uicontrol General. - - \li Select the \uicontrol {Use tooltips in main editor while debugging} check - box. + \image qtcreator-debugger-general-options.png "Debugger General preferences" + \li Select \uicontrol {Use tooltips in main editor when debugging}. \endlist