diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_add_mem_monitor.png b/doc/org.eclipse.cdt.doc.user/images/icon_add_mem_monitor.png
new file mode 100644
index 00000000000..1f9218ccfea
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_add_mem_monitor.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_copy_to_clipboard.png b/doc/org.eclipse.cdt.doc.user/images/icon_copy_to_clipboard.png
new file mode 100644
index 00000000000..177d228de90
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_copy_to_clipboard.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_link_mem_rendering.png b/doc/org.eclipse.cdt.doc.user/images/icon_link_mem_rendering.png
new file mode 100644
index 00000000000..7e56e3059a9
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_link_mem_rendering.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_new_memory_view.png b/doc/org.eclipse.cdt.doc.user/images/icon_new_memory_view.png
new file mode 100644
index 00000000000..2ceac484b32
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_new_memory_view.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_reg_cast_to_type.png b/doc/org.eclipse.cdt.doc.user/images/icon_reg_cast_to_type.png
new file mode 100644
index 00000000000..1c212946f4e
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_reg_cast_to_type.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_reg_change_value.png b/doc/org.eclipse.cdt.doc.user/images/icon_reg_change_value.png
new file mode 100644
index 00000000000..f48aab8884c
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_reg_change_value.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_reg_copy_registers.png b/doc/org.eclipse.cdt.doc.user/images/icon_reg_copy_registers.png
new file mode 100644
index 00000000000..01b5f3e2860
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_reg_copy_registers.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_reg_create_watch_expr.png b/doc/org.eclipse.cdt.doc.user/images/icon_reg_create_watch_expr.png
new file mode 100644
index 00000000000..9498b71aa69
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_reg_create_watch_expr.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_reg_disable.png b/doc/org.eclipse.cdt.doc.user/images/icon_reg_disable.png
new file mode 100644
index 00000000000..54fd32b7a3f
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_reg_disable.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_reg_display_array.png b/doc/org.eclipse.cdt.doc.user/images/icon_reg_display_array.png
new file mode 100644
index 00000000000..6610c96f57e
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_reg_display_array.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_reg_enable.png b/doc/org.eclipse.cdt.doc.user/images/icon_reg_enable.png
new file mode 100644
index 00000000000..dc35833e1a2
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_reg_enable.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_reset_mem_monitor.png b/doc/org.eclipse.cdt.doc.user/images/icon_reset_mem_monitor.png
new file mode 100644
index 00000000000..6b959506a2d
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_reset_mem_monitor.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_show_logical_struct.png b/doc/org.eclipse.cdt.doc.user/images/icon_show_logical_struct.png
new file mode 100644
index 00000000000..d15fc83e792
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_show_logical_struct.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_show_type_names.png b/doc/org.eclipse.cdt.doc.user/images/icon_show_type_names.png
new file mode 100644
index 00000000000..d5f12fb7772
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_show_type_names.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_switch_mem_monitor.png b/doc/org.eclipse.cdt.doc.user/images/icon_switch_mem_monitor.png
new file mode 100644
index 00000000000..dcaa093081c
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_switch_mem_monitor.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_toggle_memory_monitor.png b/doc/org.eclipse.cdt.doc.user/images/icon_toggle_memory_monitor.png
new file mode 100644
index 00000000000..1c5983aee67
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_toggle_memory_monitor.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_toggle_split_pane.png b/doc/org.eclipse.cdt.doc.user/images/icon_toggle_split_pane.png
new file mode 100644
index 00000000000..bfea8457511
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/icon_toggle_split_pane.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/images/view_memory.png b/doc/org.eclipse.cdt.doc.user/images/view_memory.png
new file mode 100644
index 00000000000..dfef1fc3d2c
Binary files /dev/null and b/doc/org.eclipse.cdt.doc.user/images/view_memory.png differ
diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_dbg_view.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_dbg_view.htm
index b536f1a8bbc..0d2b05e492c 100644
--- a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_dbg_view.htm
+++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_dbg_view.htm
@@ -17,6 +17,7 @@
Registers view
Memory view
Memory view preferences
+ Disassembly view
Modules view
Signals view
Debug view
diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_views.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_views.htm
index 7824a1df830..cf2314ed585 100644
--- a/doc/org.eclipse.cdt.doc.user/reference/cdt_o_views.htm
+++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_o_views.htm
@@ -20,6 +20,7 @@
Make Targets view
Editor view
Console view
+ Call Hierarchy view
Problems view
Properties view
Search view
diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_call_hierarchy_view.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_call_hierarchy_view.htm
new file mode 100644
index 00000000000..31c80a31915
--- /dev/null
+++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_call_hierarchy_view.htm
@@ -0,0 +1,113 @@
+
+
+
+
The Call Hierarchy view shows the loaded callers and callees for a selected C/C++ function. Right-click a function name in a source file and select Open Call Hierarchy to open a Call Hierarchy view, if none is open, and show the function's callers.
+ +The Call Hierarchy view toolbar commands include:
+Command |
+ Name |
+ Description |
+
![]() |
+ Show Next Reference | +Selects the next functionw. | +
![]() |
+ Show Previous Reference | +Selects the previous function. | +
![]() |
+ Hide Varables, Constants and Enumerators | +Toggle to show or hide all variables, constants and enumerators in the view. | +
![]() |
+ Show Callers | +Show all callers in the search scope of the selected function. | +
![]() |
+ Show Callees | +Show all members called by the currently selected function. | +
![]() |
+ Show History List | +This menu displays a history of previously displayed call hierarchies. | +
![]() |
+ Refresh View Contents | +Refreshes the view to reflect the current state of the function. | +
![]() |
+ Menu | +Provides commands for:
|
+
The Call Hierarchy view context menu commands include:
+Name |
+ Description |
+
Show Reference | +Opens an editor view containing the referenced function call. | +
Open | +Opens an editor view containing the function reference. | +
Focus on | +Resets the view to show the selected function. | +
Refactor... | +Opens the Rename global function dialog. | +
Declarations | +Search the workspace, project, or working set for all function declarations and shows the result in the Search view. | +
References | +Search the workspace, project, or working set for all function references and shows the result in the Search view. | +
+ Views
The Debug view of the Debug perspective displays information about the variables in the currently -selected stack frame.
+The C/C++ Debug panel controls general settings for C/C++ debugging.
+Displays the full path of resources. | +|
Specifies the number system in which to display variables (Natural, Hexadecimal, Decimal, or Binary). | +|
Specifies the number system in which to display expressions (Natural, Hexadecimal, Decimal, or Binary). | +|
Specifies the number system in which to display registers (Natural, Hexadecimal, Decimal, or Binary). | +|
The maximum number of assembler instructions displayed in the Disassembly view. | +|
The color of source lines in the Disassembly view if mixed source/disassembly code is shown. | +
diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dissassembly_view.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dissassembly_view.htm
new file mode 100644
index 00000000000..cd98ca72465
--- /dev/null
+++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dissassembly_view.htm
@@ -0,0 +1,53 @@
+
+
+
+
The Disassembly view shows the loaded program as assembler instructions mixed with source code for comparison. The currently executing line is indicated by an arrow marker and highlighted in the view. You can do the following tasks in the Disassembly view:
+The Disassembly view context menu commands include:
+Command |
+ Name |
+ Description |
+
![]() |
+ Run To Line | +Resumes program execution until the specific line is reached. This is a convenient way to suspend execution at a line without setting a breakpoint. |
+
![]() |
+ Resume At Line | +Resume program execution from the line selected in the Disassembly view. | +
+ Views
Use the Settings preference panel in the Preferences window to specify the Makefile style and include directories.
+ +Enable to generate makefiles that are POSIX Make compatible. | +|
Enable to generate makefiles that are GNU Make compatible. | +|
Opens the Browse for Folder dialog to select a directory. | +|
Click to remove the currently selected directory from the Makefile include directories list. | +|
Click to move the currently selected directory up in the list. | +|
Click to move the currently selected directory down in the list. | +
+
+Defining Build Settings
+Building
Use the Makefile Editor preference panel in the Preferences window to set syntax and folding options for the Makefile editor.
+ +Click to set the selected syntax item to a specific color. | +|
If enabled, set the selected syntax item to bold. | +|
If enabled, set the selected syntax item to italic. | +
If enabled, activate folding when a new Makefile editor is opened. | +
+
+Defining Build Settings
+Building
The Memory view of the Debug +
The Memory view of the Debug perspective lets you monitor and modify your process memory. The process memory is presented as a list of so called memory monitors. Each monitor represents a section of memory specified by it's location called base address. Each memory monitor can be displayed in different predefined data formats -- memory -renderings. The debugger supports four rendering types -- hexadecimal +renderings. The debugger supports five rendering types -- hexadecimal (default), ascii, signed integer and unsigned integer. The default rendering is displayed automatically on the monitor creation.
- +The Memory view contains two panes -- the Memory Monitors pane and the Memory Renderings pane. The Memory Monitors pane displays the list of memory monitors added to the debug @@ -30,28 +30,158 @@ Renderings pane is controlled by the selection in the Memory Monitors pane and consists of the tabs that display renderings. The Memory Renderings pane can be configured to display two renderings simultaneously.
-The following options are available.
-The table below lists the icons displayed in the Memory view toolbar.
+Command |
+ Name |
+ Description |
+
![]() |
+ New Memory View |
+ Click to create a new memory view. | +
![]() |
+ Pin Memory Monitor |
+ Select to pin the memory monitor on top of all other memory monitors. | +
![]() |
+ Toggle Memory Monitors Pane |
+ Shows/hides the Memory Monitor pane. | +
![]() |
+ Toggle Split Pane |
+ Toggles the Memory Renderings pane split. | +
![]() |
+ Link Memory Rendering Panes |
+ Synchronizes the selection of two memory renderings. | +
![]() |
+ Switch Memory Monitor |
+ When more than one memory monitor is active, select a different memory monitor to view. | +
+ | Menu > Layout | +Switch the Monitors and Rendering panes display between horizontal or vertical orientation. | +
+ | Menu > Preferences | +Opens the Preferences window allowing you to set: +
|
+ | Menu > Table Rendering Preferences | +Specify the memory loading mode to use when rendering scrolls to the end of the buffer. | +
The Monitors pane context menu inside the Memory view includes:
+Command |
+ Name |
+ Description |
+
![]() |
+ Add Memory Monitor |
+ Adds a new memory address or variable to the Memory Monitors pane. | +
![]() |
+ Remove Memory Monitor |
+ Removes the selected memory address or variable from the Memory Monitors pane. | +
![]() |
+ Reset |
+ Resets the current memory monitor view. | +
The Rendering pane context menu inside the Memory view includes:
+Command |
+ Name |
+ Description |
+
![]() |
+ Add Rendering |
+ Add a memory rendering pane to display a memory monitor item at a different address or in a different format. | +
![]() |
+ Remove Rendering |
+ Removes the selected rendering from the Memory view. | +
+ | Panes | +Enable or disable the showing of the Address, Binary, and Text portions of the rendering view. | +
+ | Endian | +Toggle between the Little (default) and Big Endian display of memory. | +
+ | Text | +Choose the character encoding used to convert memory values into text for display. Choices include: ISO-8859-1 (default), US-ASCII, or UTF-8. | +
+ | Cell Size | +Specify the cell size used to display values in the Binary column. Choices include: 1, 2, 4 (default), and 8 bytes. | +
+ | Radix | +Specify the radix used to display the values in the Binary column. Choices include: Hex, Decimal Signed, Decimal Unsigned (default), Octal, and Binary. | +
![]() |
+ Copy To Clipboard | +Copies the selected portion of the Rendering pane to the clipboard. | +
+ | Go To Address | +Opens an edit box to type in a memory address. Press Enter to go to that address and show it in the Rendering pane. | +
+ | Reset To Base Address | +Resets the Rendering pane to the original base address. | +
+ | Refresh |
+ Refreshes the Rendering pane. | +
The Registers view of the Debug perspective lists information about the registers in a selected stack frame. +
The Registers view of the Debug perspective lists information about the registers in a selected stack frame. Values that have changed are highlighted in the Registers view when your program -stops. The options described below are available when you right-click a register -value.
- +stops. +The table below lists the icons displayed in the Registers view toolbar.
+Command |
+ Name |
+ Description |
+
![]() |
+ Show Type Names |
+ Displays the type, (such as int) beside each register value. |
+
![]() |
+ Show Logical Structure |
+ Changes if logical structures should be shown in the view or not. |
+
![]() |
+ Collapse All |
+ Collapses all the the currently expanded registers. |
+
![]() |
+ Menu > Layout | +Provides multiple layout options for the Breakpoints view. | +
The Registers view context menu commands include:
+Command |
+ Name |
+ Description |
+
+ | Add Register Group | +Open the Register Group dialog which allows you to define a register group that is shown in the Registers view. | +
+ | Assign Value | +Assigns a value to the selected register. | +
![]() |
+ Cast To Type... | +Open the Cast To Type dialog. | +
![]() |
+ Change Value... | +Open the Set Value dialog to change the selected registers value. | +
+ | Content Assist | +Opens a content assist dialog at the current cursor position. | +
+ | Copy | +Copies the currently selected text or elements to the clipboard | +
![]() |
+ Copy Registers |
+ Copies the register names and contents to the clipboard | +
![]() |
+ Create Watch Expression | +Converts the selected register into a watch expression. | +
+ | Cut | +Copies the currently selected text or element to the clipboard and removes the element. | +
![]() |
+ Disable | +Disables the selected register. | +
![]() |
+ Display As Array... | +Open the Display As Array dialog which allows you to specify the start and length of the array. | +
+ | Edit Register Group | +Open the Register Group dialog to edit the selected register group. | +
![]() |
+ Enable |
+ Enables the selected register. | +
+ | Find... | +Open the Find dialog which allows you to find specific elements within the view. | +
+ | Find/Replace | +Open the Find / Replace dialog. | +
+ | Format | +Select a format type. Choices include: BInary, Decimal, Natural, and hexadecimal. | +
+ | Max Length... | +Open the Configure Details Pane dialog to set the maximum number of characters to display. Default is 10000. | +
+ | Paste | +Paste the current clipboard content as text. | +
+ | Remove Register Group | +Removes the currently selected register group. | +
+ | Restore Default Register Groups | +Restores the original register groups. | +
+ | Restore Original Type | +Returns the selected register to the original type. | +
+ | Select All | +Select all the editor content. | +
+ | Wrap Text | +Activate to wrap the text contents within the visible area of the Details pane of the Registers view. | +