summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLeena Miettinen <riitta-leena.miettinen@qt.io>2023-03-23 16:52:23 +0100
committerLeena Miettinen <riitta-leena.miettinen@qt.io>2023-03-27 07:29:33 +0000
commit1b2f1ac0f93a04a49544ef05f4172110c3d87b31 (patch)
treecb14a973184305d9f65fa205d199d021ac6147d6 /doc
parent73227535a424691ececa1043a5bd02ed6901eca4 (diff)
downloadqt-creator-1b2f1ac0f93a04a49544ef05f4172110c3d87b31.tar.gz
Doc: Edit Registers view docs
Task-number: QTCREATORBUG-28778 Change-Id: I30f24e7c192332611f9e7d14ec5541b6adccb9a5 Reviewed-by: Christian Stenger <christian.stenger@qt.io>
Diffstat (limited to 'doc')
-rw-r--r--doc/qtcreator/images/qtcreator-debugger-memory-editor.webpbin0 -> 9700 bytes
-rw-r--r--doc/qtcreator/images/qtcreator-debugger-registers-view.webpbin0 -> 7482 bytes
-rw-r--r--doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc58
3 files changed, 49 insertions, 9 deletions
diff --git a/doc/qtcreator/images/qtcreator-debugger-memory-editor.webp b/doc/qtcreator/images/qtcreator-debugger-memory-editor.webp
new file mode 100644
index 0000000000..ef51b1dd29
--- /dev/null
+++ b/doc/qtcreator/images/qtcreator-debugger-memory-editor.webp
Binary files differ
diff --git a/doc/qtcreator/images/qtcreator-debugger-registers-view.webp b/doc/qtcreator/images/qtcreator-debugger-registers-view.webp
new file mode 100644
index 0000000000..05b08e9668
--- /dev/null
+++ b/doc/qtcreator/images/qtcreator-debugger-registers-view.webp
Binary files differ
diff --git a/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc b/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc
index 1009f765ab..921c5f001d 100644
--- a/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc
+++ b/doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc
@@ -1007,17 +1007,57 @@
\title Viewing and Editing Register State
- The \uicontrol Registers view displays the current state of the CPU registers.
- Depending on the CPU type, there will be different registers available. The
- values of registers that recently have changed are highlighted in red and empty
- register values as well as leading zeroes are grayed out.
+ \e {Machine code} consists of machine language instructions that make the CPU
+ perform tasks, such as load or store, on units of data in the CPU's registers
+ or memory.
- In addition it is possible to edit the content of registers while the application is
- stopped. This applies to both General-purpose and Special-purpose registers.
- Registers can be edited in the standard condensed view or in their particular parts
- if the register is displayed expanded.
+ The \uicontrol Registers view displays the current state of general-purpose
+ and special-purpose CPU registers. The available registers depend on the CPU
+ type.
- By default, the \uicontrol Registers view is hidden.
+ \image qtcreator-debugger-registers-view.webp {Registers view}
+
+ You can view register values when the application stops. Double-click
+ register values to edit them.
+
+ The values of registers that recently changed are highlighted in red. Empty
+ register values and leading zeroes are grayed out.
+
+ Right-click column headers to show and hide the \uicontrol Name and
+ \uicontrol Value columns in the view.
+
+ Right-click the view to select the following actions:
+
+ \list
+ \li Reload register list.
+ \li Open \l {Examining Memory}{Memory Editor} at the selected value.
+ \li Open the \l {Viewing Disassembled Code}{Disassembler} view.
+ \li Display a value in hexadecimal, decimal, octal, or binary format.
+ \endlist
+
+ By default, the \uicontrol Registers view is hidden. To show it, select it in
+ \uicontrol Views on the debugger toolbar.
+
+ \section1 Examining Memory
+
+ You can examine memory in many formats, independently of the application's
+ data types.
+
+ To open the memory editor, select a value \uicontrol Registers view,
+ and then select \uicontrol {Open Memory Editor at <value>} or
+ \uicontrol {Open Memory View at <value>} in the context menu:
+
+ \image qtcreator-debugger-memory-editor.webp {Memory Editor}
+
+ Hover the mouse pointer on a value to see details as a tooltip.
+
+ Right-click a value to:
+
+ \list
+ \li Copy the selection in ASCII or hexadecimal format.
+ \li Set a data breakpoint on the selection.
+ \li Jump to the selected address in the current data view or a new one.
+ \endlist
*/
/*!