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 @@ + + + + + + +Call Hierarchy view + + + + +

Call Hierarchy view

+ +

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.

+ +

Call Hierarchy view

+ +

Call Hierarchy view toolbar commands

+ +

The Call Hierarchy view toolbar commands include:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Command
Name
Description
Show Next ReferenceSelects the next functionw.
Show Previous ReferenceSelects the previous function.
Hide Varables, Constants and EnumeratorsToggle to show or hide all variables, constants and enumerators in the view.
Show CallersShow all callers in the search scope of the selected function.
Show CalleesShow all members called by the currently selected function.
Show History ListThis menu displays a history of previously displayed call hierarchies.
Refresh View ContentsRefreshes the view to reflect the current state of the function.
MenuProvides commands for:
  • Using working sets
  • +
  • Showings Callers or Callees
  • +
  • Show or hide file names
  • +
  • Activate or deactivate filters
+ +

Call Hierarchy view context menu commands

+ +

The Call Hierarchy view context menu commands include:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Name
Description
Show ReferenceOpens an editor view containing the referenced function call.
OpenOpens an editor view containing the function reference.
Focus onResets the view to show the selected function.
Refactor...Opens the Rename global function dialog.
DeclarationsSearch the workspace, project, or working set for all function declarations and shows the result in the Search view.
ReferencesSearch the workspace, project, or working set for all function references and shows the result in the Search view.
+ +

Related concepts
+ Debug information

+

Related reference
+ Views

+Nokia Copyright Statement + + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_pref.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_pref.htm index b583b5fca07..bc24f7703fa 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_pref.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_pref.htm @@ -3,8 +3,6 @@ - - Debug preferences @@ -13,26 +11,41 @@

Debug preferences

-

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.

+C/C++ Debug preferences panel -
-
Show full paths
-
Displays the full path of resources
-
Default variable format
-
Specifies the number system in which to display variables (Natural, - Hexadecimal or Decimal).
-
Default expression format
-
Specifies the number system in which to display expressions (Natural, - Hexadecimal or Decimal).
-
Default register format
-
Specifies the number system in which to display registers (Natural, Hexadecimal or - Decimal).
-
Maximum number of displayed instructions
-
The maximum number of assembler instructions displayed in the Disassembly view.
-
Color of source lines
-
The color of source lines in the Disassembly view if mixed source/disassembly code is shown.
-
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
C/C++ Debug Preference Options
Show full paths
Displays the full path of resources.
Default variable format
Specifies the number system in which to display variables (Natural, Hexadecimal, Decimal, or Binary).
Default expression format
Specifies the number system in which to display expressions (Natural, Hexadecimal, Decimal, or Binary).
Default register format
Specifies the number system in which to display registers (Natural, Hexadecimal, Decimal, or Binary).
Maximum number of displayed instructions
The maximum number of assembler instructions displayed in the Disassembly view.
Color of source lines
The color of source lines in the Disassembly view if mixed source/disassembly code is shown.

Related concepts
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 @@ + + + + + + +Disassembly view + + + + +

Disassembly view

+ +

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:

+ +

+ + +

Disassembly view context menu commands

+
+

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.
+
+

Related concepts
+ Debug information

+

Related reference
+ Views

+
+Nokia Copyright Statement + + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_make_settings_pref.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_make_settings_pref.htm new file mode 100644 index 00000000000..8267e9159f6 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_make_settings_pref.htm @@ -0,0 +1,66 @@ + + + + + + +Settings preferences + + + + + +

Settings preferences

+ +

Use the Settings preference panel in the Preferences window to specify the Makefile style and include directories.

+ +

Settings Preferences Window

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Settings Preference Options
Posix Make
Enable to generate makefiles that are POSIX Make compatible.
GNU Make
Enable to generate makefiles that are GNU Make compatible.
New...
Opens the Browse for Folder dialog to select a directory.
Remove
Click to remove the currently selected directory from the Makefile include directories list.
Up
Click to move the currently selected directory up in the list.
Down
Click to move the currently selected directory down in the list.
+ +

Related concepts +
+Build overview

+

Related tasks +
+Defining Build Settings
+Building

+

Related reference
+Views

+
+IBM Copyright Statement + + + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_makefile_settings_pref.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_makefile_settings_pref.htm new file mode 100644 index 00000000000..be9b8b5ca63 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_makefile_settings_pref.htm @@ -0,0 +1,68 @@ + + + + + + +Makefile Editor preferences + + + + + +

Makefile Editor preferences

+ +

Use the Makefile Editor preference panel in the Preferences window to set syntax and folding options for the Makefile editor.

+ +

Makefile Editor Syntax tab

+ + + + + + + + + + + + + + + + + + + + +
Makefile Editor Syntax Options
Color
Click to set the selected syntax item to a specific color.
Bold
If enabled, set the selected syntax item to bold.
Italic
If enabled, set the selected syntax item to italic.
+

Makefile Editor Folding tab

+ + + + + + + + + + + + +
Makefile Editor Folding Tab Options
Enable folding when opening a new editor
If enabled, activate folding when a new Makefile editor is opened.
+ +

Related concepts +
+Build overview

+

Related tasks +
+Defining Build Settings
+Building

+

Related reference
+Views

+
+IBM Copyright Statement + + + + diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_memoryview.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_memoryview.htm index 8468fe84a51..2341fe84315 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_memoryview.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_memoryview.htm @@ -13,15 +13,15 @@

Memory view

-

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.

-
- -
Toggle Memory Monitor 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.
- -
Padded String
-
Specifies the string that represents the unretrievable memory.
- -
Default Column Size
-
Specifies the default -column size of the memory presentation (1 byte, 2 bytes, 4 bytes, 8 bytes). Can -be overwritten by each rendering.
- +

Memory view toolbar icons

+

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:

+
    +
  • Reset Memory Monitor - set to reset only visible or all renderings when reseting a memory monitor
  • +
  • Padded String - enter strings to show unretrievable memory
  • +
  • Select Codepages - specify the standard to convert memory to ASCII and EBCDIC strings
  • +
 Menu > Table Rendering Preferences Specify the memory loading mode to use when rendering scrolls to the end of the buffer.
+
+

Monitors pane context menu

+

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.
+
+
+

Rendering pane context menu

+

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.
 PanesEnable or disable the showing of the Address, Binary, and Text portions of the rendering view.
 EndianToggle between the Little (default) and Big Endian display of memory.
 TextChoose 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.
 RadixSpecify 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.
+

Related concepts
Debug information

diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_registersview.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_registersview.htm index 1a2947f390d..a6a5df24df4 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_registersview.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_registersview.htm @@ -13,32 +13,167 @@

Registers view

-

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.

+

-
Change Register Value
-
Specifies a register value.
-
Format
-
Displays register values, in Natural, Decimal, or Hexadecimal number - systems.
-
Show Type Names
-
Displays the type, (such as int) beside each register value.
-
Auto-Refresh
-
Updates the registers list each time execution stops.
-
Refresh
-
Updates the registers list.
-
Display as Array
-
Displays a selected register as an array of a specified length and index. - This option is only applicable to pointers.
-
Cast To Type
-
Casts a register value to a different type.
-
Restore to Original Type
-
Restores a register value to its original type.
+

Registers view toolbar icons

+

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 > LayoutProvides multiple layout options for the Breakpoints view.
+
+
+

Registers view context menu commands

+

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.
CopyCopies 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.
CutCopies the currently selected text or element to the clipboard and removes the element.
DisableDisables 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/ReplaceOpen the Find / Replace dialog.
FormatSelect 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.
PastePaste the current clipboard content as text.
 Remove Register Group Removes the currently selected register group.
Restore Default Register GroupsRestores 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.
-

Related concepts
Debug information

diff --git a/doc/org.eclipse.cdt.doc.user/topics_Reference.xml b/doc/org.eclipse.cdt.doc.user/topics_Reference.xml index 7ebdcf762d0..400b2efb588 100644 --- a/doc/org.eclipse.cdt.doc.user/topics_Reference.xml +++ b/doc/org.eclipse.cdt.doc.user/topics_Reference.xml @@ -17,10 +17,12 @@ + +