Commit 88fe1ce5 authored by Leena Miettinen's avatar Leena Miettinen

Doc: new ways of managing breakpoint

Describe breakpoint settings in more detail.

Change-Id: I03a9f888fa29c3539f2ed6658f915da5c4c3adc9
Reviewed-by: default avatarLeena Miettinen <riitta-leena.miettinen@digia.com>
parent fbbea1b1
......@@ -84,16 +84,16 @@ Debugging
types (QByteArray, std::string, char[], char* etc)
* Adjusted to GDB 7.5 changes
* Removed dependency on QmlJSTools
* Added shortcut to add breakpoint by double click on break view
* Made breakpoint markers draggable
* Added logging of exceptions (QTCREATORBUG-8141)
* Added option to use Intel-style disassembly
* Improved color highlighting of locals in memory view
* Implemented adding breakpoints by double-clicking in Breakpoints view
* Implemented dragging and dropping breakpoint markers
* Added logging of exceptions in the Compile Output pane (QTCREATORBUG-8141)
* Added option to use Intel-style disassembly to debugger GDB options
* Improved color highlighting of locals in Memory view
* Made string cutoff value configurable
* Put separate string displays in tab widget (QTCREATORBUG-8344)
* Implemented basic value editing for CDB (QTCREATORBUG-8344)
* Implemented support for displaying images in CDB
* Added framework to wrap plain GDB pretty printers for use in Creator
* Added framework to wrap plain GDB pretty printers for use in Qt Creator
* Implemented display format changes for multi-selection
(QTCREATORBUG-7577)
......
......@@ -502,34 +502,80 @@
The interruption of a program by a breakpoint can be restricted with
certain conditions.
To set a breakpoint at a particular line you want the program to stop,
click the left margin or press \key F9 (\key F8 for Mac OS X).
You can set and delete breakpoints before the program starts running or
while it is running under the debugger's control. Breakpoints are saved
together with a session.
\section2 Adding Breakpoints
To add breakpoints:
\list 1
\li Add a new breakpoint in one of the following ways:
\list
\li In the code editor, click the left margin or press \key F9
(\key F8 for Mac OS X) at a particular line you want the
program to stop.
\li In the \gui Breakpoints view, double-click in the empty
part of the view.
\li In the \gui Breakpoints view, select \gui {Add Breakpoint}
in the context menu.
\endlist
\li In the \gui {Breakpoint type} field, select the location in the
program code where you want the program to stop. The other options
to specify depend on the selected location.
To set breakpoints, select \gui {Add Breakpoint} in
the context menu in the \gui Breakpoints view.
\image qtcreator-add-breakpoint.png "Add Breakpoints" dialog
\image qtcreator-add-breakpoint.png "Add Breakpoints" dialog
\li In the \gui Condition field, set the condition to be evaluated
before stopping at the breakpoint if the condition evaluates as
true.
\note You can remove a breakpoint:
\li In the \gui Ignore field, specify the number of times that the
breakpoint is ignored before the program stops.
\li In the \gui Commands field, specify the commands to execute when
the program stops; one command on a line. GDB executes the commands
in the order in which they are specified.
\endlist
For more information on breakpoints, see
\l{http://sourceware.org/gdb/onlinedocs/gdb/Breakpoints.html#Breakpoints}
{Breakpoints, Watchpoints, and Catchpoints} in GDB documentation.
\section2 Moving Breakpoints
To move the breakpoint, drag and drop a breakpoint marker to another line.
\section2 Deleting Breakpoints
To delete breakpoints:
\list
\li By clicking the breakpoint marker in the text editor.
\li Click the breakpoint marker in the text editor.
\li By selecting the breakpoint in the breakpoint view and pressing
\li Select the breakpoint in the \gui Breakpoints view and press
\key{Delete}.
\li By selecting \gui{Delete Breakpoint} from the context
menu in the \gui Breakpoints view.
\li Select \gui{Delete Breakpoint} in the context menu in the
\gui Breakpoints view.
\endlist
You can set and delete breakpoints before the program starts running or
while it is running under the debugger's control. Breakpoints are saved
together with a session.
\section2 Setting Data Breakpoints
A \e {data breakpoint} stops the program when data is read or written at the
specified address.
To set a data breakpoint at an address:
\list 1
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment