diff options
author | Doug Schaefer | 2007-05-18 14:54:17 +0000 |
---|---|---|
committer | Doug Schaefer | 2007-05-18 14:54:17 +0000 |
commit | ff5345178e9d44d8ccc5243db4b20a27fcd0cb4e (patch) | |
tree | 9846a909a7b5a9bb850346582f046e9399532380 /doc | |
parent | c89e7032190f24e718b3a7dd95f2f73d395c6852 (diff) | |
download | org.eclipse.cdt-ff5345178e9d44d8ccc5243db4b20a27fcd0cb4e.tar.gz org.eclipse.cdt-ff5345178e9d44d8ccc5243db4b20a27fcd0cb4e.tar.xz org.eclipse.cdt-ff5345178e9d44d8ccc5243db4b20a27fcd0cb4e.zip |
Patch for Frank - 183385 - Debugging documentation.
Diffstat (limited to 'doc')
22 files changed, 252 insertions, 53 deletions
diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_before_you_begin.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_before_you_begin.htm index 436eb5f2f68..4e1954f2a6f 100644 --- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_before_you_begin.htm +++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_c_before_you_begin.htm @@ -7,38 +7,36 @@ <link rel="stylesheet" type="text/css" href="../help.css"> </head> <body> -<h1>Before you begin</h1> +<h2>Before you begin</h2> -<h2>Utilities</h2> +<p>Your CDT plugins are not complete until you've installed some additional C/C++ development tools.</p> + +<h3>Utilities</h3> <p>You must install and configure the following utilities:</p> <ul> <li>Build (such as <tt>make</tt>).</li> - <li>Compile (such as gcc). For more information, see <a href="http://gcc.gnu.org">http://gcc.gnu.org</a>.</li> - <li>Debug (such as gdb). For more information, see <a href="http://sources.redhat.com/gdb/">http://sources.redhat.com/gdb/</a>.</li> + <li>Compile (such as <tt>gcc</tt>). For more information, see <a href="http://gcc.gnu.org">http://gcc.gnu.org</a>.</li> + <li>Debug (such as <tt>gdb</tt>). For more information, see <a href="http://sources.redhat.com/gdb/">http://sources.redhat.com/gdb/</a>.</li> </ul> -<p><b>Tip:</b> Cygwin contains these utilities for a Windows environment. - For more information, see <a href="http://www.cygwin.com">http://www.cygwin.com</a>. -</p> -<p>To test if cygwin was installed correctly open a command prompt and type <tt>g++</tt> or <tt>make</tt>.</p> - -<p>The following error message means that no <tt>make</tt> is installed or your path is not configured correctly.</p> -<pre>'g++' (or 'make') is not recognized as an internal or external command, operable program or batch file</pre> -<p>To check your path open a command prompt and type <tt>PATH</tt>. Make sure that the path to your build utility is defined (example <tt>PATH=c:\cygwin\bin</tt>).<p> +<h3>cygwin</h3> +<p><tt>cygwin</tt> contains all of these utilities for the Windows environment. To download or more information, see <a href="http://www.cygwin.com">http://www.cygwin.com</a>.<p> -<h2>Build Automatically</h2> +<p>Once you've installed <tt>cygwin</tt>, you should test to ensure it was installed correctly. To do this, open a command prompt and type <tt>g++</tt> or <tt>make</tt>. If the command complains of a missing file for input, everything has installed fine.</p> -<p>For C/C++ projects this feature should be turned off, otherwise builds will be performed whenever a file is saved, including makefiles and header files. </p> -<p>Click <b>Projects</b> from the menubar and ensure there is no checkmark beside <b>Build Automatically</b> if there is one click <b>Build Automatically</b> to deselect it. </p> +<p>If the following error message appears, it means that no <tt>make</tt> is installed, or your <tt>path</tt> is not configured correctly.</p> +<pre>'g++' (or 'make') is not recognized as an internal or external command, operable program or batch file</pre> +<p>To check the environment variable <tt>path</tt> for correctness, open a command prompt and type <tt>PATH</tt>. Make sure that the path to your build utility is defined (example <tt>PATH=c:\cygwin\bin</tt>).<p> +<h3>Build Automatically</h3> +<p>For C/C++ projects the <b>Build Automatically</b> feature should be turned off, otherwise builds will be performed whenever a file is saved, including makefiles and header files.</p> +<p>Click <b>Projects</b> from the menubar and ensure there is no checkmark beside the <b>Build Automatically</b> menu item. If there is one, click <b>Build Automatically</b> to deselect it.</p> <p align="left"> <img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"> <br> <a href="../concepts/cdt_o_home.htm">CDT Home</a><br> <p align="left"> <img border="0" src="../images/ngtasks.gif" ALT="Related tasks"> <br> - <a href="../tasks/cdt_t_manualbuild.htm">Building Manually</a><br> - - + <a href="../tasks/cdt_t_manualbuild.htm">Building Manually</a> </p> <p><img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" > </p> diff --git a/doc/org.eclipse.cdt.doc.user/concepts/cdt_o_home.htm b/doc/org.eclipse.cdt.doc.user/concepts/cdt_o_home.htm index 2b3a05bb4b2..721974090b6 100644 --- a/doc/org.eclipse.cdt.doc.user/concepts/cdt_o_home.htm +++ b/doc/org.eclipse.cdt.doc.user/concepts/cdt_o_home.htm @@ -15,12 +15,13 @@ <p>This guide provides instructions for using the C/C++ Development Toolkit (CDT) in the workbench.</p> +<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_c_before_you_begin.htm">Before you begin</a><br> +<br> <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="../getting_started/cdt_o_tutorial.htm">Getting Started</a><br> <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_o_concepts.htm">Concepts</a><br> <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="../tasks/cdt_o_tasks.htm">Tasks</a><br> <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="../reference/cdt_o_ref.htm">Reference</a><br> <br> -<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_c_before_you_begin.htm">Before you begin</a><br> <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_c_whatsnew.htm">What's new</a><br> diff --git a/doc/org.eclipse.cdt.doc.user/contexts_CDT_LAUNCH.xml b/doc/org.eclipse.cdt.doc.user/contexts_CDT_LAUNCH.xml index a603e9bf8c3..858bacb2161 100644 --- a/doc/org.eclipse.cdt.doc.user/contexts_CDT_LAUNCH.xml +++ b/doc/org.eclipse.cdt.doc.user/contexts_CDT_LAUNCH.xml @@ -54,7 +54,7 @@ <context id ="run_dbg_comm"> <description>Click below to see help.</description> - <topic href="reference/run_dbg_comm" + <topic href="reference/cdt_u_run_dbg_comm" label="Common"/> </context> diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_new_brk_action.png b/doc/org.eclipse.cdt.doc.user/images/cdt_new_brk_action.png Binary files differnew file mode 100644 index 00000000000..9ff87eb97c0 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/images/cdt_new_brk_action.png diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_pref_brk_action.png b/doc/org.eclipse.cdt.doc.user/images/cdt_pref_brk_action.png Binary files differnew file mode 100644 index 00000000000..91ab8376839 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/images/cdt_pref_brk_action.png diff --git a/doc/org.eclipse.cdt.doc.user/images/cdt_pref_brk_action_properties.png b/doc/org.eclipse.cdt.doc.user/images/cdt_pref_brk_action_properties.png Binary files differnew file mode 100644 index 00000000000..7f113aadb1d --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/images/cdt_pref_brk_action_properties.png diff --git a/doc/org.eclipse.cdt.doc.user/images/icon_load_all_modules.png b/doc/org.eclipse.cdt.doc.user/images/icon_load_all_modules.png Binary files differnew file mode 100644 index 00000000000..86d532ddfb7 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/images/icon_load_all_modules.png diff --git a/doc/org.eclipse.cdt.doc.user/images/nokia2007Copyright.png b/doc/org.eclipse.cdt.doc.user/images/nokia2007Copyright.png Binary files differnew file mode 100644 index 00000000000..2f43e48c602 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/images/nokia2007Copyright.png diff --git a/doc/org.eclipse.cdt.doc.user/images/view_modules.png b/doc/org.eclipse.cdt.doc.user/images/view_modules.png Binary files differnew file mode 100644 index 00000000000..004fa6e3d13 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/images/view_modules.png diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_brkpt_actions.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_brkpt_actions.htm new file mode 100644 index 00000000000..7e0b1325211 --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_dbg_brkpt_actions.htm @@ -0,0 +1,51 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<html lang="en"> + +<head> + <meta http-equiv="Content-Language" content="en-us"> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> + <title>Breakpoint Actions preferences</title> + <link rel="stylesheet" type="text/css" href="../help.css"> +</head> +<body> + +<h1>Breakpoint Actions preferences</h1> + +<p>Use the <b>Breakpoint Actions</b> page in the Preferences window to create, edit, and remove breakpoint actions. The breakpoint actions defined here are available to all projects in the current workspace.</p> +<p><img src="../images/cdt_pref_brk_action.png" width="581" height="527"></p> + +<table width="600px" cellpadding="5" cellspacing="0" border="1" > + <caption><b>Breakpoint Actions Preference Options</b></caption> + <colgroup> + <col width="30%" valign="top" > + <col width="70%" valign="top" > + </colgroup> + <tbody> + <tr> + <td width="30%" valign="top"><dt>New...</dt></td> + <td valign="top"><p>To create a new breakpoint action, click <b>New</b>. </p> + </td> + </tr> + <tr> + <td width="30%" valign="top"><dt>Edit...</dt></td> + <td valign="top">To edit the currently selected action, click <b>Edit</b>. In the Action dialog box that appears, edit the action settings, then click <b>OK</b>. </td> + </tr> + <tr> + <td width="30%" valign="top"><dt>Delete</dt></td> + <td valign="top">To delete the currently selected action, click <b>Delete</b>. </td> + </tr> + </tbody> +</table> + +<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21"> <br> + <a href="../concepts/cdt_c_over_cdt.htm">C/C++ Development perspective</a></p> +<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"> <br> + <a href="../tasks/cdt_o_brkpnts_watch.htm">Working with breakpoints, watchpoints, and breakpoint actions</a></p> +<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"> <br> + <a href="cdt_u_debug.htm">Debug preferences</a></p> +<hr> +<img src="../images/nokia2007Copyright.png" ALT="Nokia Copyright Notice" > + +</body> + +</html> diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_modules_view.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_modules_view.htm index fe5560c528a..17718e51d0b 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_modules_view.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_modules_view.htm @@ -4,7 +4,6 @@ <head> <meta http-equiv="Content-Language" content="en-us"> <meta name="GENERATOR" content="Microsoft FrontPage 5.0"> -<meta name="ProgId" content="FrontPage.Editor.Document"> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Shared Libraries view</title> <link rel="stylesheet" type="text/css" href="../help.css"> @@ -15,23 +14,60 @@ <h1>Modules view</h1> -<p>The Modules view of the Debug +<p>The <b>Modules</b> view of the Debug perspective lets you view information about the modules loaded in the current debug session, including executables and shared libraries. The view consists of two areas: the modules tree and the detail pane. The detail pane displays the detail information for the module selected in the modules tree. Expanding a -module users can view the module's internals - functions, global variables, associated +module enables users to view the module's internals - functions, global variables, associated source files, etc.</p> -<dl> -<dt><b>Load Symbols</b></dt> -<dd>Loads the symbols of the module. The -symbols will be loaded from the file specified in the module's properties.</dd> +<img src="../images/view_modules.png" alt="Modules view"></img> + +<h3>Modules view toolbar icons</h3> + +<p>The table below lists the icons displayed in the Modules view toolbar.</p> + +<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600"> +<tr> + <td width="10%" align="left"><b>Command</b></td> + <td width="30%"><b>Name</b></td> + <td width="60%"><b>Description</b></td> +</tr> +<tr> + <td><img border="0" src="../images/icon_load_all_modules.png"></td> + <td>Load Symbols for All Modules</td> + <td>Loads the symbols of the all modules involved in the current session. This option does not affect the modules whose symbols are already loaded.</td> +</tr> +</table> + +<h3>Modules view context menu commands</h3> + +<p>The table below lists the Modules context menu commands.</p> + +<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600"> +<tr> + <td width="10%" align="left"><b>Command</b></td> + <td width="30%"><b>Name</b></td> + <td width="60%"><b>Description</b></td> +</tr> +<tr> + <td><img border="0" src="../images/icon_load_all_modules.png"></td> + <td>Load Symbols for All</td> + <td>Loads the symbols of the all modules involved in the current session. This option does not affect the modules whose symbols are already loaded.</td> +</tr> +<tr> + <td><img border="0" src="../images/icon_load_all_modules.png"></td> + <td>Load Symbols</td> + <td>Loads the symbols of the module. The symbols will be loaded from the file specified in the module's properties.</td> +</tr> +<tr> + <td> </td> + <td>Properties...</td> + <td>Opens the Properties dialog for the module.</td> +</tr> +</table> -<dt><b>Load Symbols For All</b></dt> -<dd>Loads the symbols of the all modules involved in the current session. This option does not affect -the modules whose symbols are already loaded.</dd> -</dl> <p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21"> <br> <a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p> diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm index f5d047afb99..72e35f6af71 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm @@ -20,7 +20,7 @@ that an application uses and the working directory for a run or debug configurat <p /> <dl> <table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" > -<tr bgcolor="#CCC"><th>Component</th><th>Description</th></tr> +<tr ><th>Component</th><th>Description</th></tr> <tr><td width="30%"><dt>Program arguments</dt></td><td>Specifies the arguments that are passed on the command line.</td></tr> <tr><td><dt>Variables...</dt></td><td>Select variables by name to include in the program arguments list.</td></tr> <tr><td><dt>Working directory</dt></td><td>Specifies the run/debug configuration working directory.</td></tr> diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm index b4b4d64a44a..9544140cd23 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm @@ -20,7 +20,7 @@ the location in which to store your run configuration and how you access it, how <p /> <dl> <table width="580" border="1" cellpadding="2" cellspacing="0" > -<tr bgcolor="#CCC"><th>Component</th><th>Description</th></tr> +<tr><th>Component</th><th>Description</th></tr> <tr><td width="30%"><dt>Local file</dt></td><td>Saves the launch configuration locally.</td></tr> <tr><td><dt>Shared file</dt></td><td>Specifies the path of, or browse to, a workspace to store the launch configuration file, and be able to commit it to CVS.</td></tr> <tr><td><dt>Display in favorites menu</dt></td><td>Add configuration name to Run or Debug menus for easy selection.</td></p></tr> diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_dbg.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_dbg.htm index 3bb3d830253..407a93a355c 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_dbg.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_dbg.htm @@ -19,7 +19,7 @@ <p /> <dl> <table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" > -<tr bgcolor="#CCC"><th>Component</th><th>Description</th></tr> +<tr ><th>Component</th><th>Description</th></tr> <tr><td width="30%"><dt>Debugger</dt></td><td>Selects debugger type from the list.</td></tr> <tr><td><dt>Stop on startup at</dt></td><td>Stops program at specified location.</td></tr> <tr><td valign="top"><dt>Advanced</dt></td><td>Opens the Advanced Options dialog.<br><p><img src="../images/run_debug_debugger_advopt.png" /> diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_env.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_env.htm index 1e76a905d4d..b9cdcc2b6ac 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_env.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_env.htm @@ -20,7 +20,7 @@ set environment variables and values to use when an application runs.</p> <p /> <dl> <table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" > -<tr bgcolor="#CCC"><th>Component</th><th>Description</th></tr> +<tr ><th>Component</th><th>Description</th></tr> <tr><td width="30%"><dt>Name</dt></td><td>Displays the name of environment variables.</td></tr> <tr><td><dt>Value</dt></td><td>Displays the value of environment variables.</td></tr> <tr><td><dt>New</dt></td><td>Creates a new environment variable.</td></tr> diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_main.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_main.htm index 934e2ce266f..299cc043887 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_main.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_main.htm @@ -19,7 +19,7 @@ <p /> <dl> <table width="640" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" > -<tr bgcolor="#CCC"><th>Component</th><th>Description</th></tr> +<tr ><th>Component</th><th>Description</th></tr> <tr><td width="30%"><dt>Project</dt></td><td>Specifies the name of the project.</td></tr> <tr><td><dt>C/C++ Application</dt></td><td>Specifies the name of the application.</td></tr> <tr><td><dt>Search Project...</dt></td><td>Specifies the binary or binaries to run within the project.</td></tr> diff --git a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm index 7bde34dd761..2b922ca73da 100644 --- a/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm +++ b/doc/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm @@ -21,7 +21,7 @@ application. By default, this information is taken from the build path of your p <p /> <dl> <table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" > -<tr bgcolor="#CCC"><th>Component</th><th>Description</th></tr> +<tr ><th>Component</th><th>Description</th></tr> <tr><td width="30%"><dt>Add</dt></td><td>Adds new source containers to the Source Lookup Path search list.</td></tr> <tr><td><dt>Edit...</dt></td><td>Modifies the content of the selected source container.</td></tr> <tr><td><dt>Remove</dt></td><td>Removes selected items from the Source Lookup Path list.</td></p></tr> diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_brkpnts_watch.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_brkpnts_watch.htm index 12da2defd38..21f73740255 100644 --- a/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_brkpnts_watch.htm +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_o_brkpnts_watch.htm @@ -4,23 +4,24 @@ <head> <meta http-equiv="Content-Language" content="en-us"> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>Working with breakpoints and watchpoints</title> +<title>Working with breakpoints, watchpoints, and breakpoint actions</title> <link rel="stylesheet" type="text/css" href="../help.css"> </head> <body> -<h1>Working with breakpoints and watchpoints</h1> +<h1>Working with breakpoints, watchpoints, and breakpoint actions</h1> -<p>This section explains how to work with breakpoints and watchpoints.</p> +<p>This section explains how to work with Working with breakpoints, watchpoints, and breakpoint actions.</p> - <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_add_brkpnts.htm">Adding breakpoints</a><br> - <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_add_watch.htm">Adding watchpoints</a><br> - <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_rem_wtch_brk.htm">Removing breakpoints and watchpoints</a><br> - <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_endis_able_brk_wtch.htm">Enabling and disabling breakpoints and watchpoints</a><br> - - -<p><img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" ></p> + <p><img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_add_brkpnts.htm">Adding breakpoints</a><br> + <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_add_watch.htm">Adding watchpoints</a><br> + <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_add_brk_action.htm">Adding breakpoint actions</a><br> + <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_rem_wtch_brk.htm">Removing breakpoints and watchpoints</a><br> + <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_endis_able_brk_wtch.htm">Enabling and disabling breakpoints and watchpoints</a><br> + <img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_addrmv_brk_action.htm">Attaching or removing breakpoint actions</a><br> +</p> + <p><img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" ></p> </body> diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_add_brk_action.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_add_brk_action.htm new file mode 100644 index 00000000000..89d48a6bc7b --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_add_brk_action.htm @@ -0,0 +1,48 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<html lang="en"> + +<head> +<meta http-equiv="Content-Language" content="en-us"> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Adding breakpoint actions</title> +<link rel="stylesheet" type="text/css" href="../help.css"> +</head> + +<body> + +<h1>Adding breakpoint actions</h1> + +<p>To add a new breakpoint action:</p> +<ol> + <li>Click <b>Window > Preferences</b>.</li> + <li>Expand <b>C/C++ > Debug</b> and click <b>Breakpoint Actions</b>.<img src="../images/cdt_pref_brk_action.png" width="581" height="527"></li> + <li>In the <b>Breakpoint Actions</b> page, click <b>New</b>. <br> + <img src="../images/cdt_new_brk_action.png" width="500" height="375"><br> + </li> + <li>In the <b>New Breakpoint Action</b> dialog box, type a name for the action in the <b>Action name</b> box.</li> + <li>Select an action from the <b>Action type</b> list. </li> + <li>Set the action's attributes: </li> + <ul> + <li>For a sound action, select a sound file.</li> + <li>For a log action, type a message. </li> + <li>For a resume action, set the <b>Resume after</b> time in seconds. </li> + <li>For an external tool action, click <b>Choose</b> to select a program.</li> + </ul> + <li>Click <b>OK</b>. </li> +</ol> +<p>The new breakpoint actions appears in the <b>Actions available for any breakpoint in the workspace </b> list. </p> +<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21"> +<br> +<a href="../concepts/cdt_c_over_cdt.htm">C/C++ Development perspective</a></p> +<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"> + <br> + <a href="cdt_o_brkpnts_watch.htm">Working with breakpoints, watchpoints, and breakpoint actions</a></p> +<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"> +<br> +<a href="../reference/cdt_u_debug.htm">Debug preferences</a></p> +<hr> +<img src="../images/nokia2007Copyright.png" ALT="Nokia Copyright Statement" > + +</body> + +</html> diff --git a/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_addrmv_brk_action.htm b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_addrmv_brk_action.htm new file mode 100644 index 00000000000..44cb062a8fa --- /dev/null +++ b/doc/org.eclipse.cdt.doc.user/tasks/cdt_t_addrmv_brk_action.htm @@ -0,0 +1,54 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN" > +<html lang="en"> + +<head> +<meta http-equiv="Content-Language" content="en-us"> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<title>Attaching or removing breakpoint actions</title> +<link rel="stylesheet" type="text/css" href="../help.css"> +</head> + +<body> + +<h1>Attaching or removing breakpoint actions</h1> + +<p>You can attach one or more breakpoint actions to a single breakpoint. For example, when the breakpoint is hit you could both log a message and play a sound. Actions are executed in the order they appear in the <b>Actions for this breakpoint</b> list. </p> +<p>To attach or remove a breakpoint action from a breakpoint: </p> +<ol> + <li>In the <b>Breakpoints</b> view, right-click the breakpoint, and select <b>Properties</b>.</li> + <li>In the <b>Properties for C/C++ Breakpoint </b> dialog box, click <b>Actions</b>.<br> + <img src="../images/cdt_pref_brk_action_properties.png" alt="Actions page in Breakpoint Properties Dialog Box" width="605" height="527"></li> + <li>In the <b>Available actions</b> list: + <ul> + <li>Select an action and click <b>Attach</b> to link it to the breakpoint. Repeat as required. </li> + <li>To add a new breakpoint action, click <b>New</b>.</li> + <li>To edit the selected breakpoint action, click <b>Edit</b>.</li> + <li>To delete the selected action, click <b>Delete</b>. <br> + <p><b>NOTE</b>: Deleting a breakpoint action removes it from the workspace. </p> + </li> + </ul> + </li> + + <li>In the <b>Actions for this breakpoint</b> list you can: + <ul> + <li>Click <b>Remove</b> to delete the selected action from the list.</li> + <li>Click <b>Up</b> to move the selected action up in the list.</li> + <li>Click <b>Down</b> to move the selected action down in the list.</li> + </ul> + </li> + + <li>Click <b>OK</b>.</li> +</ol> + +<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21"> + <br> + <a href="cdt_o_brkpnts_watch.htm">Working with breakpoints, watchpoints, and breakpoint actions</a></p> +<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"> +<br> +<a href="../reference/cdt_u_debug.htm">Debug preferences</a></p> +<hr> +<img src="../images/nokia2007Copyright.png" ALT="Nokia Copyright Statement" > + +</body> + +</html> diff --git a/doc/org.eclipse.cdt.doc.user/toc.xml b/doc/org.eclipse.cdt.doc.user/toc.xml index 0f21698da30..5f0bc02da79 100644 --- a/doc/org.eclipse.cdt.doc.user/toc.xml +++ b/doc/org.eclipse.cdt.doc.user/toc.xml @@ -4,18 +4,22 @@ <toc id="cdt" label="C/C++ Development User Guide" topic="concepts/cdt_o_home.htm"> -<topic label="Getting Started" href="getting_started/cdt_o_tutorial.htm"> + <topic label="Before you begin" href="concepts/cdt_c_before_you_begin.htm"/> + + <topic label="Getting Started" href="getting_started/cdt_o_tutorial.htm"> <link toc="topics_Getting_Started.xml" /> </topic> -<topic label="Concepts" href="concepts/cdt_o_concepts.htm"> + + <topic label="Concepts" href="concepts/cdt_o_concepts.htm"> <link toc="topics_Concepts.xml" /> </topic> -<topic label="Tasks" href="tasks/cdt_o_tasks.htm"> + + <topic label="Tasks" href="tasks/cdt_o_tasks.htm"> <link toc="topics_Tasks.xml" /> </topic> -<topic label="Reference" href="reference/cdt_o_ref.htm"> + + <topic label="Reference" href="reference/cdt_o_ref.htm"> <link toc="topics_Reference.xml" /> </topic> -<topic label="Before you begin" href="concepts/cdt_c_before_you_begin.htm"/> <topic label="What's new" href="concepts/cdt_c_whatsnew.htm"/> </toc> diff --git a/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml b/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml index c00be683927..cacbe914830 100644 --- a/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml +++ b/doc/org.eclipse.cdt.doc.user/topics_Tasks.xml @@ -57,15 +57,20 @@ <topic label="Specifying the location of source files" href="tasks/cdt_t_run_source.htm"/> <topic label="Specifying the location of the run configuration" href="tasks/cdt_t_run_com.htm"/> </topic> + <topic label="Debugging" href="tasks/cdt_o_debug.htm"> <topic label="Debugging a program" href="tasks/cdt_t_debug_prog.htm"/> <topic label="Debugging an existing executable" href="tasks/cdt_t_debug_exes.htm"/> - <topic label="Working with breakpoints and watchpoints" href="tasks/cdt_o_brkpnts_watch.htm"> + + <topic label="Working with breakpoints, watchpoints, and breakpoint actions" href="tasks/cdt_o_brkpnts_watch.htm"> <topic label="Adding breakpoints" href="tasks/cdt_t_add_brkpnts.htm"/> <topic label="Adding watchpoints" href="tasks/cdt_t_add_watch.htm"/> + <topic label="Adding breakpoint actions" href="tasks/cdt_t_add_brk_action.htm"/> <topic label="Removing breakpoints and watchpoints" href="tasks/cdt_t_rem_wtch_brk.htm"/> <topic label="Enabling or disable breakpoints and watchpoints" href="tasks/cdt_t_endis_able_brk_wtch.htm"/> + <topic label="Attaching or removing breakpoint actions" href="tasks/cdt_t_addrmv_brk_action.htm"/> </topic> + <topic label="Controlling debug execution" href="tasks/cdt_t_controldebug.htm"/> <topic label="Stepping into assembler funcitons" href="tasks/cdt_t_disassembly.htm"/> <topic label="Working with variables" href="tasks/cdt_t_variables.htm"/> @@ -74,6 +79,7 @@ <topic label="Working with memory" href="tasks/cdt_t_memory.htm"/> </topic> </topic> + <topic label="Searching the CDT" href="tasks/cdt_t_search.htm"> <topic label="Selection Search for C/C++ elements" href="tasks/cdt_t_sel_search.htm"/> <topic label="Setting Source Folders" href="tasks/cdt_t_set_src_fold.htm"/> |