--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/autotargeting.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/autotargeting.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,20 +1,20 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Auto-Targeting of Executables</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Auto-Targeting of Executables</h2>
-<p>In run-mode debugger now supports the auto-targeting of processes that are already running or are created during the execution of the debug session. Previously, the debugger forced users to explicitly attach to a running process. Now, the debugger attempts to target all the EXEs specified in the <a href="../reference/launch_configs/page_executables.htm">Executables</a> tab of the launch configuration. </p>
-<ul>
- <li>If the executables are already started, it gets the load address of the executable and targets it for debugging, resolving any breakpoints it finds.</li>
- <li>The debugger will target any executable not already started whenever a "process load" event occurs, resolving its breakpoints as well.</li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Auto-Targeting of Executables</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Auto-Targeting of Executables</h2>
+<p>In run-mode debugger now supports the auto-targeting of processes that are already running or are created during the execution of the debug session. Previously, the debugger forced users to explicitly attach to a running process. Now, the debugger attempts to target all the EXEs specified in the <a href="../projects/launch/page_executables.htm">Executables</a> tab of the launch configuration. </p>
+<ul>
+ <li>If the executables are already started, it gets the load address of the executable and targets it for debugging, resolving any breakpoints it finds.</li>
+ <li>The debugger will target any executable not already started whenever a "process load" event occurs, resolving its breakpoints as well.</li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/common_debug_actions.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/common_debug_actions.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,33 +1,33 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Common Debugging Actions</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Common Debugging Actions</h2>
-<p> This section explains how to perform common debugging actions within the <a href="../reference/perspective_debug.htm">Debug perspective</a> to correct source-code errors, control program execution, and observe memory behavior:</p>
-<ul>
- <li><a href="../tasks/debugger/work_debug_act_start.htm">Start</a> the debugger</li>
- <li>Step <a href="../tasks/debugger/work_debug_act_stepinto.htm">into</a>, <a href="../tasks/debugger/work_debug_act_stepout.htm">out</a> of, or <a href="../tasks/debugger/work_debug_act_stepover.htm">over</a> routines</li>
- <li><a href="../tasks/debugger/work_debug_act_stop.htm">Suspend</a>, <a href="../tasks/debugger/work_debug_act_resume.htm">resume</a>, or <a href="../tasks/debugger/work_debug_act_kill.htm">terminate</a> program execution</li>
- <li><a href="../tasks/debugger/work_debug_act_run.htm">Run</a> the program</li>
- <li><a href="../tasks/debugger/work_debug_act_restart.htm">Restart</a> the debugger</li>
-</ul>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="debugger_about.htm">About the Carbide.c++ Debugger</a></li>
-</ul>
-<h5>Related references</h5>
-<ul>
- <li><a href="../tasks/projects/prj_debug_config.htm">Debugger Configuration</a></li>
- <li><a href="../reference/launch_configs/emulator_debugger.htm">Debugger Pane </a></li>
- <li><a href="../reference/wnd_debugger_prefs.htm">Debugger Preferences</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Common Debugging Actions</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Common Debugging Actions</h2>
+<p> This section explains how to perform common debugging actions within the <a href="../reference/perspective_debug.htm">Debug perspective</a> to correct source-code errors, control program execution, and observe memory behavior:</p>
+<ul>
+ <li><a href="../debugger/debug/cmds_starting.htm">Start</a> the debugger</li>
+ <li>Step <a href="../debugger/debug/cmds_stepping.htm">into</a>, <a href="../debugger/debug/cmds_stepping.htm">out</a> of, or <a href="../debugger/debug/cmds_stepping.htm">over</a> routines</li>
+ <li><a href="../debugger/debug/cmds_starting.htm">Suspend</a>, <a href="../debugger/debug/cmds_resuming.htm">resume</a>, or <a href="../debugger/debug/cmds_starting.htm">terminate</a> program execution</li>
+ <li><a href="../debugger/debug/cmds_resuming.htm">Run</a> the program</li>
+ <li><a href="../debugger/debug/cmds_resuming.htm">Restart</a> the debugger</li>
+</ul>
+<h5>Related concepts</h5>
+<ul>
+ <li><a href="debugger_about.htm">About the Carbide.c++ Debugger</a></li>
+</ul>
+<h5>Related references</h5>
+<ul>
+ <li><a href="../tasks/projects/prj_debug_config.htm">Debugger Configuration</a></li>
+ <li><a href="../projects/launch/page_debugger.htm">Debugger Pane </a></li>
+ <li><a href="../reference/wnd_debugger_prefs.htm">Debugger Preferences</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm Mon Aug 10 15:50:55 2009 -0500
@@ -9,21 +9,42 @@
</head>
<body bgcolor="#FFFFFF">
<h2>Concepts</h2>
-<p>The following concepts provide information on common Carbdie.c++ terminology, technologies, and processes:</p>
+<p>This section of the User Guide provides an overview of the main concepts in
+Carbide to create and build programs for Symbian OS. </p>
+<p> The Symbian OS plug-ins are a set of Eclipse plug-ins that provide project,
+ SDK and build support for Symbian OS developers. The plug-ins extend the
+ functionality provided by Eclipse and the C/C++ Development Toolkit (CDT). </p>
+<p> The plug-ins simplify Symbian OS development by removing the need to use
+ command line build tools, and provide a graphical interface to Symbian OS
+ specific file formats, such as AIF and MBM. </p>
+<p> The plug-ins provide a new perspective, called the Carbide.c++ Perspective, on
+ the Eclipse workbench. This perspective enhances the standard CDT C/C++
+ perspective by allowing you to select easily the SDKs and build target types
+ that you want to use for each project. </p>
+<p> The following topics discuss these concepts in more detail: </p>
<ul>
<li><a href="build_configurations.htm">Active Build Configuration</a></li>
<li><a href="AIFDefWizard.html">AIF File</a></li>
<li><a href="breakpoints.htm">Breakpoints</a></li>
<li><a href="build_targets.htm">Build Targets</a></li>
+ <li><a href="macros_carbide.htm">Carbide Macros</a></li>
<li><a href="cvs.htm">Concurrent Versions System (CVS)</a></li>
<li><a href="contextual_menus.htm">Context menu support</a></li>
+ <li><a href="dependency_tracking.htm">Dependency Tracking</a></li>
<li><a href="emulators.htm">Emulation Debugging</a></li>
+ <li><a href="ext_build_support.htm">External Builds Support</a></li>
<li><a href="../projects/launch/launch_configs_overview.htm">Launch Configurations</a></li>
- <li><a href="registers.htm">Registers</a></li>
<li><a href="MBMDefWizard.html">MBM File</a></li>
<li><a href="mmpfiles.htm">MMP Files</a></li>
+ <li><a href="ngage_projects.htm">N-Gage Projects</a></li>
<li><a href="trk.htm">On-device Debugging</a></li>
+ <li><a href="precompiled_headers.htm">Precompiled Headers</a></li>
+ <li><a href="registers.htm">Registers</a></li>
+ <li><a href="../tasks/WorkingwithSDKs.html">SDK Support</a></li>
+ <li><a href="symbol_hints.htm">Symbol Hint</a></li>
+ <li><a href="symbols_pkg.htm">Symbols, .pkg</a></li>
<li><a href="watchpoints.htm">Watchpoints</a></li>
+ <li><a href="workspaces.htm">Workspace Information</a></li>
</ul>
<div class="step">
<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/contextual_menus.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/contextual_menus.htm Mon Aug 10 15:50:55 2009 -0500
@@ -14,7 +14,7 @@
<ul>
<li>Editor views - perform editing functions, format, compare, and a host of other file actions </li>
<li><a href="../reference/view_breakpoints.htm">Breakpoints</a> view - enable, disable, remove, or select all breakpoints</li>
- <li><a href="../reference/view_debug.htm">Debug</a> view - restart, step into, over, or out of routines, terminate or suspend program execution </li>
+ <li><a href="../debugger/debug/viewing_debug.htm">Debug</a> view - restart, step into, over, or out of routines, terminate or suspend program execution </li>
<li><a href="../reference/view_memory_wnd.htm">Memory</a> view - add or remove memory monitors </li>
<li><a href="../reference/view_cpp_projects.htm">Project Explorer</a> view - manage projects, build, delete, freeze, run, debug, and other common project commands</li>
<li><a href="../reference/view_variables.htm">Variables</a> view - enable, disable, find, and change the format or value of variables displayed</li>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/debugger_about.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/debugger_about.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,49 +1,49 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>About the Carbide Debugger</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>About the Carbide.c++ Debugger</h2>
-<p> A debugger controls program execution and shows the internal operation of a computer program. Use the debugger to find problems while the program executes. Also use the debugger to observe how a program uses memory to complete tasks.</p>
-<p>The Carbide.c++ debugger provides these levels of control over a computer program:</p>
-<ul>
- <li>Execution of one statement at a time</li>
- <li>Suspend execution after reaching a specific point in the program</li>
- <li>Suspend execution after changing a specified memory value</li>
- <li>Suspend any running thread from the stack crawl in the Debug view</li>
-</ul>
-<p>After the debugger suspends program execution, use the <a href="../reference/perspective_debug.htm">Debug</a> perspective to perform these tasks:</p>
-<ul>
- <li><a href="../reference/view_debug.htm">View</a> the function-call chain</li>
- <li><a href="../reference/view_variables.htm">Manipulate</a> variable values</li>
- <li><a href="../reference/view_registers.htm">View</a> register values in the computer processor</li>
-</ul>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="working_with_debugger.htm">Working with the Debugger </a></li>
-</ul>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="../tasks/debugger/work_debug_act_resume.htm">Resume</a></li>
- <li><a href="../tasks/debugger/work_debug_act_stop.htm">Suspend</a></li>
- <li><a href="../tasks/debugger/work_debug_act_kill.htm">Terminate</a></li>
- <li><a href="../tasks/debugger/work_debug_act_restart.htm">Restart</a></li>
- <li><a href="../tasks/debugger/work_debug_act_stepinto.htm">Step Into</a></li>
- <li><a href="../tasks/debugger/work_debug_act_stepover.htm">Step Over</a></li>
- <li><a href="../tasks/debugger/work_debug_act_stepout.htm">Step Return</a> </li>
-</ul>
-<h5>Related references</h5>
-<ul>
- <li><a href="../tasks/projects/prj_debug_config.htm">Debugger Configuration</a></li>
- <li><a href="../reference/launch_configs/emulator_debugger.htm">Debugger Pane </a></li>
- <li><a href="../reference/wnd_debugger_prefs.htm">Debugger Preferences</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>About the Carbide Debugger</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>About the Carbide.c++ Debugger</h2>
+<p> A debugger controls program execution and shows the internal operation of a computer program. Use the debugger to find problems while the program executes. Also use the debugger to observe how a program uses memory to complete tasks.</p>
+<p>The Carbide.c++ debugger provides these levels of control over a computer program:</p>
+<ul>
+ <li>Execution of one statement at a time</li>
+ <li>Suspend execution after reaching a specific point in the program</li>
+ <li>Suspend execution after changing a specified memory value</li>
+ <li>Suspend any running thread from the stack crawl in the Debug view</li>
+</ul>
+<p>After the debugger suspends program execution, use the <a href="../reference/perspective_debug.htm">Debug</a> perspective to perform these tasks:</p>
+<ul>
+ <li><a href="../debugger/debug/viewing_debug.htm">View</a> the function-call chain</li>
+ <li><a href="../reference/view_variables.htm">Manipulate</a> variable values</li>
+ <li><a href="../reference/view_registers.htm">View</a> register values in the computer processor</li>
+</ul>
+<h5>Related concepts</h5>
+<ul>
+ <li><a href="working_with_debugger.htm">Working with the Debugger </a></li>
+</ul>
+<h5>Related tasks</h5>
+<ul>
+ <li><a href="../debugger/debug/cmds_resuming.htm">Resume</a></li>
+ <li><a href="../debugger/debug/cmds_starting.htm">Suspend</a></li>
+ <li><a href="../debugger/debug/cmds_starting.htm">Terminate</a></li>
+ <li><a href="../debugger/debug/cmds_resuming.htm">Restart</a></li>
+ <li><a href="../debugger/debug/cmds_stepping.htm">Step Into</a></li>
+ <li><a href="../debugger/debug/cmds_stepping.htm">Step Over</a></li>
+ <li><a href="../debugger/debug/cmds_stepping.htm">Step Return</a> </li>
+</ul>
+<h5>Related references</h5>
+<ul>
+ <li><a href="../tasks/projects/prj_debug_config.htm">Debugger Configuration</a></li>
+ <li><a href="../projects/launch/page_debugger.htm">Debugger Pane </a></li>
+ <li><a href="../reference/wnd_debugger_prefs.htm">Debugger Preferences</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/index.html Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,44 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head>
-<title>Concepts in Symbian OS Eclipse Development User Guide</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
- </head>
- <body>
- <h2>Concepts</h2>
- <div class="Bodytext">
-
-
- <p>
- This section of the User Guide provides an overview of the main concepts in
- Eclipse to create and build programs for Symbian OS.
- </p>
- <p>
- The Symbian OS plug-ins are a set of Eclipse plug-ins that provide project,
- SDK and build support for Symbian OS developers. The plug-ins extend the
- functionality provided by Eclipse and the C/C++ Development Toolkit (CDT).
- </p>
- <p>
- The plug-ins simplify Symbian OS development by removing the need to use
- command line build tools, and provide a graphical interface to Symbian OS
- specific file formats, such as AIF and MBM.
- </p>
- <p>
- The plug-ins provide a new perspective, called the Carbide.c++ Perspective, on
- the Eclipse workbench. This perspective enhances the standard CDT C/C++
- perspective by allowing you to select easily the SDKs and build target types
- that you want to use for each project.
- </p>
- <p>
- The following topics discuss these concepts in more detail:
- </p>
- <ul>
-<li><a href="../tasks/WorkingwithSDKs.html">SDK Support</a></li>
-<li><a href="CarbidePerspective.html">Carbide.c++ Perspective</a></li>
-<li><a href="AIFDefWizard.html">AIF File</a></li>
-<li><a href="MBMDefWizard.html">MBM File</a></li>
-</ul>
-</div>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
- </body>
- </html>
-
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/ngage_projects.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/ngage_projects.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,101 +1,101 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>N-Gage Projects</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>N-Gage Projects</h2>
-<p>Carbide.c++ supports the importing of N-Gage projects. However, there are some process issues that effect how you can debug game projects on devices. The following provides a high level overview of the process you should follow to successfully import, build, deploy, and debug an N-Gage game on a device. </p>
-<h4>Importing N-Gage projects</h4>
-<p>To start, import your game project into Carbide:</p>
-<ol>
- <li>Install the N-Gage SDK on your PC</li>
- <li>Place your game project inside the N-Gage SDK</li>
- <li> In Carbide.c++, click<b> File > <a href="../tasks/ImportingProjects.html">Import</a></b></li>
- <li>Select <b>Symbian OS Bld.inf</b> importer and navigate to your bld.inf file to import it </li>
-</ol>
-<h4>Building the N-Gage project</h4>
-<p>Once the game project has been imported, use these steps to create an N-GAGE game file:</p>
-<ol>
- <li>Right-click the project and choose <b>Properties</b> to open the <b>Properties for <i>project_name</i></b> window </li>
- <li>In the <b>Carbide.c++ > Carbide Build Configuration > <a href="../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a></b> panel, click <b>Add</b>.</li>
- <li>In the <b><a href="../reference/build_properties/wnd_sis_properties.htm">SIS Properties</a></b> window:
- <ol>
- <li>Specify the project and metadata PKG files to build</li>
- <li>Enable the<b> Sign sis file with certificate/key pair</b> for each PKG file </li>
- <li>Select the certificate/key given to you by the Nokia R&D Certificate Service</li>
- <li>Click <b>OK</b></li>
- </ol>
- </li>
- <li>If using a batch file to build the N-Gage installation, create a new builder within Carbide by opening the <b>Properties for <i>project_name</i> > Builders</b> panel and click <b>New</b>. </li>
-<p align="center"><img src="images/pane_builders_properties.png" width="682" height="208"></p>
-<p align="center" class="figure">Figure 1 - Builders pane in project Properties dialog</p>
- <li>Open the <b>Properties for <i>project_name</i> > Builders</b> panel</li>
- <li>Click <b>New</b></li>
- <li>Select <b>Program</b> in the <b>Choose configuration type</b> window, click <b>OK</b> </li>
- <p align="center"><img src="images/wnd_properties_for_builder.png" width="800" height="640"></p>
- <p align="center" class="figure">Figure 2 - <b>Properties for N-Gage Builder</b> dialog</p>
- <li>In the <b>Properties for New_Builder</b> window
- <b>Main</b> tab:
- <ul>
- <li>Define the builder name in the <b>Name</b> text box</li>
- <li>Specify the <b>Location</b> of the builder of the installation file</li>
- <li>Specify the <b>Working Directory</b> </li>
- </ul>
- </li>
- <li>Click <b>OK</b> </li>
- <p> The new builder appears in the <b>Builders</b> panel. The build steps are performed in the order they are displayed. Your builder name should appear under the <b>Carbide CPP Project Builder</b> item. If not, use the <b>Up</b> or <b>Down</b> controls to set the build order.
- <p align="center"><img src="images/pane_builder_n_gage_builder.png" width="489" height="184"></p>
- <p align="center" class="figure">Figure 4 - <b>Builder</b> dialog with new N-Gage Builder defined </p>
- <li>Click OK to close the <b>Properties for <i>project_name</i></b> window</li>
- <li>Build the project and its SISX file by selecting the <b>Project > Build Project</b> menu item</li>
- <p>The <a href="../reference/view_log.htm">Console</a> view shows information as the project and it's SISX file are built and then the build of the installation file (<span class="code">N-GAGE</span>).</p>
- </ol>
-<h3>For On-device Debugging </h3>
-<h4>Deploying the N-Gage project to a device </h4>
-<p>Once you have an <span class="code">.N-GAGE</span> game file, you need to deploy it on the target device:</p>
-<ol>
- <li>Verify that you have a valid developer certificate on the target device given to you by the Nokia R&D Certificate Service. If not, get and install one.</li>
- <li>Verify that you have Application TRK installed on the target device. If not, install it now using <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</li>
-<li>Manually install the <span class="code">.N-GAGE</span> file on the device</li>
-</ol>
-<h4>Debugging the Game project</h4>
-<p>With your game file installed on the device, create a launch configuration for the project. In Carbide:</p>
-<ol>
- <li>Open<span class="note"><b>Window > Preferences > Run/Debug ><img src="../images/command_link.png" width="16" height="12"> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.debug.ui.LaunchingPreferencePage)")'> Launching</a></b> preference panel </span>and disable the <b>Build (if required) before launching</b> option</li>
- <li>Right-click the project and choose <b>Debug As > Open Debug Dialog</b> to open the <b><a href="../reference/wnd_debug_configuration.htm">Debug</a></b> window</li>
- <li><a href="../tasks/projects/prj_debug_config.htm">Create</a> an <b>Application TRK</b> launch configuration
- <ul>
- <li>In the <b><a href="../reference/launch_configs/page_connection.htm">Connection</a></b> tab select the COM port used to connect to the device. </li>
- <li> In the <b><a href="../reference/launch_configs/app_trk_installation.htm">Installation</a></b> tab, verify that the game SISX file is correct </li>
- <li>In the <b><a href="../reference/launch_configs/page_trk_debugger.htm">Debug</a></b> tab, enable the View messges between PC and debug agent on the phone if you want to monitor communications between TRK and Carbide </li>
- </ul>
- </li>
-
- <li>Click <b>Debug</b> </li>
-</ol>
-<p>The Debugger launches the game project in the device and halts when it encounters the breakpoint you set. </p>
-<h3>For Emulator Debugging </h3>
-<h4>Deploying and debugging the N-Gage project on an emulator</h4>
-<p>With your game file installed to the emulator, create a launch configuration for the project. In Carbide:</p>
-<ol>
- <li>Open <b>Window > Preferences > Run/Debug > Launching</b> and disable the <b>Build (if required) before launching</b> option</li>
- <li>Right-click the project and choose <b>Debug As > Open Debug Dialog</b> to open the <b>Debug</b> window</li>
- <li>Create an <b>Symbian OS Emulation </b> launch configuration</li>
- <li>Click <b>Debug</b> to launch the emulator </li>
- <li>In the emulator, select <b>File > Open</b>, locate and select the .N-GAGE installation file and click <b>Open</b> to install the project </li>
- <li>Open the Installation folder, launch the N-Gage runtime application</li>
- <li>In the N-Gage runtime launch the game </li>
- <li>If any breakpoint is hit in the game project, the debugger suspends</li>
-</ol>
-<p>From this point you can use all of the debugger features to debug the project. </p>
-<p>Always refer to the N-Gage documentation for more information on creating, deploying, and debugging N-Gage projects. </p>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>N-Gage Projects</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>N-Gage Projects</h2>
+<p>Carbide.c++ supports the importing of N-Gage projects. However, there are some process issues that effect how you can debug game projects on devices. The following provides a high level overview of the process you should follow to successfully import, build, deploy, and debug an N-Gage game on a device. </p>
+<h4>Importing N-Gage projects</h4>
+<p>To start, import your game project into Carbide:</p>
+<ol>
+ <li>Install the N-Gage SDK on your PC</li>
+ <li>Place your game project inside the N-Gage SDK</li>
+ <li> In Carbide.c++, click<b> File > <a href="../tasks/ImportingProjects.html">Import</a></b></li>
+ <li>Select <b>Symbian OS Bld.inf</b> importer and navigate to your bld.inf file to import it </li>
+</ol>
+<h4>Building the N-Gage project</h4>
+<p>Once the game project has been imported, use these steps to create an N-GAGE game file:</p>
+<ol>
+ <li>Right-click the project and choose <b>Properties</b> to open the <b>Properties for <i>project_name</i></b> window </li>
+ <li>In the <b>Carbide.c++ > Carbide Build Configuration > <a href="../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a></b> panel, click <b>Add</b>.</li>
+ <li>In the <b><a href="../reference/build_properties/wnd_sis_properties.htm">SIS Properties</a></b> window:
+ <ol>
+ <li>Specify the project and metadata PKG files to build</li>
+ <li>Enable the<b> Sign sis file with certificate/key pair</b> for each PKG file </li>
+ <li>Select the certificate/key given to you by the Nokia R&D Certificate Service</li>
+ <li>Click <b>OK</b></li>
+ </ol>
+ </li>
+ <li>If using a batch file to build the N-Gage installation, create a new builder within Carbide by opening the <b>Properties for <i>project_name</i> > Builders</b> panel and click <b>New</b>. </li>
+<p align="center"><img src="images/pane_builders_properties.png" width="682" height="208"></p>
+<p align="center" class="figure">Figure 1 - Builders pane in project Properties dialog</p>
+ <li>Open the <b>Properties for <i>project_name</i> > Builders</b> panel</li>
+ <li>Click <b>New</b></li>
+ <li>Select <b>Program</b> in the <b>Choose configuration type</b> window, click <b>OK</b> </li>
+ <p align="center"><img src="images/wnd_properties_for_builder.png" width="800" height="640"></p>
+ <p align="center" class="figure">Figure 2 - <b>Properties for N-Gage Builder</b> dialog</p>
+ <li>In the <b>Properties for New_Builder</b> window
+ <b>Main</b> tab:
+ <ul>
+ <li>Define the builder name in the <b>Name</b> text box</li>
+ <li>Specify the <b>Location</b> of the builder of the installation file</li>
+ <li>Specify the <b>Working Directory</b> </li>
+ </ul>
+ </li>
+ <li>Click <b>OK</b> </li>
+ <p> The new builder appears in the <b>Builders</b> panel. The build steps are performed in the order they are displayed. Your builder name should appear under the <b>Carbide CPP Project Builder</b> item. If not, use the <b>Up</b> or <b>Down</b> controls to set the build order.
+ <p align="center"><img src="images/pane_builder_n_gage_builder.png" width="489" height="184"></p>
+ <p align="center" class="figure">Figure 4 - <b>Builder</b> dialog with new N-Gage Builder defined </p>
+ <li>Click OK to close the <b>Properties for <i>project_name</i></b> window</li>
+ <li>Build the project and its SISX file by selecting the <b>Project > Build Project</b> menu item</li>
+ <p>The <a href="../reference/view_log.htm">Console</a> view shows information as the project and it's SISX file are built and then the build of the installation file (<span class="code">N-GAGE</span>).</p>
+ </ol>
+<h3>For On-device Debugging </h3>
+<h4>Deploying the N-Gage project to a device </h4>
+<p>Once you have an <span class="code">.N-GAGE</span> game file, you need to deploy it on the target device:</p>
+<ol>
+ <li>Verify that you have a valid developer certificate on the target device given to you by the Nokia R&D Certificate Service. If not, get and install one.</li>
+ <li>Verify that you have Application TRK installed on the target device. If not, install it now using <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</li>
+<li>Manually install the <span class="code">.N-GAGE</span> file on the device</li>
+</ol>
+<h4>Debugging the Game project</h4>
+<p>With your game file installed on the device, create a launch configuration for the project. In Carbide:</p>
+<ol>
+ <li>Open<span class="note"><b>Window > Preferences > Run/Debug ><img src="../images/command_link.png" width="16" height="12"> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.debug.ui.LaunchingPreferencePage)")'> Launching</a></b> preference panel </span>and disable the <b>Build (if required) before launching</b> option</li>
+ <li>Right-click the project and choose <b>Debug As > Open Debug Dialog</b> to open the <b><a href="../reference/wnd_debug_configuration.htm">Debug</a></b> window</li>
+ <li><a href="../tasks/projects/prj_debug_config.htm">Create</a> an <b>Application TRK</b> launch configuration
+ <ul>
+ <li>In the <b><a href="../projects/launch/page_connection.htm">Connection</a></b> tab select the COM port used to connect to the device. </li>
+ <li> In the <b><a href="../projects/launch/page_installation.htm">Installation</a></b> tab, verify that the game SISX file is correct </li>
+ <li>In the <b><a href="../projects/launch/page_debugger.htm">Debug</a></b> tab, enable the View messges between PC and debug agent on the phone if you want to monitor communications between TRK and Carbide </li>
+ </ul>
+ </li>
+
+ <li>Click <b>Debug</b> </li>
+</ol>
+<p>The Debugger launches the game project in the device and halts when it encounters the breakpoint you set. </p>
+<h3>For Emulator Debugging </h3>
+<h4>Deploying and debugging the N-Gage project on an emulator</h4>
+<p>With your game file installed to the emulator, create a launch configuration for the project. In Carbide:</p>
+<ol>
+ <li>Open <b>Window > Preferences > Run/Debug > Launching</b> and disable the <b>Build (if required) before launching</b> option</li>
+ <li>Right-click the project and choose <b>Debug As > Open Debug Dialog</b> to open the <b>Debug</b> window</li>
+ <li>Create an <b>Symbian OS Emulation </b> launch configuration</li>
+ <li>Click <b>Debug</b> to launch the emulator </li>
+ <li>In the emulator, select <b>File > Open</b>, locate and select the .N-GAGE installation file and click <b>Open</b> to install the project </li>
+ <li>Open the Installation folder, launch the N-Gage runtime application</li>
+ <li>In the N-Gage runtime launch the game </li>
+ <li>If any breakpoint is hit in the game project, the debugger suspends</li>
+</ol>
+<p>From this point you can use all of the debugger features to debug the project. </p>
+<p>Always refer to the N-Gage documentation for more information on creating, deploying, and debugging N-Gage projects. </p>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/working_with_debugger.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/working_with_debugger.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,45 +1,45 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debugger Program Execution</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debugger Program Execution </h2>
-<p> This section explains how to work with the debugger in the Carbide IDE to control program execution. The main component of the debugger is the <a href="../reference/perspective_debug.htm">Debug perspective</a>, which shows these items:</p>
-<ul>
- <li>Common debugging controls in the <a href="../reference/view_debug.htm">Debug</a> view for:
- <ul>
- <li><a href="../tasks/debugger/work_debug_act_start.htm">Starting</a> the debugger</li>
- <li><a href="../tasks/debugger/work_debug_act_run.htm">Running</a> the program</li>
- <li>Stepping <a href="../tasks/debugger/work_debug_act_stepinto.htm">into</a>, <a href="../tasks/debugger/work_debug_act_stepout.htm">out</a> of, or <a href="../tasks/debugger/work_debug_act_stepover.htm">over</a> routines</li>
- <li><a href="../tasks/debugger/work_debug_act_stop.htm">Suspending</a>, <a href="../tasks/debugger/work_debug_act_resume.htm">resuming</a>, or <a href="../tasks/debugger/work_debug_act_kill.htm">terminating</a> program execution</li>
- <li><a href="../tasks/debugger/work_debug_act_disconnect.htm">Disconnecting</a> the debugger </li>
- <li><a href="../tasks/debugger/work_debug_act_restart.htm">Restarting</a> the debugger</li>
- </ul>
- </li>
- <li>Variable information in the <a href="../reference/view_variables.htm">Variables</a> view—see the variables in the executing code, their <a href="../tasks/variables/show_variables_view.htm">values</a>, and their <a href="../tasks/variables/set_variable_formats.htm">types</a></li>
- <li>Breakpoint information in the <a href="../reference/view_breakpoints.htm">Breakpoints</a> view—see the <a href="../tasks/breakpoints/pgm_bp_enable.htm">breakpoints</a>, <a href="../tasks/breakpoints/pgm_bp_conditional.htm">conditional</a> breakpoints, and <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/tasks/cdt_t_addrmv_brk_action.htm">breakpoint actions</a></li>
- <li>Source code—see the source code under debugger control</li>
-</ul>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="debugger_about.htm">Debugger</a></li>
- <li><a href="emulators.htm">Emulation Debugging</a></li>
- <li><a href="trk.htm">On-device Debugging</a></li>
-</ul>
-<h5>Related references</h5>
-<ul>
- <li><a href="../reference/perspective_debug.htm">Debug Perspective</a></li>
- <li><a href="../reference/view_debug.htm">Debug View</a> </li>
- <li><a href="../reference/view_expressions.htm">Expressions View</a></li>
- <li><a href="../reference/view_variables.htm">Variables View</a></li>
- <li><a href="../reference/view_breakpoints.htm">Breakpoints View </a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Debugger Program Execution</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debugger Program Execution </h2>
+<p> This section explains how to work with the debugger in the Carbide IDE to control program execution. The main component of the debugger is the <a href="../reference/perspective_debug.htm">Debug perspective</a>, which shows these items:</p>
+<ul>
+ <li>Common debugging controls in the <a href="../debugger/debug/viewing_debug.htm">Debug</a> view for:
+ <ul>
+ <li><a href="../debugger/debug/cmds_starting.htm">Starting</a> the debugger</li>
+ <li><a href="../debugger/debug/cmds_resuming.htm">Running</a> the program</li>
+ <li>Stepping <a href="../debugger/debug/cmds_stepping.htm">into</a>, <a href="../debugger/debug/cmds_stepping.htm">out</a> of, or <a href="../debugger/debug/cmds_stepping.htm">over</a> routines</li>
+ <li><a href="../debugger/debug/cmds_starting.htm">Suspending</a>, <a href="../debugger/debug/cmds_resuming.htm">resuming</a>, or <a href="../debugger/debug/cmds_starting.htm">terminating</a> program execution</li>
+ <li><a href="../debugger/debug/cmds_other.htm">Disconnecting</a> the debugger </li>
+ <li><a href="../debugger/debug/cmds_resuming.htm">Restarting</a> the debugger</li>
+ </ul>
+ </li>
+ <li>Variable information in the <a href="../reference/view_variables.htm">Variables</a> view—see the variables in the executing code, their <a href="../tasks/variables/show_variables_view.htm">values</a>, and their <a href="../tasks/variables/set_variable_formats.htm">types</a></li>
+ <li>Breakpoint information in the <a href="../reference/view_breakpoints.htm">Breakpoints</a> view—see the <a href="../tasks/breakpoints/pgm_bp_enable.htm">breakpoints</a>, <a href="../tasks/breakpoints/pgm_bp_conditional.htm">conditional</a> breakpoints, and <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/tasks/cdt_t_addrmv_brk_action.htm">breakpoint actions</a></li>
+ <li>Source code—see the source code under debugger control</li>
+</ul>
+<h5>Related concepts</h5>
+<ul>
+ <li><a href="debugger_about.htm">Debugger</a></li>
+ <li><a href="emulators.htm">Emulation Debugging</a></li>
+ <li><a href="trk.htm">On-device Debugging</a></li>
+</ul>
+<h5>Related references</h5>
+<ul>
+ <li><a href="../reference/perspective_debug.htm">Debug Perspective</a></li>
+ <li><a href="../debugger/debug/viewing_debug.htm">Debug View</a> </li>
+ <li><a href="../reference/view_expressions.htm">Expressions View</a></li>
+ <li><a href="../reference/view_variables.htm">Variables View</a></li>
+ <li><a href="../reference/view_breakpoints.htm">Breakpoints View </a> </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/debugger.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/debugger.htm Mon Aug 10 15:50:55 2009 -0500
@@ -25,7 +25,7 @@
</tr>
<tr>
<td colspan="2"><h1 align="center">Carbide.c++ User Guide</h1>
- <p align="center" class="titleSmall">Version 2.1.0, June, 2009</p></td>
+ <p align="center" class="titleSmall">Version 2.2.0, August, 2009</p></td>
</tr>
</table>
<p align="center"> </p>
--- a/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/cmds_resuming.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/cmds_resuming.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,42 +1,42 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Suspending and Resuming a Debug Session</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Suspending and Resuming a Debug Session</h2>
-<p>Once you've started a debug session, the <a href="viewing_debug.htm">Debug</a><b> </b>view provides controls to both suspend and resume program execution under debugger control. The following items describe the commands for:</p>
-<ul>
- <li><a href="#PAUSE_PGM">Suspending a program</a></li>
- <li><a href="#RESUME_PGM">Resuming a program</a></li>
-</ul>
-<h4><a name="PAUSE_PGM" id="PAUSE_PGM"></a>Suspending a program</h4>
-<p>Use the <b>Suspend</b> command (<img src="../../images/icons/btn_suspend.png" width="17" height="17" align="absmiddle" />) to stop program execution during a debugging session.</p>
-<p>To suspend a running program:</p>
-<ol>
- <li>Select the thread in the <b>Debug</b> view to suspend</li>
- <li>Click the <b>Suspend</b> (<img src="../../images/icons/btn_suspend.png" width="17" height="17" align="absmiddle" />) button, or right-click the thread and select <b>Suspend</b></li>
-</ol>
-<h4><a name="RESUME_PGM" id="PAUSE_PGM2"></a>Resuming a program</h4>
-<p>Use the <b>Resume</b> command (<img src="../../images/icons/btn_resume.png" width="19" height="14" align="absmiddle" />) to continue executing a suspended debugging session. If the debugging session is already active, use this command to switch view from the Thread window to the executing program.</p>
-<p>The ways you can resume a program include:</p>
-<ul>
- <li>Click the <b>Resume</b> button (<img src="../../images/icons/btn_resume.png" width="19" height="14" align="absmiddle" />) in the <b>Debug</b> view </li>
-</ul>
-<ul>
- <li>Right-click the thread in the <b>Debug</b> view and select <b>Resume</b> from the context menu</li>
-</ul>
-<ul><li>Select <b>Run > Resume</b> from the menu bar </li>
-</ul>
-<p class="note"><b>NOTE</b> If the <a href="../../reference/view_debug.htm">Debug</a> view loses focus, the Resume control will appear disabled. To regain focus, select a thread in the Debug view to update the tool bar and reactivate the Resume control.</p>
-<h4>Other references</h4>
-<ul>
- <li><a href="debug.htm">Debugging overview</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Suspending and Resuming a Debug Session</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Suspending and Resuming a Debug Session</h2>
+<p>Once you've started a debug session, the <a href="viewing_debug.htm">Debug</a><b> </b>view provides controls to both suspend and resume program execution under debugger control. The following items describe the commands for:</p>
+<ul>
+ <li><a href="#PAUSE_PGM">Suspending a program</a></li>
+ <li><a href="#RESUME_PGM">Resuming a program</a></li>
+</ul>
+<h4><a name="PAUSE_PGM" id="PAUSE_PGM"></a>Suspending a program</h4>
+<p>Use the <b>Suspend</b> command (<img src="../../images/icons/btn_suspend.png" width="17" height="17" align="absmiddle" />) to stop program execution during a debugging session.</p>
+<p>To suspend a running program:</p>
+<ol>
+ <li>Select the thread in the <b>Debug</b> view to suspend</li>
+ <li>Click the <b>Suspend</b> (<img src="../../images/icons/btn_suspend.png" width="17" height="17" align="absmiddle" />) button, or right-click the thread and select <b>Suspend</b></li>
+</ol>
+<h4><a name="RESUME_PGM" id="PAUSE_PGM2"></a>Resuming a program</h4>
+<p>Use the <b>Resume</b> command (<img src="../../images/icons/btn_resume.png" width="19" height="14" align="absmiddle" />) to continue executing a suspended debugging session. If the debugging session is already active, use this command to switch view from the Thread window to the executing program.</p>
+<p>The ways you can resume a program include:</p>
+<ul>
+ <li>Click the <b>Resume</b> button (<img src="../../images/icons/btn_resume.png" width="19" height="14" align="absmiddle" />) in the <b>Debug</b> view </li>
+</ul>
+<ul>
+ <li>Right-click the thread in the <b>Debug</b> view and select <b>Resume</b> from the context menu</li>
+</ul>
+<ul><li>Select <b>Run > Resume</b> from the menu bar </li>
+</ul>
+<p class="note"><b>NOTE</b> If the <a href="viewing_debug.htm">Debug</a> view loses focus, the Resume control will appear disabled. To regain focus, select a thread in the Debug view to update the tool bar and reactivate the Resume control.</p>
+<h4>Other references</h4>
+<ul>
+ <li><a href="debug.htm">Debugging overview</a> </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/cmds_starting.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/cmds_starting.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,47 +1,47 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Starting and Terminating a Debug Session</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Starting and Terminating a Debug Session</h2>
-<p>Once you've started a debug session, the <b>Debug</b> view provides controls to both terminate and restart the session. The following items describe the commands for:</p>
-<ul>
- <li><a href="#START_DB">Starting a session</a></li>
- <li><a href="#TERMINATE_DB">Terminating a session</a></li>
- <li><a href="#RESTART_DB">Restarting a session</a></li>
-</ul>
-<h4><a name="START_DB" id="START_DB"></a>Starting a session</h4>
-<p>Use the <b>Debug</b> command (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) to execute a program under debugger control using the current <a href="../../reference/wnd_debug_configuration.htm">launch configuration</a> settings.</p>
-<p>If the project does not already have a launch configuration, the <a href="../../tasks/projects/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> will automatically create one for emulator targets or ask for additional information to create one. It will generate a default name for the launch configuration and add it to the list of available launch configurations for the project. Once complete and saved the debug session is launched. If a launch configuration is already available, the Debug command launches the last launch configuration used by the project. </p>
-<p>To create new launch configurations where none previously existed or launch the last one created:</p>
-<ul>
- <li>Click the <b>Debug</b> button (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) in the <b>Carbide C/C++</b> perspective</li>
- <li>Select <b>Run > Debug</b> from the menu bar </li>
-</ul>
-<p>To launch a specific launch configuration:</p>
-<ul>
- <li>Right-click the project's EXE file in the C/C++ Projects view and select <b>Debug As > <em>Project_Name</em></b> from the context menu</li>
-</ul>
-<h4><a name="TERMINATE_DB" id="START_DB2"></a>Terminating a session</h4>
-<p>Use the <b>Terminate</b> command (<img src="../../images/icons/btn_terminate.png" width="17" height="15" align="absmiddle" />) to stop or halt a program based on the type of debugging session underway. Terminate behavior includes: </p>
-<ul>
- <li><b>Emulator</b> - terminates program execution and ends the debug session</li>
- <li><b>Application TRK</b> or <b>System TRK</b> - kills the process on the device and ends the debug session. To terminate without killing the process, use <a href="../../tasks/debugger/work_debug_act_disconnect.htm">Disconnect</a> instead. </li>
- <li><b>Stop-mode soft attach</b> - suspends the attached process while other processes continue to run on the device. If only a single process is running on the device, the device CPU is suspended. Once the CPU is suspended you must launch a new debug session to resume the device CPU. </li>
-</ul>
-<p>This behavior differs from <a href="../../tasks/debugger/work_debug_act_stop.htm">suspending</a> a program, as this temporarily suspends execution.</p>
-<p class="note"><b>NOTE</b> If the <a href="../../reference/view_debug.htm">Debug</a> view loses focus, the Terminate control will appear disabled. To regain focus, select a thread in the Debug view to update the tool bar and reactivate the Terminate control. </p>
-<h4><a name="RESTART_DB" id="START_DB3"></a>Restarting a session</h4>
-<p>Use the <b>Restart</b> command (<img src="../../images/icons/btn_restart.png" width="20" height="18" align="absmiddle" />) after stopping program execution. The debugger goes back to the beginning of the program and begins execution again. This behavior is equivalent to killing execution, then starting a new debugging session.</p>
-<h4>Other references</h4>
-<ul>
- <li><a href="debug.htm">Debugging overview</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Starting and Terminating a Debug Session</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Starting and Terminating a Debug Session</h2>
+<p>Once you've started a debug session, the <b>Debug</b> view provides controls to both terminate and restart the session. The following items describe the commands for:</p>
+<ul>
+ <li><a href="#START_DB">Starting a session</a></li>
+ <li><a href="#TERMINATE_DB">Terminating a session</a></li>
+ <li><a href="#RESTART_DB">Restarting a session</a></li>
+</ul>
+<h4><a name="START_DB" id="START_DB"></a>Starting a session</h4>
+<p>Use the <b>Debug</b> command (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) to execute a program under debugger control using the current <a href="../../reference/wnd_debug_configuration.htm">launch configuration</a> settings.</p>
+<p>If the project does not already have a launch configuration, the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> will automatically create one for emulator targets or ask for additional information to create one. It will generate a default name for the launch configuration and add it to the list of available launch configurations for the project. Once complete and saved the debug session is launched. If a launch configuration is already available, the Debug command launches the last launch configuration used by the project. </p>
+<p>To create new launch configurations where none previously existed or launch the last one created:</p>
+<ul>
+ <li>Click the <b>Debug</b> button (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) in the <b>Carbide C/C++</b> perspective</li>
+ <li>Select <b>Run > Debug</b> from the menu bar </li>
+</ul>
+<p>To launch a specific launch configuration:</p>
+<ul>
+ <li>Right-click the project's EXE file in the C/C++ Projects view and select <b>Debug As > <em>Project_Name</em></b> from the context menu</li>
+</ul>
+<h4><a name="TERMINATE_DB" id="START_DB2"></a>Terminating a session</h4>
+<p>Use the <b>Terminate</b> command (<img src="../../images/icons/btn_terminate.png" width="17" height="15" align="absmiddle" />) to stop or halt a program based on the type of debugging session underway. Terminate behavior includes: </p>
+<ul>
+ <li><b>Emulator</b> - terminates program execution and ends the debug session</li>
+ <li><b>Application TRK</b> or <b>System TRK</b> - kills the process on the device and ends the debug session. To terminate without killing the process, use <a href="cmds_other.htm">Disconnect</a> instead. </li>
+ <li><b>Stop-mode soft attach</b> - suspends the attached process while other processes continue to run on the device. If only a single process is running on the device, the device CPU is suspended. Once the CPU is suspended you must launch a new debug session to resume the device CPU. </li>
+</ul>
+<p>This behavior differs from <a href="cmds_starting.htm">suspending</a> a program, as this temporarily suspends execution.</p>
+<p class="note"><b>NOTE</b> If the <a href="viewing_debug.htm">Debug</a> view loses focus, the Terminate control will appear disabled. To regain focus, select a thread in the Debug view to update the tool bar and reactivate the Terminate control. </p>
+<h4><a name="RESTART_DB" id="START_DB3"></a>Restarting a session</h4>
+<p>Use the <b>Restart</b> command (<img src="../../images/icons/btn_restart.png" width="20" height="18" align="absmiddle" />) after stopping program execution. The debugger goes back to the beginning of the program and begins execution again. This behavior is equivalent to killing execution, then starting a new debugging session.</p>
+<h4>Other references</h4>
+<ul>
+ <li><a href="debug.htm">Debugging overview</a> </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/cmds_stepping.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/cmds_stepping.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,68 +1,68 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Stepping Over, Into, and Out of Routines</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Stepping Over, Into, and Out of Routines</h2>
-<p>Once you've <a href="../../tasks/debugger/work_debug_act_resume.htm">suspended</a> a program debug session, the <a href="viewing_debug.htm">Debug</a> view provides controls to walk through program code, including commands for:</p>
-<ul>
- <li><a href="#STEP_OVER">Stepping over a routine</a></li>
- <li><a href="#STEP_INTO">Stepping into a routine</a></li>
- <li><a href="#STEP_OUT">Stepping out of a routine</a><a href="#RESUME_PGM"></a></li>
-</ul>
-<h4><a name="STEP_OVER" id="STEP_OVER"></a>Stepping over a routine</h4>
-<p>Use the <b>Step Over</b> command (<img src="../../images/icons/btn_stepover.png" width="19" height="14" />) to execute the current statement and advance to the next statement in the source code. If the current statement is a routine call, program execution continues until reaching one of these points:</p>
-<ul>
- <li>the end of the called routine</li>
- <li>a breakpoint</li>
- <li>a watchpoint</li>
- <li>an eventpoint that stops execution</li>
-</ul>
-<p>To step over a routine:</p>
- <ul>
- <li>Click the <b>Step Over</b> button (<img src="../../images/icons/btn_stepover.png" width="19" height="14" />) in the <b>Debug</b> view </li>
- <li>Right-click the thread in the Debug view and select <b>Step Over</b> from the <b>Debug</b> contextual menu</li>
- <li>Select <b>Run > Step Over</b> from the menu bar </li>
- </ul>
- <ul>
- <p>The current statement or routine executes, then program execution stops.</p>
- </ul>
-<h4><a name="STEP_INTO" id="STEP_OVER2"></a>Stepping into a routine</h4>
-<p>Use the <b>Step Into</b> command (<img src="../../images/icons/btn_stepinto.png" width="18" height="14" />) to execute one source-code statement at a time and follow execution into a routine call.</p>
-<p>When stepping through a program in a debug session the IDE attempts to match the program counter (PC) location in the executable with a known project source file. If there is no source file associated with the PC the debugger displays in the Debug view the current PC address of the thread (e.g. <span class="code">0x6002CC11(EUSER.DLL)()</span>) instead of the function name. At this point you can open the Disassembly view to step through the assembler code. This most commonly happens when trying to step into Symbian OS code. We recommend that you <a href="../../tasks/debugger/work_debug_act_stepover.htm">Step Return</a> out of the OS code and back into your project to continue debugging.</p>
-<ul>
- <li>Click the <b>Step Into</b> button (<img src="../../images/icons/btn_stepinto.png" width="18" height="14" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- <li>Right-click the thread in the <b>Debug</b> view and select <b>Step Into</b> from the context menu</li>
- <li>Select <b>Run > Step Into</b> from the menu bar </li>
-</ul>
-<ul>
- <p>After the debugger executes the source-code statement, the current-statement arrow moves to the next statement determined by these rules:</p>
- <ul>
- <li>If the executed statement did not call a routine, the current-statement arrow moves to the next statement in the source code.</li>
- <li>If the executed statement called a routine, the current-statement arrow moves to the first statement in the called routine.</li>
- <li>If the executed statement is the last statement in a called routine, the current-statement arrow moves to the statement that follows the calling routine.</li>
- </ul>
-</ul>
-<h4><a name="STEP_OUT" id="STEP_OVER3"></a>Stepping out of a routine</h4>
-<p>Use the <b>Step Return</b> command (<img src="../../images/icons/btn_stepreturn.png" width="17" height="14" />) to execute the rest of the current routine and stop program execution after the routine returns to its caller. This command causes execution to return up the calling chain.</p>
-<p>To step out of a routine:</p>
- <ul>
- <li>Click the <b>Step Return</b> button (<img src="../../images/icons/btn_stepreturn.png" width="17" height="14" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- <li>Right-click the thread in the <b>Debug</b> view, then select <b>Step Return</b> from the context menu</li>
- <li>Select <b>Run > Step Return</b> from the menu bar </li>
-</ul>
-<ul>
- <p>The current routine executes and returns to its caller, then program execution stops</p>
-</ul>
-<h4>Other references</h4>
-<ul>
-<li><a href="debug.htm">Debugging overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Stepping Over, Into, and Out of Routines</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Stepping Over, Into, and Out of Routines</h2>
+<p>Once you've <a href="cmds_resuming.htm">suspended</a> a program debug session, the <a href="viewing_debug.htm">Debug</a> view provides controls to walk through program code, including commands for:</p>
+<ul>
+ <li><a href="#STEP_OVER">Stepping over a routine</a></li>
+ <li><a href="#STEP_INTO">Stepping into a routine</a></li>
+ <li><a href="#STEP_OUT">Stepping out of a routine</a></li>
+</ul>
+<h4><a name="STEP_OVER" id="STEP_OVER"></a>Stepping over a routine</h4>
+<p>Use the <b>Step Over</b> command (<img src="../../images/icons/btn_stepover.png" width="19" height="14" />) to execute the current statement and advance to the next statement in the source code. If the current statement is a routine call, program execution continues until reaching one of these points:</p>
+<ul>
+ <li>the end of the called routine</li>
+ <li>a breakpoint</li>
+ <li>a watchpoint</li>
+ <li>an eventpoint that stops execution</li>
+</ul>
+<p>To step over a routine:</p>
+ <ul>
+ <li>Click the <b>Step Over</b> button (<img src="../../images/icons/btn_stepover.png" width="19" height="14" />) in the <b>Debug</b> view </li>
+ <li>Right-click the thread in the Debug view and select <b>Step Over</b> from the <b>Debug</b> contextual menu</li>
+ <li>Select <b>Run > Step Over</b> from the menu bar </li>
+ </ul>
+ <ul>
+ <p>The current statement or routine executes, then program execution stops.</p>
+ </ul>
+<h4><a name="STEP_INTO" id="STEP_OVER2"></a>Stepping into a routine</h4>
+<p>Use the <b>Step Into</b> command (<img src="../../images/icons/btn_stepinto.png" width="18" height="14" />) to execute one source-code statement at a time and follow execution into a routine call.</p>
+<p>When stepping through a program in a debug session the IDE attempts to match the program counter (PC) location in the executable with a known project source file. If there is no source file associated with the PC the debugger displays in the Debug view the current PC address of the thread (e.g. <span class="code">0x6002CC11(EUSER.DLL)()</span>) instead of the function name. At this point you can open the Disassembly view to step through the assembler code. This most commonly happens when trying to step into Symbian OS code. We recommend that you <a href="cmds_stepping.htm">Step Return</a> out of the OS code and back into your project to continue debugging.</p>
+<ul>
+ <li>Click the <b>Step Into</b> button (<img src="../../images/icons/btn_stepinto.png" width="18" height="14" />) in the <a href="viewing_debug.htm">Debug</a> view </li>
+ <li>Right-click the thread in the <b>Debug</b> view and select <b>Step Into</b> from the context menu</li>
+ <li>Select <b>Run > Step Into</b> from the menu bar </li>
+</ul>
+<ul>
+ <p>After the debugger executes the source-code statement, the current-statement arrow moves to the next statement determined by these rules:</p>
+ <ul>
+ <li>If the executed statement did not call a routine, the current-statement arrow moves to the next statement in the source code.</li>
+ <li>If the executed statement called a routine, the current-statement arrow moves to the first statement in the called routine.</li>
+ <li>If the executed statement is the last statement in a called routine, the current-statement arrow moves to the statement that follows the calling routine.</li>
+ </ul>
+</ul>
+<h4><a name="STEP_OUT" id="STEP_OVER3"></a>Stepping out of a routine</h4>
+<p>Use the <b>Step Return</b> command (<img src="../../images/icons/btn_stepreturn.png" width="17" height="14" />) to execute the rest of the current routine and stop program execution after the routine returns to its caller. This command causes execution to return up the calling chain.</p>
+<p>To step out of a routine:</p>
+ <ul>
+ <li>Click the <b>Step Return</b> button (<img src="../../images/icons/btn_stepreturn.png" width="17" height="14" />) in the <a href="viewing_debug.htm">Debug</a> view </li>
+ <li>Right-click the thread in the <b>Debug</b> view, then select <b>Step Return</b> from the context menu</li>
+ <li>Select <b>Run > Step Return</b> from the menu bar </li>
+</ul>
+<ul>
+ <p>The current routine executes and returns to its caller, then program execution stops</p>
+</ul>
+<h4>Other references</h4>
+<ul>
+<li><a href="debug.htm">Debugging overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/viewing_debug.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/debugger/debug/viewing_debug.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,104 +1,104 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debug view</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debug view </h2>
-<p>The <b>Debug</b> view provides an overview of the debug session as it relates to the executing program. The target debugging information is shown in a tree hierarchy. The items that appear there include:</p>
-<ul>
- <li>Launch instance (<img src="../images/debug_launch_instance_icon.png" width="16" height="16" align="absmiddle" />) - launch configuration name and type </li>
- <li>Debugger instance (<img src="../images/debug_debugger_instance_icon.png" width="18" height="16" align="absmiddle" />) - debugger name and state </li>
- <li>Executable instances (<img src="../images/debug_codebug_instance_icon.png" width="17" height="17" align="absmiddle" />) - other executables called by the launch instance </li>
- <li>Thread instance (<img src="../images/debug_thread_instance_icon.png" width="16" height="15" align="absmiddle" />) - thread number and state </li>
- <li>Stack frame reference (<img src="../images/debug_stack_frame_instance_icon.png" width="16" height="14" align="absmiddle" />) - displays stack frame number, function, filename, and file line number when symbols are available and stack frame number, memory address, and filename when symbols are not available </li>
-</ul>
-<p class="note"><b>NOTE</b> The number beside the thread label is a reference counter, not a thread
- identification number (TID).</p>
-<p>The CDT displays stack frames as child elements. It displays the reason for the suspension beside the thread, (such as end of stepping range, breakpoint hit, and signal received). When a program exits, the exit code is displayed.</p>
-<p>In addition to controlling the individual stepping of your programs, you can also control the debug session. You can perform actions such as terminating the session and stopping the program by using the debug launch controls available from Debug view. See Table 1 for details. </p>
-<p>Figure 1 shows the Debug view. Table 1 explains the items in the view.</p>
-<p align="center"><img src="../images/view_debug.png" width="545" height="264" /></p>
-<p class="figure">Figure 1 - Debug view</p>
-<h5>Table 1 Debug view—items</h5>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="29%" scope="col">Item</th>
- <th width="14%" scope="col">Icon</th>
- <th width="57%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_resume.htm">Resume</a></td>
- <td><div align="center"><img src="../images/icon_debug_resume_btn.png" width="19" height="16" /></div></td>
- <td><p>Click to perform these tasks:</p>
- <ul>
- <li>Continue execution up to the next breakpoint, watchpoint, or eventpoint</li>
- <li>Run the program until it exits</li>
- <li>Continue execution of a currently stopped program</li>
- </ul></td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_stop.htm">Suspend</a></td>
- <td><div align="center"><img src="../images/icon_debug_suspend_btn.png" width="19" height="16" /></div></td>
- <td>Click to stop (pause) program execution.</td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_kill.htm">Terminate</a></td>
- <td><div align="center"><img src="../images/icon_debug_terminate_btn.png" width="17" height="17" /></div></td>
- <td>Click to terminate program execution. This ends the debugging session.</td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_disconnect.htm">Disconnect</a></td>
- <td><center>
- <img src="../images/icon_debug_disconnect.png" width="20" height="21">
- </center>
- </td>
- <td><p>Detaches the debugger from the selected process (useful for debugging attached processes).</p>
- <p class="note"><b>NOTE</b> After detaching the debugger from an on-device process, closing TRK on the device will also close the process. </p></td>
- </tr>
- <tr>
- <td><b>Remove All Terminated </b></td>
- <td><center>
- <img src="../images/icon_debug_remove_all.png" width="21" height="19">
- </center>
- </td>
- <td>Clears all terminated processes in Debug view.</td>
- </tr>
- <tr>
- <td><a href="../../tasks/debugger/work_debug_act_restart.htm">Restart</a></td>
- <td><div align="center"><img src="../images/icon_debug_restart_btn.png" width="19" height="19" /></div></td>
- <td>Returns the debugger to the beginning of the program and begins execution again. This behavior is equivalent to killing execution, then starting a new debugging session.</td>
- </tr>
- <tr>
- <td><a href="../../tasks/debugger/work_debug_act_stepover.htm">Step Over</a></td>
- <td><div align="center"><img src="../images/icon_debug_step_over_btn.png" width="18" height="14" /></div></td>
- <td>Click to execute the current line, including any routines, and proceed to the next statement.</td>
- </tr>
- <tr>
- <td><a href="../../tasks/debugger/work_debug_act_stepinto.htm">Step Into</a></td>
- <td><div align="center"><img src="../images/icon_debug_step_into_btn.png" width="18" height="14" /></div></td>
- <td>Click to execute the current line, following execution inside a routine.</td>
- </tr>
- <tr>
- <td><a href="../../tasks/debugger/work_debug_act_stepout.htm">Step Return</a></td>
- <td><div align="center"><img src="../images/icon_debug_step_return_btn.png" width="18" height="15" /></div></td>
- <td>Click to continue execution to the end of the current routine, then follow execution to the routine’s caller.</td>
- </tr>
- <tr>
- <td><b>Instruction Stepping Mode </b></td>
- <td><div align="center"><img src="../images/icon_debug_instr_stepping_mode.png" width="18" height="16"></div></td>
- <td>Activate to enable instruction stepping mode to examine a program as it steps into disassembled code.</td>
- </tr>
-</table>
-<h4>Other references</h4>
-<ul>
-
- <li><a href="debug.htm">Debugging overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Debug view</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debug view </h2>
+<p>The <b>Debug</b> view provides an overview of the debug session as it relates to the executing program. The target debugging information is shown in a tree hierarchy. The items that appear there include:</p>
+<ul>
+ <li>Launch instance (<img src="../images/debug_launch_instance_icon.png" width="16" height="16" align="absmiddle" />) - launch configuration name and type </li>
+ <li>Debugger instance (<img src="../images/debug_debugger_instance_icon.png" width="18" height="16" align="absmiddle" />) - debugger name and state </li>
+ <li>Executable instances (<img src="../images/debug_codebug_instance_icon.png" width="17" height="17" align="absmiddle" />) - other executables called by the launch instance </li>
+ <li>Thread instance (<img src="../images/debug_thread_instance_icon.png" width="16" height="15" align="absmiddle" />) - thread number and state </li>
+ <li>Stack frame reference (<img src="../images/debug_stack_frame_instance_icon.png" width="16" height="14" align="absmiddle" />) - displays stack frame number, function, filename, and file line number when symbols are available and stack frame number, memory address, and filename when symbols are not available </li>
+</ul>
+<p class="note"><b>NOTE</b> The number beside the thread label is a reference counter, not a thread
+ identification number (TID).</p>
+<p>The CDT displays stack frames as child elements. It displays the reason for the suspension beside the thread, (such as end of stepping range, breakpoint hit, and signal received). When a program exits, the exit code is displayed.</p>
+<p>In addition to controlling the individual stepping of your programs, you can also control the debug session. You can perform actions such as terminating the session and stopping the program by using the debug launch controls available from Debug view. See Table 1 for details. </p>
+<p>Figure 1 shows the Debug view. Table 1 explains the items in the view.</p>
+<p align="center"><img src="../images/view_debug.png" width="545" height="264" /></p>
+<p class="figure">Figure 1 - Debug view</p>
+<h5>Table 1 Debug view—items</h5>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="29%" scope="col">Item</th>
+ <th width="14%" scope="col">Icon</th>
+ <th width="57%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><a href="cmds_resuming.htm">Resume</a></td>
+ <td><div align="center"><img src="../images/icon_debug_resume_btn.png" width="19" height="16" /></div></td>
+ <td><p>Click to perform these tasks:</p>
+ <ul>
+ <li>Continue execution up to the next breakpoint, watchpoint, or eventpoint</li>
+ <li>Run the program until it exits</li>
+ <li>Continue execution of a currently stopped program</li>
+ </ul></td>
+ </tr>
+ <tr>
+ <td><a href="cmds_resuming.htm">Suspend</a></td>
+ <td><div align="center"><img src="../images/icon_debug_suspend_btn.png" width="19" height="16" /></div></td>
+ <td>Click to stop (pause) program execution.</td>
+ </tr>
+ <tr>
+ <td><a href="cmds_starting.htm">Terminate</a></td>
+ <td><div align="center"><img src="../images/icon_debug_terminate_btn.png" width="17" height="17" /></div></td>
+ <td>Click to terminate program execution. This ends the debugging session.</td>
+ </tr>
+ <tr>
+ <td><a href="cmds_other.htm">Disconnect</a></td>
+ <td><center>
+ <img src="../images/icon_debug_disconnect.png" width="20" height="21">
+ </center>
+ </td>
+ <td><p>Detaches the debugger from the selected process (useful for debugging attached processes).</p>
+ <p class="note"><b>NOTE</b> After detaching the debugger from an on-device process, closing TRK on the device will also close the process. </p></td>
+ </tr>
+ <tr>
+ <td><a href="cmds_other.htm">Remove All Terminated</a> </td>
+ <td><center>
+ <img src="../images/icon_debug_remove_all.png" width="21" height="19">
+ </center>
+ </td>
+ <td>Clears all terminated processes in Debug view.</td>
+ </tr>
+ <tr>
+ <td><a href="cmds_starting.htm">Restart</a></td>
+ <td><div align="center"><img src="../images/icon_debug_restart_btn.png" width="19" height="19" /></div></td>
+ <td>Returns the debugger to the beginning of the program and begins execution again. This behavior is equivalent to killing execution, then starting a new debugging session.</td>
+ </tr>
+ <tr>
+ <td><a href="cmds_stepping.htm">Step Over</a></td>
+ <td><div align="center"><img src="../images/icon_debug_step_over_btn.png" width="18" height="14" /></div></td>
+ <td>Click to execute the current line, including any routines, and proceed to the next statement.</td>
+ </tr>
+ <tr>
+ <td><a href="cmds_stepping.htm">Step Into</a></td>
+ <td><div align="center"><img src="../images/icon_debug_step_into_btn.png" width="18" height="14" /></div></td>
+ <td>Click to execute the current line, following execution inside a routine.</td>
+ </tr>
+ <tr>
+ <td><a href="cmds_stepping.htm">Step Return</a></td>
+ <td><div align="center"><img src="../images/icon_debug_step_return_btn.png" width="18" height="15" /></div></td>
+ <td>Click to continue execution to the end of the current routine, then follow execution to the routine’s caller.</td>
+ </tr>
+ <tr>
+ <td><a href="cmds_other.htm">Instruction Stepping Mode </a></td>
+ <td><div align="center"><img src="../images/icon_debug_instr_stepping_mode.png" width="18" height="16"></div></td>
+ <td>Activate to enable instruction stepping mode to examine a program as it steps into disassembled code.</td>
+ </tr>
+</table>
+<h4>Other references</h4>
+<ul>
+
+ <li><a href="debug.htm">Debugging overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/bkpt_toggle_breakpoint_off.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/bkpt_toggle_breakpoint_on.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_watchpoint_both_resolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_watchpoint_both_unresolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_watchpoint_read_unresolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_watchpoint_write_enabled_resolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/debugger/images/icon_watchpoint_write_unresolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/AIFCmplrOptions.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/AIFDef-Step1.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/AIFDef-Step2.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/AIFDef-Step3.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/AIFInterface.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/AddBMPWithMask.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/AddBMPWithoutMask.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/BuildOptions-OLD.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/BuildOptions.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/MBMCmplrOptions.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/MBMDef-New.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/MBMDef-Step1.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/MBMDef-Step2.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/MBMDef-Step3.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/MBMInterface.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/NewMMPWizard.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/NewProject.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/Preferences.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/RscCompilerOptions.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/SDKPreferences.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/borrow_license_file.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/buildconfigprops.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/carbide_image.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/carbide_image_sm.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/carbide_image_sm.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/export_makefiles_7.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/export_scalable_8.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icon_build_config_active.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icon_build_config_available.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icon_build_configurations.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icons/carbide.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icons/carbide_hov.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icons/debug_codebug_instance_icon.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icons/debug_debugger_instance_icon.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icons/debug_thread_instance_icon.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icons/icon_build_target.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/icons/icon_launch_config.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/import2.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/import6.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/importMMP1.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/importMMP2.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/install_license_file.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/navigatorview.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/ncp_logo.jpg has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/newclassmenu.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/newclassmenu1.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/proj_prefs_binary_parser.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/proj_prefs_build_settings.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/proj_prefs_build_steps.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/proj_prefs_error_parser.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/related_concepts.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/select_license_file.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/step3.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/test_license_file.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/tur_images/option_text_encoding.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/tur_images/panel_debug_debugger.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/tur_images/panel_debug_x86_exceptions.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/update1.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/update2.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/updateMMPQuestion.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/view_build_config_change.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/view_build_configs.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/view_build_configs_show.gif has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/view_license_file.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/views/wnd_edit_shared_value.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/views/wnd_tmp_default_values.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/wnd_add_bitmaps.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/images/workbench.gif has changed
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/attach_process.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/attach_process.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,33 +1,33 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Attach to Process Launch Configuration</title>
-<link href="../../../book.css" rel="stylesheet" type="text/css">
-</head>
-
-<body>
-<h2>Attach to Process Launch Configuration</h2>
-<p>Use the <b>Symbian OS Attach to Process</b> launch configuration to attach the debugger to an already running Symbian OS process or thread on a target device from within any project. This is useful for debugging servers running in RAM in a client-server relationship where the client relies on the presence of the server process to operate as one example. </p>
-<p>Attaching to a process requires a both target device running the Symbian OS and the presence of a TRK debug agent on the device. <span class="note">You can also use the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view to attach to a process while debugging.</span> However, you can not attach to a process running on an emulator. </p>
-<p>If the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> created the Attach to Process launch configuration no changes are usually needed. The Attach to Process options match those of System TRK with one additional step, selection of the process to debug in the <b>Attach to Process</b> dialog. </p>
-<p>To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Attach to Process configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
-<p align="center"><img src="../images/wnd_debug_attach_process_launch_config.png" width="800" height="582"></p>
-<p class="figure">Figure 1. Attach to Process launch configuration in the Debug dialog </p>
-<p>The <span class="figure">Attach to Process</span> launch configuration panes include:</p>
-<ul>
- <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
- <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging, target options, and instruction set.</li>
- <li>The <a href="page_rom_log.htm">ROM Log </a> tab allows you to specify where the ROM log file is stored and the <span class="code">Epoc32</span> directory.</li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
-</ul>
-<h4>Other references</h4>
-<ul>
- <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Attach to Process Launch Configuration</title>
+<link href="../../../book.css" rel="stylesheet" type="text/css">
+</head>
+
+<body>
+<h2>Attach to Process Launch Configuration</h2>
+<p>Use the <b>Symbian OS Attach to Process</b> launch configuration to attach the debugger to an already running Symbian OS process or thread on a target device from within any project. This is useful for debugging servers running in RAM in a client-server relationship where the client relies on the presence of the server process to operate as one example. </p>
+<p>Attaching to a process requires a both target device running the Symbian OS and the presence of a TRK debug agent on the device. <span class="note">You can also use the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view to attach to a process while debugging.</span> However, you can not attach to a process running on an emulator. </p>
+<p>If the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> created the Attach to Process launch configuration no changes are usually needed. The Attach to Process options match those of System TRK with one additional step, selection of the process to debug in the <b>Attach to Process</b> dialog. </p>
+<p>To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Attach to Process configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
+<p align="center"><img src="../images/wnd_debug_attach_process_launch_config.png" width="800" height="582"></p>
+<p class="figure">Figure 1. Attach to Process launch configuration in the Debug dialog </p>
+<p>The <span class="figure">Attach to Process</span> launch configuration panes include:</p>
+<ul>
+ <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
+ <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging, target options, and instruction set.</li>
+ <li>The <a href="page_rom_log.htm">ROM Log </a> tab allows you to specify where the ROM log file is stored and the <span class="code">Epoc32</span> directory.</li>
+ <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
+ <li>The <a href="wiz_new_launch_config.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
+</ul>
+<h4>Other references</h4>
+<ul>
+ <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/customizing_launch_configs.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/customizing_launch_configs.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,79 +1,75 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
- <meta http-equiv="Content-Type"
- content="text/html; charset=ISO-8859-1" />
- <meta http-equiv="Content-Style-Type" content="text/css" />
- <meta name="LASTUPDATED" content="06/17/05 11:09:43" />
- <title>Customizing Launch Configurations</title>
- <link rel="StyleSheet" href="../../../book.css" type="text/css" />
-</head>
-<body bgcolor="#ffffff">
-<h2>Customizing Launch Configurations</h2>
-<p>Use the <a href="wnd_debug_configuration.htm">Debug</a> dialog to customize launch configurations previously created in a project, or to create new launch configurations. Ideally, you should create new launch configurations using the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a>. Doing this will ensure that the project's default launch configuration is valid and can successfully launch a debug session. However, not all default launch configurations satisfy all the needs of a project, so being able to modify a launch configuration's options can allow you to customize how the project is launched and debugged based on the needs of that project. </p>
-<p>There are two methods for setting up a launch configuration, including:</p>
-<ul>
- <li><b>Default launch configuration</b> (recommended) — the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> automatically sets up a default launch configuration to run or debug the project on the first <b>Run</b> or <b>Debug</b> execution. This provides a quick and easy method to start running or debugging a project without the inconvenience of setting a lot of options. The default launch configuration can always be edited later as the project launch requirements change.</li>
- <li><b>Custom launch configuration</b>— enables you to create or modify a launch configuration to suit the needs of the project. To modify a launch configuration, create one using the <b>New Launch Configuration Wizard</b>, then enable the <b>Advanced Options</b> option on the <b>New Launch Configuration</b> page before you click <b>Finish</b>. This opens the <b>Debug</b> dialog so you can immediately customize the new launch configuration's options. </li>
-</ul>
-<p class="note"><b>NOTE</b> To see if a project already has a launch configuration, open a Run or Debug window using the <b>Run > Open Run Dialog...</b> or <b>Run > Open Debug Dialog...</b> menu items.
- </blockquote>
-</p>
- <p>In the event that the default launch configuration settings need to be changed, it is possible to edit them in the <a href="../../reference/wnd_debug_configuration.htm">Debug</a> window, or create a new launch configuration for the project that deviates from the default settings.</p>
-<div class="step">
-<h4>Creating a Custom Launch Configuration </h4>
-<ol>
- <li>Open the Run or Debug launch configuration window
- <ul>
- <li>Select the Run> <b>Open Run Dialog</b>... or <b>Run > Open Debug Dialog... </b> menu item
- <p>The appropriate Run or <a href="../../reference/wnd_debug_configuration.htm">Debug</a> launch configuration window appears (Figure 1).</p>
- </li>
- </ul>
- <p align="center"><img src="images/wnd_launch_config_blank.png" width="709" height="455" alt="Undefined launch configuration"/> </p>
- <p class="figure">Figure 1 - Initial blank Debug launch configuration window</p>
- </li>
- <li>Select a type of launch configuration (for example, Symbian OS Emulation), then click the New launch configuration icon to create a new
- configuration of that type.
- <p>A new configuration appears in the Configuration list under the
- appropriate section using the project name and target to create the configuration name.</p>
- <p class="note"><b>NOTE</b> By default, when you click New, the project information is used to fill in the Project and Process to launch text boxes. You normally should not have to edit these for a run/debug a project. If a bld.inf has multiple MMPS then the first executable named in the list of MMP files is used to fill in the executable field. Therefore, for projects with multiple MMPs you may need to change the executable field. </p>
- <p align="center"><img src="images/wnd_launch_config_new.png" width="787" height="489" alt="New launch configuration" /></p>
- <p class="figure">Figure 2 - New launch configuration with name and settings filled in (emulator)</p>
- </li>
- <li>View the information to define the project and executable
- <p>Modify or fill in the following fields in the Main tab so the IDE
- can setup the configuration properly each time. Typically when creating
- a new executable from a project that has successfully linked, the
- fields will be auto-populated and do not need to be modified. The important fields here are:</p>
- <ul>
- <li>Name - <span style="font-weight: normal;">This is a unique name to identify this launch configuration. It can be any name.</span> </li>
- <li>Project - <span style="font-weight: normal;">The project to associate with this launch configuration. Click Browse to select a different project.</span></li>
- <li>Process to launch - <span style="font-weight: normal;">This is the name of the executable that is linked to the project.</span></li>
- </ul>
- </li>
-
- <li>Modify settings in the other tabs to customize the launch configuration
- for the project
- <ul>
- <li>Environment (<i>Eclipse</i>) </li>
- <li><a href="../../reference/launch_configs/emulator_debugger.htm">Debugger</a></li>
- <li><a href="../../reference/launch_configs/page_executables.htm">Executables</a></li>
- <li><a href="../../reference/wnd_carbide_pref_x86.htm">x86 Exceptions</a> </li>
- <li>Arguments (<i>Eclipse</i>) </li>
- <li>Source (<i>Eclipse</i>) </li>
- <li>Common (<i>Eclipse</i>) </li>
- </ul>
- <p>To debug something outside of the workspace, be sure to import the binary into the <a href="../../reference/view_executables.htm">Executables</a> view. </p>
- </li>
- <li>Click Debug
- <p>The IDE launches the executable. If the launch configuration is set to change perspective, it switches to the specified perspective. </p>
- </li>
-</ol>
-</div>
-<h4>Other references</h4>
-<ul>
- <li></li>
-</ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="Content-Type"
+ content="text/html; charset=ISO-8859-1" />
+ <meta http-equiv="Content-Style-Type" content="text/css" />
+ <meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+ <title>Customizing Launch Configurations</title>
+ <link rel="StyleSheet" href="../../../book.css" type="text/css" />
+</head>
+<body bgcolor="#ffffff">
+<h2>Customizing Launch Configurations</h2>
+<p>Use the <a href="wnd_debug_configuration.htm">Debug</a> dialog to customize launch configurations previously created in a project, or to create new launch configurations. Ideally, you should create new launch configurations using the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a>. Doing this will ensure that the project's default launch configuration is valid and can successfully launch a debug session. However, not all default launch configurations satisfy all the needs of a project, so being able to modify a launch configuration's options can allow you to customize how the project is launched and debugged based on the needs of that project. </p>
+<p>There are two methods for setting up a launch configuration, including:</p>
+<ul>
+ <li><b>Default launch configuration</b> (recommended) — the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> automatically sets up a default launch configuration to run or debug the project on the first <b>Run</b> or <b>Debug</b> execution. This provides a quick and easy method to start running or debugging a project without the inconvenience of setting a lot of options. The default launch configuration can always be edited later as the project launch requirements change.</li>
+ <li><b>Custom launch configuration</b>— enables you to create or modify a launch configuration to suit the needs of the project. To modify a launch configuration, create one using the <b>New Launch Configuration Wizard</b>, then enable the <b>Advanced Options</b> option on the <b>New Launch Configuration</b> page before you click <b>Finish</b>. This opens the <b>Debug</b> dialog so you can immediately customize the new launch configuration's options. </li>
+</ul>
+<p class="note"><b>NOTE</b> To see if a project already has a launch configuration, open a Run or Debug window using the <b>Run > Open Run Dialog...</b> or <b>Run > Open Debug Dialog...</b> menu items.
+
+</p>
+ <p>In the event that the default launch configuration settings need to be changed, it is possible to edit them in the <a href="../../reference/wnd_debug_configuration.htm">Debug</a> window, or create a new launch configuration for the project that deviates from the default settings.</p>
+<div class="step">
+<h4>Creating a Custom Launch Configuration </h4>
+<ol>
+ <li>Open the Run or Debug launch configuration window
+ <ul>
+ <li>Select the Run> <b>Open Run Dialog</b>... or <b>Run > Open Debug Dialog... </b> menu item
+ <p>The appropriate Run or <a href="../../reference/wnd_debug_configuration.htm">Debug</a> launch configuration window appears (Figure 1).</p>
+ </li>
+ </ul>
+ <p align="center"><img src="images/wnd_launch_config_blank.png" width="709" height="455" alt="Undefined launch configuration"/> </p>
+ <p class="figure">Figure 1 - Initial blank Debug launch configuration window</p>
+ </li>
+ <li>Select a type of launch configuration (for example, Symbian OS Emulation), then click the New launch configuration icon to create a new
+ configuration of that type.
+ <p>A new configuration appears in the Configuration list under the
+ appropriate section using the project name and target to create the configuration name.</p>
+ <p class="note"><b>NOTE</b> By default, when you click New, the project information is used to fill in the Project and Process to launch text boxes. You normally should not have to edit these for a run/debug a project. If a bld.inf has multiple MMPS then the first executable named in the list of MMP files is used to fill in the executable field. Therefore, for projects with multiple MMPs you may need to change the executable field. </p>
+ <p align="center"><img src="images/wnd_launch_config_new.png" width="787" height="489" alt="New launch configuration" /></p>
+ <p class="figure">Figure 2 - New launch configuration with name and settings filled in (emulator)</p>
+ </li>
+ <li>View the information to define the project and executable
+ <p>Modify or fill in the following fields in the Main tab so the IDE
+ can setup the configuration properly each time. Typically when creating
+ a new executable from a project that has successfully linked, the
+ fields will be auto-populated and do not need to be modified. The important fields here are:</p>
+ <ul>
+ <li>Name - <span style="font-weight: normal;">This is a unique name to identify this launch configuration. It can be any name.</span> </li>
+ <li>Project - <span style="font-weight: normal;">The project to associate with this launch configuration. Click Browse to select a different project.</span></li>
+ <li>Process to launch - <span style="font-weight: normal;">This is the name of the executable that is linked to the project.</span></li>
+ </ul>
+ </li>
+
+ <li>Modify settings in the other tabs to customize the launch configuration
+ for the project
+ <ul>
+ <li>Environment (<i>Eclipse</i>) </li>
+ <li><a href="page_debugger.htm">Debugger</a></li>
+ <li><a href="page_executables.htm">Executables</a></li>
+ <li><a href="page_exceptions.htm">x86 Exceptions</a> </li>
+ <li>Arguments (<i>Eclipse</i>) </li>
+ <li>Source (<i>Eclipse</i>) </li>
+ <li>Common (<i>Eclipse</i>) </li>
+ </ul>
+ <p>To debug something outside of the workspace, be sure to import the binary into the <a href="../../reference/view_executables.htm">Executables</a> view. </p>
+ </li>
+ <li>Click Debug
+ <p>The IDE launches the executable. If the launch configuration is set to change perspective, it switches to the specified perspective. </p>
+ </li>
+</ol>
+</div>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/emulation.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/emulation.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,33 +1,33 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Emulator Launch Configuration</title>
-<link href="../../../book.css" rel="stylesheet" type="text/css">
-</head>
-
-<body>
-<h2>Emulator Launch Configuration</h2>
-<p>Select the <b>Symbian OS Emulator</b> launch configuration to run or debug executables using an emulator. </p>
-<p>If the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create a emulator launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Symbian OS Emulation launch configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
-<p align="center"><img src="../images/wnd_debug_emulation_launch_config.png" width="658" height="403"></p>
-<p class="figure">Figure 1 - Emulator launch configuration in Debug dialog </p>
-<p>The <b>Debug</b> window provides C/C++ emulator debug options when a Symbian OS Emulation launch configuration is created. The settings included in the Symbian OS Emulation launch configuration are a combination of Carbide, CDT, and Eclipse options. The tabs in the window include: </p>
-<ul>
- <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project containing the class to launch in the project field, and the executable name in the the Executable field and the emulator or host application in the Emulator or host application field. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm">Arguments</a> tab (<i>standard CDT page</i>) defines the arguments to be passed to the application and to the virtual machine (if any). You can also specify the working directory to be used by the launched application. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_env.htm">Environment</a> tab (<i>standard CDT page</i>) defines the environment variable values to use when running or debugging a program. By default, the environment is inherited from the Eclipse runtime. You may override or append to the inherited environment. </li>
- <li>The <a href="page_debugger.htm">Debugger</a> tab provides common debugger options for the project.</li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables are debugged by your project.</li>
- <li>The <a href="page_exceptions.htm">x86 Exceptions</a> tab lists all the x86 exceptions that the debugger can catch.</li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file and specify which perspectives become active when the launch configuration is launched. </li>
-</ul>
-<h4>Other references</h4>
-<ul>
- <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Emulator Launch Configuration</title>
+<link href="../../../book.css" rel="stylesheet" type="text/css">
+</head>
+
+<body>
+<h2>Emulator Launch Configuration</h2>
+<p>Select the <b>Symbian OS Emulator</b> launch configuration to run or debug executables using an emulator. </p>
+<p>If the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create a emulator launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Symbian OS Emulation launch configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
+<p align="center"><img src="../images/wnd_debug_emulation_launch_config.png" width="658" height="403"></p>
+<p class="figure">Figure 1 - Emulator launch configuration in Debug dialog </p>
+<p>The <b>Debug</b> window provides C/C++ emulator debug options when a Symbian OS Emulation launch configuration is created. The settings included in the Symbian OS Emulation launch configuration are a combination of Carbide, CDT, and Eclipse options. The tabs in the window include: </p>
+<ul>
+ <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project containing the class to launch in the project field, and the executable name in the the Executable field and the emulator or host application in the Emulator or host application field. </li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm">Arguments</a> tab (<i>standard CDT page</i>) defines the arguments to be passed to the application and to the virtual machine (if any). You can also specify the working directory to be used by the launched application. </li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_env.htm">Environment</a> tab (<i>standard CDT page</i>) defines the environment variable values to use when running or debugging a program. By default, the environment is inherited from the Eclipse runtime. You may override or append to the inherited environment. </li>
+ <li>The <a href="page_debugger.htm">Debugger</a> tab provides common debugger options for the project.</li>
+ <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables are debugged by your project.</li>
+ <li>The <a href="page_exceptions.htm">x86 Exceptions</a> tab lists all the x86 exceptions that the debugger can catch.</li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
+ <li>The <a href="wiz_new_launch_config.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file and specify which perspectives become active when the launch configuration is launched. </li>
+</ul>
+<h4>Other references</h4>
+<ul>
+ <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/launch_configs_overview.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/launch_configs_overview.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,37 +1,37 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Launch Configuration Overview</title>
-<link href="../../../book.css" rel="stylesheet" type="text/css"></head>
-
-<body>
-<h2>Launch Configuration Overview</h2>
-<p>A <b>launch configuration</b> defines the operational settings used by the Carbide.c++ tools to launch and debug programs. A project must have at least one launch configuration, and can have as many as necessary. This enables you to develop and debug your project using various compilers (GCCE and RVCT) and different targets (emulator and on-device) as each launch configuration can be tailored to fit the intended target. </p>
-<h4>Creating a Launch Configuration </h4>
-<p>To create a default launch configuration for a project use the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a>. Using this method ensures that you have a working launch configuration for the project. You can invoke the New Launch Configuration Wizard for projects lacking a launch configuration by selecting the <b>Run > Debug</b> (<span class="code">F11</span>) or<b> </b><b>Run > Run</b> (<span class="code">CTRL+F11</span>) menu options, or clicking the <b>Run</b> (<img src="../../images/icons/btn_run.png" alt="Run icon" width="16" height="16" align="absmiddle" />) or <b>Debug</b> (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" alt="Debug icon"/>) icons in the toolbar. If a project already has a defined launch configuration, selecting the <b>Run</b> or <b>Debug</b> command calls the previously defined and last used launch configuration, bypassing the wizard entirely.</p>
-<p>For emulator projects the wizard simply gathers the data it needs from the project and creates an emulator launch configuration and launches the emulator. For on-device targets, more information is required, so the wizard asks for the missing information it needs, creates the launch configuration, then downloads the executable to the device and launches it. Once the emulator or device is loaded with the executable, the debug session commences. </p>
-<p>You can customize any project launch configuration afterward using the <b>Debug</b> dialog as necessary. </p>
-<h4>Available Launch Configurations</h4>
-<p>Launch configurations come in several varieties, each designed for a specific purpose. You must choose one at the very start of the New Launch Configuration Wizard, so knowing the differences between them is important. Currently, the types to choose from include: </p>
-<ul>
- <li><b><a href="applications.htm">Symbian OS Application</a></b>—used to run or debug executables. </li>
- <li><b><a href="run_mode.htm">Symbian OS Appication TRK</a></b> —used to run or debug applications on a target device using the Application TRK on-device debug agent. Application TRK is an application that runs on released phones and allows you to debug your executables. The debugger will download a Symbian OS installation file to the phone and install it prior to launching.</li>
- <li><b><a href="attach_process.htm">Symbian OS Attach to Process</a></b> —used to debug processes running on a target device for which a symbol file is available. This is available only for TRK and stop mode debugging. This launch configuration is not available for emulator debugging. Stop mode and TRK can both attach to a process from the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view.</li>
- <li><b>Symbian OS Crash Debugger</b> —used to launch an interactive command-line session with the Symbian OS crash debugger when the device crashes </li>
- <li><b><a href="emulation.htm">Symbian OS Emulation</a> </b>—used to run or debug executables on an emulator. </li>
- <li><b><a href="sophia.htm">Symbian OS Sophia</a> </b> (<i>only available in OEM Edition</i>)—is an external debugger that the Carbide debugger communicates with, to debug any Symbian OS module on a target using a JTAG connection.</li>
- <li><b><a href="stop_mode.htm">Symbian OS System TRK</a></b> (<i>not available Developer Editions</i>) —used to run or debug applications or ROM code on a target device using the System TRK on-device debug agent. System TRK is an application that runs on reference boards and prototype phones and allows you to debug your executables. The debugger will download files to the phone prior to launching.</li>
- <li><b><a href="trace32.htm">Symbian OS Trace32</a></b> (<i>only available in OEM Edition</i>)—is an external debugger that the Carbide debugger communicates with, to debug any Symbian OS module on a target using a JTAG connection.</li>
-</ul>
-<p class="note"><b>NOTE</b> The specific launch configuration availability is determined by the Carbide.c++ edition you are using. </p>
-<h4>Other references</h4>
-<ul>
- <li>Creating Projects Overview </li>
- <li><a href="../../tasks/projects/wiz_new_launch_config.htm">New Launch Configuration Wizard</a></li>
- <li><a href="wnd_debug_configuration.htm">Debug</a> dialog </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Launch Configuration Overview</title>
+<link href="../../../book.css" rel="stylesheet" type="text/css"></head>
+
+<body>
+<h2>Launch Configuration Overview</h2>
+<p>A <b>launch configuration</b> defines the operational settings used by the Carbide.c++ tools to launch and debug programs. A project must have at least one launch configuration, and can have as many as necessary. This enables you to develop and debug your project using various compilers (GCCE and RVCT) and different targets (emulator and on-device) as each launch configuration can be tailored to fit the intended target. </p>
+<h4>Creating a Launch Configuration </h4>
+<p>To create a default launch configuration for a project use the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a>. Using this method ensures that you have a working launch configuration for the project. You can invoke the New Launch Configuration Wizard for projects lacking a launch configuration by selecting the <b>Run > Debug</b> (<span class="code">F11</span>) or<b> </b><b>Run > Run</b> (<span class="code">CTRL+F11</span>) menu options, or clicking the <b>Run</b> (<img src="../../images/icons/btn_run.png" alt="Run icon" width="16" height="16" align="absmiddle" />) or <b>Debug</b> (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" alt="Debug icon"/>) icons in the toolbar. If a project already has a defined launch configuration, selecting the <b>Run</b> or <b>Debug</b> command calls the previously defined and last used launch configuration, bypassing the wizard entirely.</p>
+<p>For emulator projects the wizard simply gathers the data it needs from the project and creates an emulator launch configuration and launches the emulator. For on-device targets, more information is required, so the wizard asks for the missing information it needs, creates the launch configuration, then downloads the executable to the device and launches it. Once the emulator or device is loaded with the executable, the debug session commences. </p>
+<p>You can customize any project launch configuration afterward using the <b>Debug</b> dialog as necessary. </p>
+<h4>Available Launch Configurations</h4>
+<p>Launch configurations come in several varieties, each designed for a specific purpose. You must choose one at the very start of the New Launch Configuration Wizard, so knowing the differences between them is important. Currently, the types to choose from include: </p>
+<ul>
+ <li><b><a href="applications.htm">Symbian OS Application</a></b>—used to run or debug executables. </li>
+ <li><b><a href="run_mode.htm">Symbian OS Appication TRK</a></b> —used to run or debug applications on a target device using the Application TRK on-device debug agent. Application TRK is an application that runs on released phones and allows you to debug your executables. The debugger will download a Symbian OS installation file to the phone and install it prior to launching.</li>
+ <li><b><a href="attach_process.htm">Symbian OS Attach to Process</a></b> —used to debug processes running on a target device for which a symbol file is available. This is available only for TRK and stop mode debugging. This launch configuration is not available for emulator debugging. Stop mode and TRK can both attach to a process from the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view.</li>
+ <li><b>Symbian OS Crash Debugger</b> —used to launch an interactive command-line session with the Symbian OS crash debugger when the device crashes </li>
+ <li><b><a href="emulation.htm">Symbian OS Emulation</a> </b>—used to run or debug executables on an emulator. </li>
+ <li><b><a href="sophia.htm">Symbian OS Sophia</a> </b> (<i>only available in OEM Edition</i>)—is an external debugger that the Carbide debugger communicates with, to debug any Symbian OS module on a target using a JTAG connection.</li>
+ <li><b><a href="stop_mode.htm">Symbian OS System TRK</a></b> (<i>not available Developer Editions</i>) —used to run or debug applications or ROM code on a target device using the System TRK on-device debug agent. System TRK is an application that runs on reference boards and prototype phones and allows you to debug your executables. The debugger will download files to the phone prior to launching.</li>
+ <li><b><a href="trace32.htm">Symbian OS Trace32</a></b> (<i>only available in OEM Edition</i>)—is an external debugger that the Carbide debugger communicates with, to debug any Symbian OS module on a target using a JTAG connection.</li>
+</ul>
+<p class="note"><b>NOTE</b> The specific launch configuration availability is determined by the Carbide.c++ edition you are using. </p>
+<h4>Other references</h4>
+<ul>
+ <li>Creating Projects Overview </li>
+ <li><a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a></li>
+ <li><a href="wnd_debug_configuration.htm">Debug</a> dialog </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/page_main.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/page_main.htm Mon Aug 10 15:50:55 2009 -0500
@@ -17,7 +17,7 @@
</ul>
<h3><a name="emulator_mode" id="emulator_mode"></a>Emulation Main page </h3>
<p>The <b>Symbian OS <a href="emulation.htm">Emulation</a></b> launch configuration uses the <b>Main</b> page to define the process to be launched by the emulator. </p>
-<p>The behavior that occurs when launching a debug session varies based upon the <a href="page_main.htm">SDK</a>. Normally, <a href="../../tasks/debugger/work_debug_act_start.htm">starting</a> a debug session launches the emulator (<span class="code">epoc.exe</span>) and you must then navigate to your application and open it. However, starting a debug session for an .exe file will, in most cases, launch the .exe directly. This starts the emulator and then opens your application automatically. Note that some SDKs do not support this behavior. In those cases you must still open your application in the emulator manually.</p>
+<p>The behavior that occurs when launching a debug session varies based upon the <a href="page_main.htm">SDK</a>. Normally, <a href="../../debugger/debug/cmds_starting.htm">starting</a> a debug session launches the emulator (<span class="code">epoc.exe</span>) and you must then navigate to your application and open it. However, starting a debug session for an .exe file will, in most cases, launch the .exe directly. This starts the emulator and then opens your application automatically. Note that some SDKs do not support this behavior. In those cases you must still open your application in the emulator manually.</p>
<p align="center"><img src="images/page_debug_main.png" width="627" height="243"></p>
<p class="figure">Figure 1. Main page (Emulation shown) </p>
<h5>Table 1. Emulator Main page —items </h5>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/pages_overview.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/pages_overview.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,28 +1,28 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Carbide Configuration Pages</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Configuration Pages</h2>
-<p>The pages in the <a href="wnd_debug_configuration.htm">Debug</a> dialog used to set options for the various launch configurations include: </p>
-<ul>
- <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm">Arguments</a> (<i>standard CDT page</i>) </li>
- <li><a href="page_debugger.htm">Debugger</a></li>
- <li><a href="page_executables.htm">Executables</a></li>
- <li><a href="page_file_transfer.htm">File Transfer</a></li>
- <li><a href="page_installation.htm">Installation</a> </li>
- <li><a href="page_main.htm">Main</a></li>
- <li><a href="page_rom_image.htm">ROM Image</a></li>
- <li><a href="page_rom_log.htm">ROM Log</a></li>
- <li><a href="page_exceptions.htm">x86 Exceptions</a></li>
- <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> (<i>standard CDT page</i>) </li>
- <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> (<i>standard CDT page</i>) </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Carbide Configuration Pages</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Configuration Pages</h2>
+<p>The pages in the <a href="wnd_debug_configuration.htm">Debug</a> dialog used to set options for the various launch configurations include: </p>
+<ul>
+ <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm">Arguments</a> (<i>standard CDT page</i>) </li>
+ <li><a href="page_debugger.htm">Debugger</a></li>
+ <li><a href="page_executables.htm">Executables</a></li>
+ <li><a href="page_file_transfer.htm">File Transfer</a></li>
+ <li><a href="page_installation.htm">Installation</a> </li>
+ <li><a href="page_main.htm">Main</a></li>
+ <li><a href="page_rom_image.htm">ROM Image</a></li>
+ <li><a href="page_rom_log.htm">ROM Log</a></li>
+ <li><a href="page_exceptions.htm">x86 Exceptions</a></li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> (<i>standard CDT page</i>) </li>
+ <li><a href="wiz_new_launch_config.htm">Common</a> (<i>standard CDT page</i>) </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/run_mode.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/run_mode.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,33 +1,33 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Application TRK Launch Configuration</title>
-<link href="../../../book.css" rel="stylesheet" type="text/css">
-</head>
-
-<body>
-<h2>Application TRK Launch Configuration (Run-mode) </h2>
-<p>Select the <b>Symbian OS Application TRK </b> launch configuration to debug or run applications on a target device using the Application TRK on-device debug agent. Application TRK is an application that runs on released phones and allows you to debug your executables. The debugger will download a Symbian OS installation file to the phone and install it prior to launching.</p>
-<p>If the <a href="../../launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create the Application TRK launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Application TRK configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
-<p align="center"><img src="../images/wnd_debug_AppTRK_launch_config.png" width="871" height="600"></p>
-<p class="figure">Figure 1. Application TRK launch configuration in the Debug dialog </p>
-<p>The Application TRK launch configuration panes include: </p>
-<ul>
- <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm">Arguments</a> tab (<i>standard CDT page</i>) lets you specify the program arguments that an application uses.</li>
- <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging and target options.</li>
- <li>The <a href="page_file_transfer.htm">File Transfer</a> tab displays an auto-populated list of files that the IDE transfers to the target device at the start of each launch. </li>
- <li>The <a href="page_installation.htm">Installation</a> tab specifies the .sis file(s) to install on the target device.</li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file</li>
-</ul>
-<h4>Other references</h4>
-<ul>
- <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Application TRK Launch Configuration</title>
+<link href="../../../book.css" rel="stylesheet" type="text/css">
+</head>
+
+<body>
+<h2>Application TRK Launch Configuration (Run-mode) </h2>
+<p>Select the <b>Symbian OS Application TRK </b> launch configuration to debug or run applications on a target device using the Application TRK on-device debug agent. Application TRK is an application that runs on released phones and allows you to debug your executables. The debugger will download a Symbian OS installation file to the phone and install it prior to launching.</p>
+<p>If the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create the Application TRK launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Application TRK configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
+<p align="center"><img src="../images/wnd_debug_AppTRK_launch_config.png" width="871" height="600"></p>
+<p class="figure">Figure 1. Application TRK launch configuration in the Debug dialog </p>
+<p>The Application TRK launch configuration panes include: </p>
+<ul>
+ <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm">Arguments</a> tab (<i>standard CDT page</i>) lets you specify the program arguments that an application uses.</li>
+ <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging and target options.</li>
+ <li>The <a href="page_file_transfer.htm">File Transfer</a> tab displays an auto-populated list of files that the IDE transfers to the target device at the start of each launch. </li>
+ <li>The <a href="page_installation.htm">Installation</a> tab specifies the .sis file(s) to install on the target device.</li>
+ <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
+ <li>The <a href="wiz_new_launch_config.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file</li>
+</ul>
+<h4>Other references</h4>
+<ul>
+ <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/sophia.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/sophia.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,32 +1,32 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Sophia Launch Configuration</title>
-<link href="../../../book.css" rel="stylesheet" type="text/css">
-</head>
-
-<body>
-<h2>Sophia Launch Configuration</h2>
-<p>Select the <b>Symbian OS Sophia </b> target interface (STI) launch configuration (<i>only available in OEM Edition</i>) to debug any Symbian OS module on a target using a JTAG connection. The external Sophia debugger communicates with the Carbide debugger and enables stop mode debugging of the target device. </p>
-<p>If the <a href="../../launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create an Sophia launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Sophia configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
-<p align="center"><img src="../images/wnd_debug_sophia_launch_config.png" width="654" height="480"></p>
-<p class="figure">Figure 1. Sophia launch configuration in the Debug dialog </p>
-<p>The Sophia launch configuration panes include:</p>
-<ul>
- <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
- <li>The <a href="page_connection.htm">Connection</a> tab defines the Sophia Target Interface, EJ_Debug type, and JTAG TCLK Frequency.</li>
- <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging, target options, and instruction set.</li>
- <li>The <a href="page_rom_image.htm">ROM Image</a> tab allows you to define startup options and ROM image and ROM log file download information.</li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
-</ul>
-<h4>Other references</h4>
-<ul>
- <li><a href="../../launch/launch_configs_overview.htm">Launch Configuration Overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Sophia Launch Configuration</title>
+<link href="../../../book.css" rel="stylesheet" type="text/css">
+</head>
+
+<body>
+<h2>Sophia Launch Configuration</h2>
+<p>Select the <b>Symbian OS Sophia </b> target interface (STI) launch configuration (<i>only available in OEM Edition</i>) to debug any Symbian OS module on a target using a JTAG connection. The external Sophia debugger communicates with the Carbide debugger and enables stop mode debugging of the target device. </p>
+<p>If the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create an Sophia launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Sophia configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
+<p align="center"><img src="../images/wnd_debug_sophia_launch_config.png" width="654" height="480"></p>
+<p class="figure">Figure 1. Sophia launch configuration in the Debug dialog </p>
+<p>The Sophia launch configuration panes include:</p>
+<ul>
+ <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
+ <li>The <a href="page_connection.htm">Connection</a> tab defines the Sophia Target Interface, EJ_Debug type, and JTAG TCLK Frequency.</li>
+ <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging, target options, and instruction set.</li>
+ <li>The <a href="page_rom_image.htm">ROM Image</a> tab allows you to define startup options and ROM image and ROM log file download information.</li>
+ <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
+</ul>
+<h4>Other references</h4>
+<ul>
+ <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/stop_mode.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/stop_mode.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,31 +1,31 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>System TRK Launch Configuration</title>
-<link href="../../../book.css" rel="stylesheet" type="text/css">
-</head>
-
-<body>
-<h2>System TRK Launch Configuration (Stop-mode) </h2>
-<p>Select the <b>Symbian OS System TRK </b> launch configuration (<i>only available in OEM Edition</i>) provides C/C++ stop-mode debug options that use a JTAG interface when a Symbian OS <a href="sophia.htm">Sophia</a> or <a href="trace32.htm">Trace32</a> launch configuration is created. The settings included in these launch configuration are a combination of Carbide, CDT, and Eclipse options. </p>
-<p>If the <a href="../../launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create the System TRK launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the System TRK configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
-<p align="center"><img src="../images/wnd_debug_trace32_launch_config.png" width="832" height="640"></p>
-<p class="figure">Figure 1. System TRK launch configuration in the Debug dialog </p>
-<p>The System TRK launch configuration panes include: </p>
-<ul>
- <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
- <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging and target options.</li>
- <li>The <a href="page_rom_image.htm">ROM Image</a> tab allows you to define startup options and ROM image download information.</li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
-</ul>
-<h4>Other references</h4>
-<ul>
- <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>System TRK Launch Configuration</title>
+<link href="../../../book.css" rel="stylesheet" type="text/css">
+</head>
+
+<body>
+<h2>System TRK Launch Configuration (Stop-mode) </h2>
+<p>Select the <b>Symbian OS System TRK </b> launch configuration (<i>only available in OEM Edition</i>) provides C/C++ stop-mode debug options that use a JTAG interface when a Symbian OS <a href="sophia.htm">Sophia</a> or <a href="trace32.htm">Trace32</a> launch configuration is created. The settings included in these launch configuration are a combination of Carbide, CDT, and Eclipse options. </p>
+<p>If the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create the System TRK launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the System TRK configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
+<p align="center"><img src="../images/wnd_debug_trace32_launch_config.png" width="832" height="640"></p>
+<p class="figure">Figure 1. System TRK launch configuration in the Debug dialog </p>
+<p>The System TRK launch configuration panes include: </p>
+<ul>
+ <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
+ <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging and target options.</li>
+ <li>The <a href="page_rom_image.htm">ROM Image</a> tab allows you to define startup options and ROM image download information.</li>
+ <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
+ <li>The <a href="wiz_new_launch_config.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
+</ul>
+<h4>Other references</h4>
+<ul>
+ <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/trace32.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/trace32.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,31 +1,31 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Trace32 Launch Configuration</title>
-<link href="../../../book.css" rel="stylesheet" type="text/css">
-</head>
-
-<body>
-<h2> Trace32 Launch Configuration</h2>
-<p>Select the <b>Symbian OS Trace32 </b> launch configuration (<i>only available in OEM Edition</i>) to debug any Symbian OS module on a target using a JTAG connection. The external Trace32 debugger communicates with the Carbide debugger and enables stop mode debugging of the target device. </p>
-<p>If the <a href="../../launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create a Trace32 launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Trace32 configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
-<p align="center"><img src="../images/wnd_debug_trace32_launch_config.png" width="832" height="640"></p>
-<p class="figure">Figure 1. Trace32 launch configuration in the Debug dialog </p>
-<p>The Trace32 launch configuration panes include: </p>
-<ul>
- <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
- <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging and target options.</li>
- <li>The <a href="page_rom_image.htm">ROM Image</a> tab allows you to define startup options and ROM image download information.</li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
-</ul>
-<h4>Other references</h4>
-<ul>
- <li><a href="../../launch/launch_configs_overview.htm">Launch Configuration Overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Trace32 Launch Configuration</title>
+<link href="../../../book.css" rel="stylesheet" type="text/css">
+</head>
+
+<body>
+<h2> Trace32 Launch Configuration</h2>
+<p>Select the <b>Symbian OS Trace32 </b> launch configuration (<i>only available in OEM Edition</i>) to debug any Symbian OS module on a target using a JTAG connection. The external Trace32 debugger communicates with the Carbide debugger and enables stop mode debugging of the target device. </p>
+<p>If the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create a Trace32 launch configuration no changes are usually needed. To modify the launch configuration settings, select the <b>Run > Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Trace32 configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
+<p align="center"><img src="../images/wnd_debug_trace32_launch_config.png" width="832" height="640"></p>
+<p class="figure">Figure 1. Trace32 launch configuration in the Debug dialog </p>
+<p>The Trace32 launch configuration panes include: </p>
+<ul>
+ <li>The <a href="page_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
+ <li>The <a href="page_debugger.htm">Debugger</a> tab defines debug configurations, such as entry point to begin debugging and target options.</li>
+ <li>The <a href="page_rom_image.htm">ROM Image</a> tab allows you to define startup options and ROM image download information.</li>
+ <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables that you want to debug that are part of the project.</li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
+ <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
+</ul>
+<h4>Other references</h4>
+<ul>
+ <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/wiz_new_launch_config.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/wiz_new_launch_config.htm Mon Aug 10 15:50:55 2009 -0500
@@ -10,7 +10,7 @@
</head>
<body bgcolor="#ffffff">
<h2>New Launch Configuration Wizard </h2>
-<p>The <b>New Launch Configuration Wizard</b> launches when no launch configuration exists for a project. Wherever possible the <b>New Launch Configuration </b> wizard gathers the information from the project and asks additional questions based on the type of launch configuration chosen. For example, a launch configuration using Application TRK requires different information than one targeted for System TRK. </p>
+<p>The <b>New Launch Configuration Wizard</b> launches when no launch configuration exists for a project. Wherever possible the <b>New Launch Configuration </b> wizard gathers the information from the project and asks additional questions based on the type of launch configuration chosen. For example, a launch configuration using Application TRK requires different information than one targeted for System TRK. </p>
<table width="700" border="0" cellpadding="2" cellspacing="0">
<tr>
<th width="41%" scope="col">Launch Configuration</th>
@@ -100,17 +100,17 @@
<p align="center"><img src="../../images/icons/wiz_launch_config_finish.png" width="438" height="533"></p>
<p class="figure">Figure 8 - New Launch Configuration page </p>
<h3><a name="TRACE32" id="TRACE32"></a>Trace32 Initialization Settings</h3>
-<p>Use the <b>Trace32 Initialization Settings</b> page to specify the <a href="../../reference/wnd_Trace32_config.htm">initialization</a> script and target processor of the target device.Enter the Trace32 Initialization Script and choose the Target Processor, then click <b>Next</b>. </p>
+<p>Use the <b>Trace32 Initialization Settings</b> page to specify the <a href="trace32.htm">initialization</a> script and target processor of the target device.Enter the Trace32 Initialization Script and choose the Target Processor, then click <b>Next</b>. </p>
<p> This page only appears when creating a Trace32 launch configuration. </p>
<p align="center"><img src="../../images/icons/wiz_launch_config_trace32.png" width="438" height="533"></p>
<p class="figure">Figure 9 - <b>Trace32 Initialization Settings</b> page </p>
<h3><a name="SOPHIA" id="SOPHIA"></a>Sophia STI Initialization Settings</h3>
-<p>Use the <b>Sophia STI Initialization Settings</b> page to specify the target interface, <a href="../../reference/wnd_sophia_config.htm">initialization</a> file, and target processor of the target device. Enter the Sophia Target Interface and Target Initialization File paths, choose a Target Processor, then click <b>Next</b>. </p>
+<p>Use the <b>Sophia STI Initialization Settings</b> page to specify the target interface, <a href="sophia.htm">initialization</a> file, and target processor of the target device. Enter the Sophia Target Interface and Target Initialization File paths, choose a Target Processor, then click <b>Next</b>. </p>
<p>This page only appears when creating a Sophia STI launch configuration. </p>
<p align="center"><img src="../../images/icons/wiz_launch_config_sophia.png" width="438" height="533"></p>
<p class="figure">Figure 10 - Sophia STI Initialization Settings page </p>
<h3><a name="ROM_IMG" id="ROM_IMG"></a>Symbian ROM Image Settings</h3>
-<p>Use the <b>Symbian ROM Image Settings</b> page to specify the method of <a href="../../reference/launch_configs/page_trk_debugger.htm">debugging</a>, the start address, and the <a href="../../reference/launch_configs/stop_mode_rom_image.htm">ROM Image</a> and Log File locations. </p>
+<p>Use the <b>Symbian ROM Image Settings</b> page to specify the method of <a href="page_debugger.htm">debugging</a>, the start address, and the <a href="page_rom_image.htm">ROM Image</a> and Log File locations. </p>
<p>This page appears when creating a Trace32 or Sophia STI launch configuration. </p>
<p align="center"><img src="../../images/icons/wiz_launch_config_rom_image.png" width="438" height="533"></p>
<p class="figure">Figure 11 - Symbian ROM Image Settings page</p>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/wnd_debug_configuration.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/launch/wnd_debug_configuration.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,66 +1,66 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Carbide Debug dialog</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debug dialog </h2>
-<p>Use the <b>Debug</b> dialog to create, edit, and manage a project's <a href="launch_configs_overview.htm">launch configurations</a>. A <b>launch configuration</b> defines the settings used by the Carbide debugger to launch (Run) or debug programs. A project must have at least one launch configuration in order to debug a project and can have many more. Projects that have no launch configuration invoke the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> when either the <b>Run</b> or <b>Debug</b> command is selected. </p>
-<p>Select the <b>Run > Debug Configuration...</b> menu option to open the <b>Debug</b> dialog.</p>
-<p>The tabs shown in the <b>Debug</b> dialog vary depending upon the type of launch configuration highlighted in the configurations list. See <a href="launch_configs_overview.htm">Launch Configuration Overview</a> for more information on the various launch configuration types. </p>
-<p>Click <b>Debug</b> to start a new debug session using the selected launch configuration. </p>
-<p align="center" class="figure"><img src="../images/wnd_debug_emulation_launch_config.png" width="658" height="403"></p>
-<p align="center" class="figure"> Figure 1 - Debug dialog (Symbian OS Emulation configuration shown)</p>
-<h5>Table 1. Debug dialog — common items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="7%" scope="col">Icon</th>
- <th width="41%" scope="col">Item</th>
- <th width="52%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><div align="center"><img src="images/icon_new_launch_config.png" width="16" height="17"></div></td>
- <td><b>New Launch Configuration</b></td>
- <td><p>Click the New Launch Configuration icon to add a launch configuration to the configurations list. Default information based upon the project is automatically entered into the various text boxes.</p>
- <p class="note"><b>NOTE</b> Normally, you should not have to change any of the default text box entries unless you are creating multiple debug launch configurations for the same project.</p></td>
- </tr>
- <tr>
- <td><div align="center"><img src="images/icon_dup_launch_config.png" width="19" height="19"></div></td>
- <td><b>Duplicate</b></td>
- <td>Click the Duplicate icon to duplicate the currently selected launch configuration. </td>
- </tr>
- <tr>
- <td><div align="center"><img src="images/icon_delete_launch_config.png" width="17" height="16"></div></td>
- <td><b>Delete selected launch configuration(s) </b></td>
- <td>Click the Delete icon to remove the currently selected configuration from the Configurations list.</td>
- </tr>
- <tr>
- <td> </td>
- <td><b>Collapse</b></td>
- <td>Click the Collapse icon to collapse expanded lists of launch configurations.</td>
- </tr>
- <tr>
- <td><div align="center"><img src="images/icon_filter_launch_config.png" width="21" height="18"></div></td>
- <td><b>Filter launch configurations... </b></td>
- <td><p>Click the Filter icon to select filter options that control which launch configurations appear in the list. Filter options include:</p>
- <ul>
- <li>Filter Closed Projects</li>
- <li>Filter Deleted/Unavailable Projects</li>
- <li>Filter Configuration Types</li>
- <li>Apply Window Working Set(s)</li>
- <li><a href="../../reference/trk/panel_filter.htm">Filtering Preferences...</a></li>
- </ul></td>
- </tr>
-</table>
-<h4>Other references</h4>
-<ul>
- <li><a href="../../launch/launch_configs_overview.htm">Launch Configuration Overview</a></li>
- <li><a href="pages_overview.htm">Configuration Pages</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Carbide Debug dialog</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debug dialog </h2>
+<p>Use the <b>Debug</b> dialog to create, edit, and manage a project's <a href="launch_configs_overview.htm">launch configurations</a>. A <b>launch configuration</b> defines the settings used by the Carbide debugger to launch (Run) or debug programs. A project must have at least one launch configuration in order to debug a project and can have many more. Projects that have no launch configuration invoke the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> when either the <b>Run</b> or <b>Debug</b> command is selected. </p>
+<p>Select the <b>Run > Debug Configuration...</b> menu option to open the <b>Debug</b> dialog.</p>
+<p>The tabs shown in the <b>Debug</b> dialog vary depending upon the type of launch configuration highlighted in the configurations list. See <a href="launch_configs_overview.htm">Launch Configuration Overview</a> for more information on the various launch configuration types. </p>
+<p>Click <b>Debug</b> to start a new debug session using the selected launch configuration. </p>
+<p align="center" class="figure"><img src="../images/wnd_debug_emulation_launch_config.png" width="658" height="403"></p>
+<p align="center" class="figure"> Figure 1 - Debug dialog (Symbian OS Emulation configuration shown)</p>
+<h5>Table 1. Debug dialog — common items</h5>
+<table width="94%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="7%" scope="col">Icon</th>
+ <th width="41%" scope="col">Item</th>
+ <th width="52%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="images/icon_new_launch_config.png" width="16" height="17"></div></td>
+ <td><b>New Launch Configuration</b></td>
+ <td><p>Click the New Launch Configuration icon to add a launch configuration to the configurations list. Default information based upon the project is automatically entered into the various text boxes.</p>
+ <p class="note"><b>NOTE</b> Normally, you should not have to change any of the default text box entries unless you are creating multiple debug launch configurations for the same project.</p></td>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="images/icon_dup_launch_config.png" width="19" height="19"></div></td>
+ <td><b>Duplicate</b></td>
+ <td>Click the Duplicate icon to duplicate the currently selected launch configuration. </td>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="images/icon_delete_launch_config.png" width="17" height="16"></div></td>
+ <td><b>Delete selected launch configuration(s) </b></td>
+ <td>Click the Delete icon to remove the currently selected configuration from the Configurations list.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><b>Collapse</b></td>
+ <td>Click the Collapse icon to collapse expanded lists of launch configurations.</td>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="images/icon_filter_launch_config.png" width="21" height="18"></div></td>
+ <td><b>Filter launch configurations... </b></td>
+ <td><p>Click the Filter icon to select filter options that control which launch configurations appear in the list. Filter options include:</p>
+ <ul>
+ <li>Filter Closed Projects</li>
+ <li>Filter Deleted/Unavailable Projects</li>
+ <li>Filter Configuration Types</li>
+ <li>Apply Window Working Set(s)</li>
+ <li><a href="../../reference/trk/panel_filter.htm">Filtering Preferences...</a></li>
+ </ul></td>
+ </tr>
+</table>
+<h4>Other references</h4>
+<ul>
+ <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
+ <li><a href="pages_overview.htm">Configuration Pages</a> </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/debugger_settings.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/debugger_settings.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,31 +1,31 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debugger Settings</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debugger Settings</h2>
-<p>The Carbide.c++ debugger settings include:</p>
-<ul>
- <li><a href="perspective_debug.htm">Debug Perspective</a></li>
- <li><a href="wnd_debug_configuration.htm">Debug Window </a> </li>
- <li><a href="view_debug.htm">Debug View </a></li>
-</ul>
-<h5>Common concepts</h5>
-<ul>
- <li><a href="../concepts/debugger_about.htm">About the Debugger</a></li>
- <li><a href="../concepts/common_debug_actions.htm">Common Debugger Actions </a></li>
-</ul>
-<h5>Common tasks</h5>
-<ul>
- <li><a href="../tasks/start/carbide_debugging.htm">Debugging a Program</a> (Example)</li>
- <li><a href="../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Debugger Settings</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debugger Settings</h2>
+<p>The Carbide.c++ debugger settings include:</p>
+<ul>
+ <li><a href="perspective_debug.htm">Debug Perspective</a></li>
+ <li><a href="wnd_debug_configuration.htm">Debug Window </a> </li>
+ <li><a href="../debugger/debug/viewing_debug.htm">Debug View </a></li>
+</ul>
+<h5>Common concepts</h5>
+<ul>
+ <li><a href="../concepts/debugger_about.htm">About the Debugger</a></li>
+ <li><a href="../concepts/common_debug_actions.htm">Common Debugger Actions </a></li>
+</ul>
+<h5>Common tasks</h5>
+<ul>
+ <li><a href="../tasks/start/carbide_debugging.htm">Debugging a Program</a> (Example)</li>
+ <li><a href="../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/bld_config_sos_apptrk_01.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/bld_config_sos_apptrk_02.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/build_target_only.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/context_menu_breakpoints_view.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/context_menu_registers_view.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/context_menu_variables_view.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/debug_context_menu.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/icon_project_file_link.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/new_launch_config_wiz1.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/page_ROM_log.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/page_emulator_debugger.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/page_run_mode_debugger.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/page_stop_mode_rom_image.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_createsis.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_T32_connection.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_T32_debugger.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_T32_exe.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_T32_image.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_T32_main.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_T32_romlog.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_common.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_debugger.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_main.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_source.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_sti_common.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_sti_connection.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_sti_debugger.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_sti_image.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_sti_main.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_sti_romlog.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_debug_sti_source.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_emulator_main.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_env.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_makesis.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_tool_settings_aif_compiler_01.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_tool_settings_mbm_compiler_01.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_tool_settings_mif_compiler_01.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_trk_common.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_trk_connection.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_trk_debugger.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_trk_exes.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_trk_file_transfer.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_trk_installation.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/panel_trk_source.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/perspective_prefs.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/project_updater.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/select_folder.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_debug.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_debug_restart_btn.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_debug_resume_btn.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_debug_step_into_btn.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_debug_step_over_btn.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_debug_step_return_btn.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_debug_suspend_btn.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_debug_terminate_btn.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_mifdef_editor.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_remote_connections2.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_sos_processes.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/view_variables.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_app_trk_launch_config.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_breakpoint_actions_pref.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_debug_stop_mode_overview.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_edit_mifdef_icon.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_exe_actions.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_log_actions.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_mifdef_wizard.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_on_device_setup_install_trk.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_pause_actions.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_properties_cpp_build.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_skip_actions.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_sound_actions.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/reference/images/wnd_stop_mode_overview.png has changed
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/app_trk_installation.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,71 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Installation Pane</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Installation Pane</h2>
-<p>The Debug or launch configuration windows <b>Installation</b> pane specifies the .sis file to install on the target device when using Application TRK. This is required when using the TRK debug agent with 9.x based SDK’s.</p>
-<p align="center"><img src="../images/panel_trk_installation.png" width="598" height="224" /></p>
-<p class="figure">Figure 1 - Debug windows Installation pane</p>
-<h5>Table 1. Installation pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><p><b>Installation file </b></p>
- <p> </p></td>
- <td><p>Enter the complete path to the .sis or .pkg file to install on the target device or click Browse to use the standard file selection dialog.</p>
- </td>
- </tr>
- <tr>
- <td><b>Download directory </b></td>
- <td>The directory on the target device to download the file into before installing it. The default directory value is <span class="code">C:\data\</span>. </td>
- </tr>
- <tr>
- <td><b>Install each launch even if installer file has not changed </b></td>
- <td>Enable this option to force an update of the installed file even if no changes have been detected. This ensures a clean program install for each debug session. </td>
- </tr>
- <tr>
- <td><b>Do not show installer UI on the phone </b></td>
- <td>Use this option to specify if the installer UI on the target device is shown when installing the file. Disabling this option may require interaction with the installer UI on the target device, slowing down the install process. The default setting is <span class="code">on</span>. </td>
- </tr>
- <tr>
- <td><b>Install to drive </b></td>
- <td>A list of common drives where files may be installed to. The default drive setting is <span class="code">C</span>. </td>
- </tr>
-</table>
-
-<div class="step">
- <h4>To access the Installation Pane</h4>
- <ol>
- <li>Select the Run > Debug... menu item</li>
- <p>The <b>Debug</b> window appears. </p>
- <li>Select a Symbian OS Application TRK configuration in the Configurations list</li>
- <li>Click Installer tab</li>
- <p>The Installation pane appears (Figure 1). </p>
- </ol>
-</div>
-<h5>Common concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- <li><a href="../../concepts/trk.htm">Target Resident Kernel (TRK)</a></li>
-</ul>
-<h5 align="left">Common references </h5>
-<ul>
- <li><a href="page_trk_main.htm">Main Pane</a></li>
- <li><a href="page_trk_debugger.htm">Debugger Pane</a></li>
- <li><a href="page_connection.htm">Connection Pane</a></li>
- <li><a href="page_file_transfer.htm">File Transfer Pane</a></li>
- <li><a href="page_executables.htm">Executables Pane</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/emulator_debugger.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,73 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debugger Pane</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debugger Pane</h2>
-<p>The <b>Debug/Run</b> windows <b>Debugger</b> pane provides control entry point breaks and which consoles are active to show logs. </p>
-<p align="center"><img src="../images/panel_debug_debugger.png" width="639" height="278" /></p>
-<p class="figure">Figure 1 - Debug windows Debugger tab</p>
-<h5>Table 1. Debugger pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Break at entry point </b></td>
- <td>Select to halt program execution at a specified
- function or address. Enter the desired function
- name or address in the corresponding field. If you
- enter an address, ensure that it is correct and within
- your program.</td>
- </tr>
- <tr>
- <td><b>View program output </b></td>
- <td><p>Enable to direct standard output messages to the Emulation Program Output Console in the <a href="../view_log.htm">Console</a> view. </p>
- <p class="note"><b>NOTE</b> In the <span class="code">epoc.ini</span> file the option <span class="code">LogToFile</span> must also be set to <span class="code">1</span>.</p></td>
- </tr>
- <tr>
- <td><b>View emulator output </b></td>
- <td><p>Enable to output emulator messages to the Emulator Output Console in the Console view. </p>
- <p class="note"><b>NOTE</b> In the <span class="code">epoc.ini</span> file the option <span class="code">LogToDebugger</span> must also be set to <span class="code">1</span>.</p></td>
- </tr>
- <tr>
- <td><b>View Windows system messages </b></td>
- <td>Enable to output Windows system messages to the Windows System Messages Console in the Console view. </td>
- </tr>
-</table>
-
-<div class="step">
- <h4>To access the Debug window </h4>
- <ol>
- <li>Select the Run > Debug... menu item</li>
- <p>The Debug window appears. </p>
- <li>Select a Configuration setting</li>
- <li>Click Debugger tab </li>
- <p>The Debugger pane appears (Figure 1). </p>
- </ol>
-</div>
-<h5>Common concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- </ul>
-<h5 align="left">Common tasks</h5>
-<ul>
- <li><a href="../../tasks/start/carbide_debugging.htm">Debugging a Program</a> (Example)</li>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
-</ul>
-<h5 align="left">Common references </h5>
-<ul>
- <li><a href="../perspective_debug.htm">Debug Perspective</a></li>
- <li><a href="../wnd_debug_configuration.htm">Debug Window </a> </li>
- <li><a href="../view_debug.htm">Debug View</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/emulator_exceptions.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,59 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>x86 Exceptions Pane</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>x86 Exceptions Pane </h2>
-<p> The <b>Debug/Run</b> windows <b>x86 Exceptions</b> pane lists all the exceptions that the debugger is able to catch. If you want the debugger to catch all the exceptions, enable all of the options in this view. However, if you prefer to handle only certain exceptions, enable only those options that reflect the exceptions you prefer to handle.</p>
-<p align="center"><img src="../images/panel_debug_x86_exceptions.png" width="627" height="270" /></p>
-<p align="center" class="figure">Figure 1 - x86 Exceptions pane</p>
-<h5>Table 1. x86 Exceptions pane —items </h5>
-<table width="88%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Check All </b></td>
- <td>Enables catching all exceptions.</td>
- </tr>
- <tr>
- <td><b>Clear All </b></td>
- <td>Disables catching all exceptions.</td>
- </tr>
-</table>
-<div class="step">
- <h4>To access the x86 Exceptions pane</h4>
- <ol>
- <li>Select the Run > Run... or Run > Debug... menu item</li>
- <p>The Debug window (Figure 1) appears. </p>
- <li>Select a Configuration setting</li>
- <li>Click x86 Exceptions tab </li>
- <p>The x86 Exceptions pane appears. </p>
- </ol>
-</div>
-<h5>Common concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- </ul>
- <h5 align="left">Common tasks</h5>
- <ul>
- <li><a href="../../tasks/start/carbide_debugging.htm">Debugging a Program</a> (Example)</li>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- </ul>
- <h5 align="left">Common references </h5>
- <ul>
- <li><a href="../perspective_debug.htm">Debug Perspective</a></li>
- <li><a href="../wnd_debug_configuration.htm">Debug Window </a> </li>
- <li><a href="../view_debug.htm">Debug View</a></li>
- </ul>
-
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/emulator_main.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,52 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Main Pane (Emulator)</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Main Pane (Emulator) </h2>
-<p>The emulator <b>Main</b> pane defines the process to be launched by the emulator. </p>
-<p>The behavior that occurs when launching a debug session varies based upon the <a href="../SDKPreferences.html">SDK</a>. Normally, <a href="../../tasks/debugger/work_debug_act_start.htm">starting</a> a debug session launches the emulator (<span class="code">epoc.exe</span>) and you must then navigate to your application and open it. However, starting a debug session for an .exe file will, in most cases, launch the .exe directly. This starts the emulator and then opens your application automatically. Note that some SDKs do not support this behavior. In those cases you must still open your application in the emulator manually.</p>
-<p align="center"><img src="../images/panel_debug_main.png" width="639" height="278" /></p>
-<p class="figure">Figure 1 - Debug windows emulator's Main tab </p>
-<h5>Table 1. Emulator Main pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Project</b></td>
- <td><p>The project to associate with this debug launch configuration. Click <b>Browse</b> to select a different project. </p> </td>
- </tr>
- <tr>
- <td><b>Process to launch </b></td>
- <td>The path to the emulator or executable to launch. For Symbian OS 9.1 the emulator path is required. For Symbian OS 9.2 and later the path to the executable should be used. Click <b>Browse</b> to select a different emulator. </td>
- </tr>
-</table>
-
-<div class="step">
- <h4>To access the Main Pane</h4>
- <ol>
- <li>Select the Run > Debug... menu item</li>
- <p>The Debug window appears. </p>
- <li>Select a Symbian OS System emulator configuration in the Configurations list </li>
- <li>Click Main tab </li>
- <p>The Main pane appears (Figure 1). </p>
- </ol>
-</div>
-<h5>Other references</h5>
- <ul>
- <li><a href="../wnd_debug_configuration.htm">Debug window</a></li>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- <li><a href="run_mode_overview.htm">Run-mode overview</a></li>
- <li><a href="stop_mode_overview.htm">Stop-mode overview</a> </li>
- </ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/emulator_overview.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,35 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Emulator Overview</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Emulator Overview</h2>
-<p>The Debug or launch configuration window provides C/C++ emulator debug options when a Symbian OS Emulation launch configuration is created. The settings included in the Symbian OS Emulation launch configuration are a combination of Carbide, CDT, and Eclipse options. The tabs in the window include: </p>
-<ul>
- <li>The <a href="emulator_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project containing the class to launch in the project field, and the executable name in the the Executable field and the emulator or host application in the Emulator or host application field. </li>
- <li>The <a href="stop_mode_overview.htm">Arguments</a> tab (<i>standard CDT page</i>) defines the arguments to be passed to the application and to the virtual machine (if any). You can also specify the working directory to be used by the launched application. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_env.htm">Environment</a> tab (<i>standard CDT page</i>) defines the environment variable values to use when running or debugging a program. By default, the environment is inherited from the Eclipse runtime. You may override or append to the inherited environment. </li>
- <li>The <a href="emulator_debugger.htm">Debugger</a> tab provides common debugger options for the project.</li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables are debugged by your project.</li>
- <li>The <a href="emulator_exceptions.htm">x86 Exceptions</a> tab lists all the x86 exceptions that the debugger can catch.</li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file and specify which perspectives become active when the launch configuration is launched. </li>
-</ul>
-<p align="center"><img src="../images/wnd_debug_overview.png" width="864" height="471"></p>
-<p class="figure">Figure 1 - Debug or launch configuration window</p>
-<h5>Other references</h5>
-<ul>
- <li><a href="../wnd_debug_configuration.htm">Debug Window </a></li>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- <li><a href="run_mode_overview.htm">Run-mode overview</a></li>
- <li><a href="stop_mode_overview.htm">Stop-mode overview</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/page_connection.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,81 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Connection Pane</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Connection Pane</h2>
-<p>The <b>Connection</b> pane specifies the method used to transfer files to the target device. Once a Serial Port type is chosen, the remaining options contain default values for the specific connection type. Users can change these remaining options to match the target device's communication specifications. </p>
-<p align="center"><img src="../images/panel_trk_connection.png" width="598" height="224" /></p>
-<p class="figure">Figure 1 - Debug windows Connection pane</p>
-<h5>Table 1. <span class="figure">Connection</span> pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Serial Port </b></td>
- <td><p>Select the serial port option to use for this launch or launch configuration. Once set, this port will be used for all subsequent launch configurations until it is set again. Note that for USB and BT can be dynamically assigned, so its critical that the port ID assigned here matches the one the system is using to communicate with the target device. </p>
- <p>If you are using a USB connection, the connected phone's name should appear in the menu to help identify which port is being used. </p></td>
- </tr>
- <tr>
- <td><b>Baud Rate </b></td>
- <td>Use the Baud Rate option to select the baud rate for communication. The default baud rate value is 115200 bits per second (bps). </td>
- </tr>
- <tr>
- <td><b>Data Bits </b></td>
- <td>Use the Data Bits option to select a common data bits size (4, 5, 6, 7, and 8). The default data bits value is 8. </td>
- </tr>
- <tr>
- <td><b>Parity</b></td>
- <td>Use the Parity option to select the parity setting (None, Odd, or Even). The default parity value is None. </td>
- </tr>
- <tr>
- <td><b>Stop Bits </b></td>
- <td>Use the Stop Bits option to select the stop bits setting (1, 1.5, 2). The default stop bits value is 1.</td>
- </tr>
- <tr>
- <td><b>Flow Control </b></td>
- <td>Use the Flow Control option to select the flow control setting (None, Hardware (RTS/CTS), and Software (XON/XOFF)). The default flow control value is None. </td>
- </tr>
-</table>
-
-<div class="step">
- <h4>To access the Connection Pane</h4>
- <ol>
- <li>Select the Run > Debug... menu item</li>
- <p>The <b>Debug</b> window appears. </p>
- <li>Select a Symbian OS Application TRK configuration in the Configurations list </li>
- <li>Click Connection tab </li>
- <p>The <b>Connection</b> pane appears (Figure 1). </p>
- </ol>
-</div>
-<h5>Common concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- <li><a href="../../concepts/trk.htm">Target Resident Kernel (TRK) </a></li>
- </ul>
-<h5 align="left">Common tasks</h5>
-<ul>
- <li><a href="../../tasks/trk/trk_connection_bluetooth.htm">Bluetooth Connection Setup</a></li>
- <li><a href="../../tasks/trk/trk_install_usb.htm">Installing On-device Debug Agents using USB</a></li>
- <li><a href="../../tasks/trk/trk_install_bluetooth.htm">Installing On-device Debug Agents using BlueTooth</a> </li>
- <li><a href="../../tasks/trk/trk_connection_usb.htm">USB Connection Setup</a></li>
-</ul>
-<h5 align="left">Common references</h5>
-<ul>
- <li><a href="page_trk_main.htm">Main Pane</a></li>
- <li><a href="page_trk_debugger.htm">Debugger Pane</a></li>
- <li><a href="page_file_transfer.htm">File Transfer Pane </a></li>
- <li><a href="app_trk_installation.htm">Installation Pane</a></li>
- <li><a href="page_executables.htm">Executables Pane</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/page_executables.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,73 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Executables Pane</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Executables Pane</h2>
-<p>The <b>Executables</b> pane specifies which executables to debug with your project based on the chosen rule. The Executables pane gives you project level control over the executables associated with it. The pane shows all the executables in the workspace or those imported into the Executables view from outside the workspace that can be debugged by this project. See the <a href="../view_executables.htm">Executables</a> view for information on controlling executables from the workspace. </p>
-<p align="center"><img src="../images/panel_trk_exes.png" width="598" height="224" /></p>
-<p class="figure">Figure 1 - Debug windows Executables pane</p>
-<h5>Table 1. Executable pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Load symbols for these executables and target them for debugging </b></td>
- <td><p>Select the rule which govern the executable support used by this project for debugging purposes. The options include: </p>
- <ul>
- <li><b>Executables in the workspace from this SDK</b> — shows all executables in the workspace built using the specified SDK. This is the default setting. </li>
- <li><b>Executables built by this project</b> — shows only the executables built by this project using the specified SDK</li>
- <li><b>Executables selected below</b> — shows only the executables chosen by the user. Initial list display uses the All Executables listing. </li>
- <li><b>All executables (slows launch)</b> — shows all the executables in the workspace regardless of which SDK created them. Selecting this option will slow down Carbide launches as the list is populated. </li>
- </ul>
- </td>
- </tr>
- <tr>
- <td><b>Executables list </b></td>
- <td>Shows all the executables associated with this project. </td>
- </tr>
- <tr>
- <td><b>Add...</b></td>
- <td>Opens the <b>Select an executable file</b> dialog which can locate and select executable files and add them to the project's executables list. </td>
- </tr>
- <tr>
- <td><b>Select All </b></td>
- <td>Enables all the executables in the list for debugging. </td>
- </tr>
- <tr>
- <td><b>Unselect All </b></td>
- <td>Disables all the executables in the list from debugging. </td>
- </tr>
-</table>
-<div class="step">
- <h4>To access the Executables Pane</h4>
- <ol>
- <li>Select the Run > Open Debug Dialog... menu item</li>
- <p>The <b>Debug</b> window appears. </p>
- <li>Select a Symbian OS Application TRK configuration in the Configurations list</li>
- <li>Click Executables tab </li>
- <p>The Executables pane appears (Figure 1).</p>
- </ol>
-</div>
-<h5>Common concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- <li><a href="../../concepts/trk.htm">Target Resident Kernel (TRK) </a></li>
-</ul>
-<h5 align="left">Common references</h5>
-<ul><li><a href="page_trk_debugger.htm">Debugger Pane</a></li>
- <li><a href="page_connection.htm">Connection Pane</a></li>
- <li><a href="page_file_transfer.htm">File Transfer Pane </a></li>
- <li><a href="app_trk_installation.htm">Installation Pane</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/page_file_transfer.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,85 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>TRK File Transfer Pane</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>File Transfer Pane</h2>
-<p>The <b>File Transfer</b> pane displays an auto-populated list of files for System TRK that the IDE transfers to the target device at the start of each launch. Users can add, edit, or delete files in the list. By default, any file added is automatically checked for downloading to the device. Users can uncheck a file to remove it from the download list without removing the file itself. Any missing files are marked with a warning icon and a message appears describing the issue making it easy to see potential file problems prior to attempting a download.</p>
-<p>System TRK users can use this panel to download any type of file, like bitmaps, HTML, sounds, and more, to the phone and applicable to Application TRK for transfering any files outside of the installation file.</p>
-<p align="center"><img src="../images/panel_trk_file_transfer.png" width="598" height="224" /></p>
-<p class="figure">Figure 1 - Debug windows File Transfer pane</p>
-<h5>Table 1. <span class="figure">File Transfer</span> pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>File transfer list </b></td>
- <td><p>The File transfer list displays the project files that are moved to the target device for launch and debugging purposes. It contains these columns:</p>
- <ul>
- <li><b>Enabled</b>—a checkmark indicates that the IDE should transfer the specified file to the target directory. If unchecked, do not transfer the file. </li>
- <li><b>File to transfer</b>—the path and filename to a file on the host machine to be transfered </li>
- <li><b>Target path</b>—the path to the target directory where transfered files are placed on the device </li>
- </ul></td>
- </tr>
- <tr>
- <td><b>Add</b></td>
- <td>Click to add a file to the file transfer list.</td>
- </tr>
- <tr>
- <td><b>Edit...</b></td>
- <td>Click to edit the selected file in the file transfer list. </td>
- </tr>
- <tr>
- <td><b>Remove</b></td>
- <td>Click to remove the selected file from the file transfer list. </td>
- </tr>
- <tr>
- <td><b>Select All</b></td>
- <td>Click to select all the files in the file transfer list.</td>
- </tr>
- <tr>
- <td><b>Deselect All</b></td>
- <td>Click to unselect all the files in the file transfer list.</td>
- </tr>
-</table>
-
-<div class="step">
- <h4>To access the File Tansfer Pane</h4>
- <ol>
- <li>Select the Run > Debug... menu item</li>
- <p>The <b>Debug</b> window appears. </p>
- <li>Select a Symbian OS Application TRK configuration in the Configurations list </li>
- <li>Click File Transfer tab </li>
- <p>The <b>File Transfer</b> pane appears (Figure 1). </p>
- </ol>
-</div>
-<h5>Common concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- <li><a href="../../concepts/trk.htm">Target Resident Kernel (TRK) </a></li>
- </ul>
-<h5 align="left">Common tasks</h5>
-<ul>
- <li><a href="../../tasks/trk/trk_connection_bluetooth.htm">Bluetooth Connection Setup</a></li>
- <li><a href="../../tasks/trk/trk_install_usb.htm">Installing On-device Debug Agents using USB</a></li>
- <li><a href="../../tasks/trk/trk_install_bluetooth.htm">Installing On-device Debug Agents using BlueTooth</a> </li>
- <li><a href="../../tasks/trk/trk_connection_usb.htm">USB Connection Setup</a></li>
-</ul>
-<h5 align="left">Common references </h5>
-<ul>
- <li><a href="page_trk_main.htm">Main Pane</a></li>
- <li><a href="page_trk_debugger.htm">Debugger Pane</a></li>
- <li><a href="page_connection.htm">Connection Pane</a></li>
- <li><a href="app_trk_installation.htm">Installation Pane</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/page_trk_debugger.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,133 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debugger panes for TRK </title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debugger panes for TRK </h2>
-<p>The <b>Debug/Run</b> windows <b>Debugger</b> panes for TRK provides control over entry points, message handling, and instruction set default settings.</p>
-<p>Different options are available in the Debugger pane based on the type of TRK launch configuration, including:</p>
-<ul><li><a href="#trk_runmode">Run mode debugging</a></li>
- <li><a href="#trk_stopmode">Stop mode debugging</a> </li>
-</ul>
-<h3><a name="trk_runmode" id="trk_runmode"></a>Run-mode Debugger pane </h3>
-<p>In run-mode you can control message handling and instruction sets. </p>
-<p align="center"><img src="../images/page_run_mode_debugger.png" width="596" height="244"></p>
-<p class="figure">Figure 1 - Debug windows Debugger pane for run mode debugging </p>
-<h5>Table 1. Debugger pane — run-mode options </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><p><b>Break at entry point</b></p>
- </td>
- <td><p>When checked, break at the specified entry point entered into the text field. For .EXE targets, the default entry point is set to <span class="code">E32Main</span>. By default, the <b>Break at entry point</b> option is unchecked for all other target types.</p></td>
- </tr>
- <tr>
- <td><b>View program output </b></td>
- <td>When checked, show the contents of any program output in the <b> TRK Progam Output Console</b> in a <a href="../view_log.htm">Console</a> view. </td>
- </tr>
- <tr>
- <td><b>View messages between Carbide and debug agent </b></td>
- <td><p>When checked, show the communications between Carbide and the target device in the <b> TRK Communication Log Console</b> of the Console view. </p>
- <p class="note"><b>NOTE</b> You can pin the TRK Communication Log view so that it does not lose focus. </p></td>
- </tr>
- <tr>
- <td><b>Message retry delay (ms) </b></td>
- <td>Enter the delay time in milliseconds (ms) between 100 and 10000 the debugger should wait for a response. The default Message Retry Delay value is 2000. </td>
- </tr>
- <tr>
- <td><p><b>Default Instructon Set </b></p>
- <p> </p></td>
- <td><p>Specifies the default instruction set to use if the debugger cannot determine the processor mode in order to set breakpoints and to disassemble code. The options are: </p>
- <ul>
- <li>Auto (examine code at current PC location) </li>
- <li>ARM (32-bit) </li>
- <li>THUMB (16-bit) </li>
- </ul>
- <p>By default the Instruction Set option uses ARM 32-bit.</p></td>
- </tr>
-</table>
-<p> </p>
-<h3><a name="trk_stopmode" id="trk_stopmode"></a>Stop-mode Debugger pane</h3>
-<p>In stop-mode use the <b>Startup Options</b> to attach to a target and debug or run from the specified start address. Then use <b>Target Options</b> to specify the target's processor type, and set which initialization and memory configuration files to use in the debug session. </p>
-<p align="center"><img src="../images/panel_trk_debugger.png" width="611" height="389" /></p>
-<p class="figure">Figure 2 - Debug windows Debugger pane for stop mode debugging </p>
-<h5>Table 2. Debugger pane — stop-mode options </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><p><b>Break at entry point</b></p></td>
- <td><p>When checked, break at the specified entry point entered into the text field. For .EXE targets, the default entry point is set to <span class="code">E32Main</span>. By default, the <b>Break at entry point</b> option is unchecked for all other target types.</p></td>
- </tr>
- <tr>
- <td><b>Soft attach </b></td>
- <td>Enable the <b>Soft attach</b> option to attach a debug session to a target and debug from the specified start address instead of the target's default start address. When enabled the downloaded image option is ignored. </td>
- </tr>
- <tr>
- <td><b>Debug from start address </b></td>
- <td>Enable the <b>Debug from start addres</b>s option to debug from the target's default start address. </td>
- </tr>
- <tr>
- <td><b>Run from start address </b></td>
- <td>Enable the <b>Run from start addres</b>s option to run from the target's default start address. </td>
- </tr>
- <tr>
- <td><b>Start address (hex) </b></td>
- <td>Enter in hexidecimal format (<span class="code">0x0</span>) the starting address to use during the debug session. </td>
- </tr>
- <tr>
- <td><b>Reset target at the start of each debug session </b></td>
- <td>Forces the Carbide IDE to reset the target at the start of each debug session. This ensures that the debugging session uses the most up-to-date program code.</td>
- </tr>
- <tr>
- <td><b>Target Processor </b></td>
- <td>A drop down with a list of all supported processors. The process selection should help in determining the memory model. This will in turn help determine the base address and the offsets for the Symbian OS kernel aware information.</td>
- </tr>
- <tr>
- <td><b>Target initialization file </b></td>
- <td><p>Check this box to have the debugger run an initialization script when the debug session starts. For example, if a target device requires initialization for the debugger to be able to read and write memory or registers, you can specify an initialization script here.</p>
- <p> Click Browse to select a script file using a standard file selection dialog box. When using T32, most of the initialization is done in the CMM script file. With other debug protocols like Sophia, you can specify the initialization file, which can be run after connecting to the target. </p></td>
- </tr>
- <tr>
- <td><b>Memory configuration file </b></td>
- <td>Controls whether the debugger uses a memory configuration file when a debug session starts. The Carbide debugger uses this configuration file to know which memory is accessible, readable, and writable on the target.</td>
- </tr>
-</table>
-
-<div class="step">
- <h4>To access the Debugger Pane</h4>
- <ol>
- <li>Select the Run > Debug... menu item</li>
- <p>The <b>Debug</b> window appears. </p>
- <li>Select a Symbian OS Application TRK configuration in the Configurations list</li>
- <li>Click Debugger tab </li>
- <p>The <b>Debugger</b> pane appears (Figure 1). </p>
- </ol>
-</div>
-<h5>Common concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- <li><a href="../../concepts/trk.htm">Target Resident Kernel (TRK) </a></li>
-</ul>
-<h5 align="left">Common references </h5>
-<ul>
- <li><a href="page_trk_main.htm">Main Pane</a></li>
- <li><a href="page_connection.htm">Connection Pane</a></li>
- <li><a href="page_file_transfer.htm">File Transfer Pane </a></li>
- <li><a href="app_trk_installation.htm">Installation Pane</a></li>
- <li><a href="page_executables.htm">Executables Pane</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/page_trk_main.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,62 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Main Pane</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/></head>
-<body bgcolor="#FFFFFF">
-<h2>Main Pane</h2>
-<p>The <b>Main</b> pane defines the project and the process to launch on the target device. </p>
-<p align="center"><img src="../images/panel_trk_main.png" width="593" height="251" /></p>
-<p class="figure">Figure 1 - Debug windows Main pane</p>
-<h5>Table 1. Main pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="38%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Project</b></td>
- <td><p>The project to associate with this launch configuration. Click Browse to select a different project. </p> </td>
- </tr>
- <tr>
- <td><b>Remote process to launch </b></td>
- <td><p>The absolute path of the remote executable to launch on the target device. The binary to debug may be stored on one of several memory locations, the most common are:</p>
- <ul>
- <li><b>RAM</b> (default) — programs running in RAM are launched from <span class="code">c:\sys\bin\</span> </li>
- <li><b>ROM</b> — programs running in ROM are launched from <span class="code">z:\sys\bin\</span></li>
- <li><b>Memory cards</b> — programs running on a memory card are launched from <span class="code">e:\sys\bin\</span> </li>
- </ul>
- <p>In the event a program is not launching, verify that the<b> </b>path is correct for the memory location where the binary resides.</p>
- </td>
- </tr>
-</table>
-
-<div class="step">
- <h4>To access the Main Pane</h4>
- <ol>
- <li>Select the Run > Debug... menu item</li>
- <p>The <b>Debug</b> window appears. </p>
- <li>Select a Symbian OS Application TRK configuration in the Configurations list</li>
- <li>Click Main tab </li>
- <p>The Main pane appears (Figure 1). </p>
- </ol>
-</div>
-<h5>Common concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- <li><a href="../../concepts/trk.htm">Target Resident Kernel (TRK) </a></li>
-</ul>
-<h5 align="left">Common references</h5>
-<ul><li><a href="page_trk_debugger.htm">Debugger Pane</a></li>
- <li><a href="page_connection.htm">Connection Pane</a></li>
- <li><a href="page_file_transfer.htm">File Transfer Pane </a></li>
- <li><a href="app_trk_installation.htm">Installation Pane</a></li>
- <li><a href="page_executables.htm">Executables Pane</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/run_mode_overview.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,42 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Run-mode Overview</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Run-mode Overview</h2>
-<p>The <a href="../wnd_debug_configuration.htm">Debug</a> or launch configuration window provides C/C++ debugger options for on-device debugging. On-device debugging uses a program called Terminal Resident Kernel (TRK) to communicate between Carbide and the device. On-device debugging is supported by creating one of the following debug launch configurations:</p>
-<ul>
- <li><b>Symbian OS Application TRK</b>—supports application debugging only </li>
- <li><b>Symbian OS System TRK</b>—supports both application and limited ROM debugging (<i>not available in the Developer Edition</i>) </li>
-</ul>
-<p>The settings included in the TRK launch configurations are a combination of Carbide, CDT, and Eclipse options. Once a suitable Symbian OS debug launch configuration is defined the tabs in the window include:</p>
-<ul>
- <li>The <a href="page_trk_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project containing the class to launch in the project field, and the executable name in the Executable field and the remote process to launch on the device. </li>
- <li>The <b>Arguments</b> tab (<i>standard Eclipse page</i>) defines any arguments to be passed to the process to launch.</li>
- <li>The <a href="page_trk_debugger.htm">Debugger</a> tab provides common debugger options for the project.</li>
- <li>The <a href="page_connection.htm">Connection</a> tab specifies the method used to transfer files to the target device. This is where you specify the COM port if the connection is via Bluetooth or USB.</li>
- <li>The <a href="page_file_transfer.htm">File Transfer</a> tab displays a list of files to transfer to the target device at the start of each launch. This is used primarily by System TRK to transfer files to a phone for debugging.</li>
- <li>The <a href="app_trk_installation.htm"> Installation </a> tab <i>(shown in Application TRK only</i>) defines where programs are installed on the target device. This is where you specify the SIS file to be uploaded for Application TRK. </li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables within your project to debug.</li>
- <li>The <a href="sys_trk_rom_log.htm"> ROM Log </a> tab <i>(shown in System TRK only</i>) specifies where the ROM log file is stored and the Epoc32 directory.</li>
- <li>The <b>Source</b> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file and specify which perspectives become active when the launch configuration is launched. </li>
-</ul>
-<p align="center"><img src="../images/wnd_trk_debug_config.png" width="859" height="629" /></p>
-<p class="figure">Figure 1 - Debug/Run window for on-device debugging (Application TRK version) </p>
-<h5>Other references</h5>
-<ul>
- <li><a href="../wnd_debug_configuration.htm">Debug Window </a></li>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- <li><a href="emulator_overview.htm">Emulator overview</a></li>
- <li><a href="stop_mode_overview.htm">Stop-mode overview</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/stop_mode_overview.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,33 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Stop-mode Overview</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Stop-mode Overview</h2>
-<p>The <a href="../wnd_debug_configuration.htm">Debug</a> or launch configuration window provides C/C++ stop-mode debug options that use a JTAG interface when a Symbian OS Sophia or Trace32 launch configuration is created. The settings included in these launch configuration are a combination of Carbide, CDT, and Eclipse options. The tabs in the window include: </p>
-<ul>
- <li>The <a href="page_trk_main.htm">Main</a> tab defines the project to be launched. Enter the name of the project containing the class to launch in the project field, and the executable name in the Executable field to launch on the device. </li>
- <li>The <a href="page_connection.htm">Connection</a> tab specifies the method used to transfer files to the target device.</li>
- <li>The <a href="page_trk_debugger.htm">Debugger</a> tab provides control over common Carbide.c++ debugger capabilities.</li>
- <li>The <a href="stop_mode_rom_image.htm">ROM Image</a> tab allows you to define startup options and ROM image download information.</li>
- <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables within your project to debug.</li>
- <li>The <b>Source</b> tab (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file and specify which perspectives become active when the launch configuration is launched. </li>
-</ul>
-<p align="center"><img src="../images/wnd_debug_stop_mode_overview.png" width="775" height="484"></p>
-<p class="figure">Figure 1 - Debug or launch configuration window for stop mode debugging </p>
-<h5>Other references</h5>
-<ul>
- <li><a href="../wnd_debug_configuration.htm">Debug Window </a></li>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- <li><a href="emulator_overview.htm">Emulator overview</a></li>
- <li><a href="run_mode_overview.htm">Run-mode overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/stop_mode_rom_image.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,73 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>ROM Image pane </title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>ROM Image pane </h2>
-<p>Use the <b>ROM Image</b> tab to define startup options and ROM image download information.</p>
-<p align="center"><img src="../images/page_stop_mode_rom_image.png" width="583" height="327"></p>
-<p class="figure">Figure 1 - ROM Image pane in launch configuration </p>
- <h5>Table 4. Launch configuration window—ROM Image tab items</h5>
- <table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
-
- <tr>
- <td><b>Parse Rom Log File</b></td>
- <td>Check this option to parse the ROM log file. </td>
- </tr>
- <tr>
- <td><b>Symbian Rom Log File</b></td>
- <td>Enter or browse to the Rom log file that is generated when the Symbian OS image is built. This is necessary for debugging any Symbian OS module.</td>
- </tr>
- <tr>
- <td><b>Symbian Epoc32 Directory </b></td>
- <td><p>Enter or browse to the epoc32 directory for the Symbian OS kit that is being targeted for debugging. This is necessary for the debugger to resolve the full paths for each module in the log file since the log file does not contain the full paths.</p></td>
- </tr>
- <tr>
- <td><b>Log unresolved modules</b></td>
- <td>Check this option to log unresolved modules. If the actual binary in the log file doesn’t exist on the PC, then a warning message will be logged in a Rom Log console window.</td>
- </tr>
- <tr>
- <td><b>Debug non-XIP executables</b></td>
- <td>Check this option to target non-XIP executables. This allows the debugger to target a non-XIP module whenever it’s loaded.</td>
- </tr>
- <tr>
- <td><b>Download Rom Image </b></td>
- <td>Check this box to enable downloading. </td>
- </tr>
- <tr>
- <td><b>Symbian Rom Image</b></td>
- <td>Enter or browse to the Symbian OS image (.img file) that will be downloaded onto the target at the specified download address.</td>
- </tr>
- <tr>
- <td><b>Download Address (hex) </b></td>
- <td><p>Specify the address where the image is to be downloaded. This address is target-specific. The address should be in hexadecimal format with the 0x prefix.</p></td>
- </tr>
- <tr>
- <td><b>Same as start address</b></td>
- <td>Check this option to make the download address the same as the start address.</td>
- </tr>
- <tr>
- <td><b>Ask for download at the start of each debug session</b></td>
- <td>Select this option to prompt you to download the image at the start of the debug session.</td>
- </tr>
- </table>
- <h5>Other references</h5>
-<ul>
- <li><a href="../wnd_debug_configuration.htm">Debug Window </a></li>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- <li><a href="emulator_overview.htm">Emulator overview</a></li>
- <li><a href="run_mode_overview.htm">Run-mode overview</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/launch_configs/sys_trk_rom_log.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,47 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<title>ROM Log page</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF" dir="ltr">
-<h2> ROM Log page</h2>
-<p>Use the <b>ROM Log</b> page to specify where the ROM log file is stored and the Epoc32 directory. </p>
-<p align="center"><img src="../images/page_ROM_log.png" width="590" height="213" /></p>
-<p class="figure">Figure 1. ROM Log page </p>
-<h5>Table 1. ROM Log page—items </h5>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="27%" scope="col">Item</th>
- <th width="62%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Parse Rom Log File </b></td>
- <td>Activate the <b>Parse ROM Log File</b> option and specify the information that the debugger needs in order to show detailed stack information, set breakpoints, and show source level debugging information for ROM images.</td>
- </tr>
- <tr>
- <td><b>Symbian Rom Log File </b></td>
- <td> In the <b>Symbian Rom Log File</b> text field, browse to or enter the full path and name of the log file that corresponds to the ROM image on the target device. This log file is generated by default when the ROM image is built.</td>
- </tr>
- <tr>
- <td><b>Symbian Epoc32 Directory </b></td>
- <td><p>Specifies the epoc32 directory in which the ROM image and log files are stored. Since the log file may not contain full paths to the ROM components on the host PC, you need to enter this epoc32 directory.</p>
- <p class="note"><b>NOTE</b> Always include the epoc32 folder in this path.</p></td>
- </tr>
- <tr>
- <td><b>Log unresolved modules </b></td>
- <td><p>Activate the <b>Log unresolved modules </b> option to have the debugger output a list of components from the specified ROMBUILD log file that do not have debugger symbolic information. The list is displayed in the debugger console window at the beginning of the debug session.</p>
- <p class="note"><b>NOTE</b> You cannot perform source-level debugging on components that do not include symbolic information.</p></td>
- </tr>
-</table>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="../../tasks/debugger/stop_mode_debug_precond.htm">Stop Mode On-Device Debugging Preconditions</a></li>
-</ul>
-
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/panel_debug_exceptions.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/panel_debug_exceptions.htm Mon Aug 10 15:50:55 2009 -0500
@@ -50,7 +50,7 @@
<ul>
<li><a href="perspective_debug.htm">Debug Perspective</a></li>
<li><a href="wnd_debug_configuration.htm">Debug Window </a> </li>
- <li><a href="view_debug.htm">Debug View</a></li>
+ <li><a href="../debugger/debug/viewing_debug.htm">Debug View</a></li>
</ul>
<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/perspective_debug.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/perspective_debug.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,52 +1,52 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debug perspective</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debug perspective</h2>
-<p>The Carbide.c++ <img src="../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.debug.ui.DebugPerspective)")'>
-Debug</a> perspective is where you debug programs running on an emulator or a target device. The default views include:</p>
-<ul>
- <li><a href="view_debug.htm">Debug view</a> - displays information about a suspended process during a debug session</li>
- <li><a href="view_variables.htm">Variables view</a> - allows manipulation of variables used in source code</li>
- <li><a href="view_breakpoints.htm">Breakpoints view</a> - allows manipulation of breakpoints and watchpoints</li>
- <li><a href="view_symbian_kernel.htm">Symbian OS Data view</a> - shows kernel data in the Symbian OS running on the device being debugged</li>
- <li><a href="view_executables.htm">Executables</a> view - provides a dynamic list of executables and their related source files</li>
- <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_editor_view.htm">Editor</a> view - one or more source code editor windows </li>
- <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_outline_view.htm">Outline</a> view - displays an outline of a structured C/C++ file that is currently open in the
- editor view </li>
- <li><a href="view_log.htm">Console</a> view - display<span><span>s the output of a process</span></span>, like the execution of your program, or other outputs </li>
- <li><a href="PLUGINS_ROOT/org.eclipse.platform.doc.user/reference/ref-31.htm">Tasks</a> view - <span>displays </span>tasks that you manually add</li>
-</ul>
-<p>And can include:</p>
-<ul>
- <li><a href="view_memory_wnd.htm">Memory</a> view - allows you to monitor and modify process memory</li>
- <li><a href="view_disassembly.htm">Disassembly</a> view - displays the assembly code of the source code currently being debugged </li>
- <li><a href="view_expressions.htm">Expressions</a> view - used to monitor and manipulate global and local variables, structure members, and array elements</li>
- <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_modules_view.htm">Modules</a> view - uses the <a href="launch_configs/emulator_debugger.htm">Symbolics Loading</a> option to show modules loaded during a debug session </li>
- <li><a href="view_registers.htm">Registers</a> view - shows general, FPU, or host-specific registers of the host computer or target device</li>
-</ul>
-<p align="center"><img src="../images/views/perspective_debug.png" width="830" height="704" alt="" /></p>
-<p class="figure">Figure 1. Debug perspective used by Carbide.c++</p>
-<p class="note"><b>NOTE</b> Click the <img src="../images/icons/double_arrow_icon.png" width="12" height="9" valign="absmiddle" alt="" /> icon to show additional options that may not be visible in the perspective view.</p>
-<p>For more information on perspectives see <b>Workbench User Guide > Concepts > <a href="PLUGINS_ROOT/org.eclipse.platform.doc.user/concepts/concepts-4.htm">Perspectives</a></b>, and for views see <b>C/C++ Development User Guide > Reference
-> <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_o_views.htm">C/C++ Views and Editors</a></b>.</p>
-<h5>Related references</h5>
-<ul>
- <li> <a href="../concepts/CarbidePerspective.html">Carbide C/C++ Perspective</a></li>
- <li><a href="view_debug.htm">Debug view</a></li>
- <li><a href="view_variables.htm">Variables view</a></li>
- <li><a href="view_breakpoints.htm">Breakpoints view</a></li>
- <li><a href="view_memory_wnd.htm">Memory view</a></li>
- <li><a href="view_symbian_kernel.htm">Symbian OS Data view</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Debug perspective</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debug perspective</h2>
+<p>The Carbide.c++ <img src="../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.debug.ui.DebugPerspective)")'>
+Debug</a> perspective is where you debug programs running on an emulator or a target device. The default views include:</p>
+<ul>
+ <li><a href="../debugger/debug/viewing_debug.htm">Debug view</a> - displays information about a suspended process during a debug session</li>
+ <li><a href="view_variables.htm">Variables view</a> - allows manipulation of variables used in source code</li>
+ <li><a href="view_breakpoints.htm">Breakpoints view</a> - allows manipulation of breakpoints and watchpoints</li>
+ <li><a href="view_symbian_kernel.htm">Symbian OS Data view</a> - shows kernel data in the Symbian OS running on the device being debugged</li>
+ <li><a href="view_executables.htm">Executables</a> view - provides a dynamic list of executables and their related source files</li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_editor_view.htm">Editor</a> view - one or more source code editor windows </li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_outline_view.htm">Outline</a> view - displays an outline of a structured C/C++ file that is currently open in the
+ editor view </li>
+ <li><a href="view_log.htm">Console</a> view - display<span><span>s the output of a process</span></span>, like the execution of your program, or other outputs </li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.platform.doc.user/reference/ref-31.htm">Tasks</a> view - <span>displays </span>tasks that you manually add</li>
+</ul>
+<p>And can include:</p>
+<ul>
+ <li><a href="view_memory_wnd.htm">Memory</a> view - allows you to monitor and modify process memory</li>
+ <li><a href="view_disassembly.htm">Disassembly</a> view - displays the assembly code of the source code currently being debugged </li>
+ <li><a href="view_expressions.htm">Expressions</a> view - used to monitor and manipulate global and local variables, structure members, and array elements</li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_modules_view.htm">Modules</a> view - uses the <a href="../projects/launch/wiz_new_launch_config.htm">Symbolics Loading</a> option to show modules loaded during a debug session </li>
+ <li><a href="view_registers.htm">Registers</a> view - shows general, FPU, or host-specific registers of the host computer or target device</li>
+</ul>
+<p align="center"><img src="../images/views/perspective_debug.png" width="830" height="704" alt="" /></p>
+<p class="figure">Figure 1. Debug perspective used by Carbide.c++</p>
+<p class="note"><b>NOTE</b> Click the <img src="../images/icons/double_arrow_icon.png" width="12" height="9" valign="absmiddle" alt="" /> icon to show additional options that may not be visible in the perspective view.</p>
+<p>For more information on perspectives see <b>Workbench User Guide > Concepts > <a href="PLUGINS_ROOT/org.eclipse.platform.doc.user/concepts/concepts-4.htm">Perspectives</a></b>, and for views see <b>C/C++ Development User Guide > Reference
+> <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_o_views.htm">C/C++ Views and Editors</a></b>.</p>
+<h5>Related references</h5>
+<ul>
+ <li> <a href="../concepts/CarbidePerspective.html">Carbide C/C++ Perspective</a></li>
+ <li><a href="../debugger/debug/viewing_debug.htm">Debug view</a></li>
+ <li><a href="view_variables.htm">Variables view</a></li>
+ <li><a href="view_breakpoints.htm">Breakpoints view</a></li>
+ <li><a href="view_memory_wnd.htm">Memory view</a></li>
+ <li><a href="view_symbian_kernel.htm">Symbian OS Data view</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/panel_filter.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/panel_filter.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,58 +1,58 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Filter Preferences</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2> Launch Configuration Filters</h2>
-<p>The Launch Configuration Filters Preference window provides additional options for filtering out the launch configurations that appear in the list of configurations.</p>
-<div class="step">
- <h4>To access the Launch Configurations Filter Window</h4>
-</div>
-<ol>
- <li>Select the <b>Run > Open Debug Dialog...</b> menu item</li>
- <p>The <b>Debug</b> window appears.</p>
- <li>Select the Filter icon in the toolbar above the list of configuration types and defined configurations.</li>
- <p>The <b>Preferences (Filtered)</b> window appears (Figure 1).</p>
-</ol>
-<p align="center"><img src="../images/panel_filter.png" width="627" height="574" /></p>
-<p class="figure">Figure 1 - Launch Configurations Filter Window</p>
-<p>The Launch Configuration Filters panel is used to filter out launch configurations from the list of launch configuration types that appear in the Run or Debug window used to define launch configurations. For example, select the <b>Filter checked launch configuration types</b> option and check the configuration types that you do not want to appear in the <b>Run > Run...</b> or <b>Run > Debug...</b> window, as shown in Figure 2. Then select Run > Debug... and notice that the types you have checked do not appear in the list. </p>
-<div class="step">
- <h4><b>To open the Launch Configurations Filter from Preferences</b></h4>
- <ol>
- <li>Select Window > Preferences...</li>
- <li>Expand the Run/Debug group</li>
- <li>Expand Launching and select Launch Configurations</li>
- </ol>
- <p align="center"><img src="../images/filter_launch_config.png" width="580" height="573" /></p>
- <p align="left" class="figure">Figure 2 - Launch Configurations Filter</p>
-</div>
-<h5>Related concepts</h5>
- <ul>
- <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
- <li><a href="../../concepts/trk.htm">Target Resident Kernel (TRK) </a></li>
-</ul>
-<h5 align="left">Related references</h5>
-<ul>
- <li><a href="../launch_configs/page_trk_main.htm">Main Pane</a></li>
- <li><a href="../launch_configs/page_trk_debugger.htm">Debugger Pane</a></li>
- <li><a href="../launch_configs/page_connection.htm">Connection Pane</a></li>
- <li><a href="../launch_configs/page_file_transfer.htm">File Transfer Pane </a></li>
- <li><a href="../launch_configs/app_trk_installation.htm">Installation Pane</a></li>
-</ul>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- <li><a href="../../tasks/projects/prj_new_build_config.htm">Adding/Removing Build Configurations</a></li>
- <li><a href="../../tasks/projects/prj_set_build_tgt.htm">Setting a Build Configuration </a></li>
-</ul>
-<p> </p>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Filter Preferences</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2> Launch Configuration Filters</h2>
+<p>The Launch Configuration Filters Preference window provides additional options for filtering out the launch configurations that appear in the list of configurations.</p>
+<div class="step">
+ <h4>To access the Launch Configurations Filter Window</h4>
+</div>
+<ol>
+ <li>Select the <b>Run > Open Debug Dialog...</b> menu item</li>
+ <p>The <b>Debug</b> window appears.</p>
+ <li>Select the Filter icon in the toolbar above the list of configuration types and defined configurations.</li>
+ <p>The <b>Preferences (Filtered)</b> window appears (Figure 1).</p>
+</ol>
+<p align="center"><img src="../images/panel_filter.png" width="627" height="574" /></p>
+<p class="figure">Figure 1 - Launch Configurations Filter Window</p>
+<p>The Launch Configuration Filters panel is used to filter out launch configurations from the list of launch configuration types that appear in the Run or Debug window used to define launch configurations. For example, select the <b>Filter checked launch configuration types</b> option and check the configuration types that you do not want to appear in the <b>Run > Run...</b> or <b>Run > Debug...</b> window, as shown in Figure 2. Then select Run > Debug... and notice that the types you have checked do not appear in the list. </p>
+<div class="step">
+ <h4><b>To open the Launch Configurations Filter from Preferences</b></h4>
+ <ol>
+ <li>Select Window > Preferences...</li>
+ <li>Expand the Run/Debug group</li>
+ <li>Expand Launching and select Launch Configurations</li>
+ </ol>
+ <p align="center"><img src="../images/filter_launch_config.png" width="580" height="573" /></p>
+ <p align="left" class="figure">Figure 2 - Launch Configurations Filter</p>
+</div>
+<h5>Related concepts</h5>
+ <ul>
+ <li><a href="../../concepts/debugger_about.htm">About the Debugger</a></li>
+ <li><a href="../../concepts/trk.htm">Target Resident Kernel (TRK) </a></li>
+</ul>
+<h5 align="left">Related references</h5>
+<ul>
+ <li><a href="../../projects/launch/page_main.htm">Main Pane</a></li>
+ <li><a href="../../projects/launch/page_debugger.htm">Debugger Pane</a></li>
+ <li><a href="../../projects/launch/page_connection.htm">Connection Pane</a></li>
+ <li><a href="../../projects/launch/page_file_transfer.htm">File Transfer Pane </a></li>
+ <li><a href="../../projects/launch/page_installation.htm">Installation Pane</a></li>
+</ul>
+<h5>Related tasks</h5>
+<ul>
+ <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
+ <li><a href="../../tasks/projects/prj_new_build_config.htm">Adding/Removing Build Configurations</a></li>
+ <li><a href="../../tasks/projects/prj_set_build_tgt.htm">Setting a Build Configuration </a></li>
+</ul>
+<p> </p>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/panel_trk_overview.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/panel_trk_overview.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,26 +1,26 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>TRK Panel Overview</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>TRK Pane Overview</h2>
-<p>When debugging a remote device using TRK, the following panes appear in the launch configuration window: </p>
-<ul>
- <li><a href="../launch_configs/page_trk_main.htm">Main Pane</a></li>
- <li><a href="../launch_configs/page_trk_debugger.htm">Debugger Pane</a></li>
- <li><a href="../launch_configs/page_file_transfer.htm">File Transfer Pane </a></li>
- <li><a href="../launch_configs/page_executables.htm">Executables Pane</a></li>
- <li><a href="../launch_configs/app_trk_installation.htm">Installation Pane </a></li>
- <li><a href="../launch_configs/sys_trk_rom_log.htm">ROM Log</a> (<i>System TRK only</i>) </li>
- <li><a href="../launch_configs/emulator_overview.htm">Source</a>—specifies the location of source files used when debugging a C or C++ application</li>
- <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a>—specifies the location to store your run configuration, how to access it and what perspective to open when running an application</li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>TRK Panel Overview</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>TRK Pane Overview</h2>
+<p>When debugging a remote device using TRK, the following panes appear in the launch configuration window: </p>
+<ul>
+ <li><a href="../../projects/launch/page_main.htm">Main Pane</a></li>
+ <li><a href="../../projects/launch/page_debugger.htm">Debugger Pane</a></li>
+ <li><a href="../../projects/launch/page_file_transfer.htm">File Transfer Pane </a></li>
+ <li><a href="../../projects/launch/page_executables.htm">Executables Pane</a></li>
+ <li><a href="../../projects/launch/page_installation.htm">Installation Pane </a></li>
+ <li><a href="../../projects/launch/page_rom_log.htm">ROM Log</a> (<i>System TRK only</i>) </li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a>—specifies the location of source files used when debugging a C or C++ application</li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a>—specifies the location to store your run configuration, how to access it and what perspective to open when running an application</li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_wiz_add.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_wiz_add.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,122 +1,122 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="keywords" content="Check TRK, TRK, Install TRK"
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Adding, Editing, and Deleting Connections</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Adding, Editing, and Deleting Connections</h2>
-<p>Use the <strong>Remote Connections</strong> view to monitor, create, edit, or remove common remote connection settings.</p>
-<ul>
- <li><a href="CONN_EDIT">Edit connection name and type</a></li>
- <li><a href="CONN_SET">Set Connection Settings pane</a></li>
- <li><a href="#INSTALL">Install Remote Agents pane</a></li>
-</ul>
-<h3><strong><a name="CONN_EDIT" id="INSTALL3"></a></strong>Edit connection name and type</h3>
-<p>Use the <b>Edit connection name and type</b> page to assign a name and connection type to the new connection setup.</p>
-<p align="center"><img src="../images/wnd_new_connection_wizard_01.png" width="456" height="554"></p>
-<p class="figure">Figure 1 - New Connection wizard Edit connection name and type page</p>
-<p>Table 1. Edit connection name and type page - options</p>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="28%" scope="col">Item</th>
- <th width="59%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><strong>Connetion Name</strong></td>
- <td><p>Enter a name for the connection.</p> </td>
- </tr>
- <tr>
- <td><strong>Conection Type</strong></td>
- <td>Select the type of connection this setup will use.</td>
- </tr>
- <tr>
- <td><strong>Supported Services</strong></td>
- <td><p>Shows a list of services supported by the connection type chosen.</p> </td>
- </tr>
-</table>
-<h3><strong><a name="CONN_SET" id="INSTALL2"></a></strong>Set Connection Settings pane</h3>
-<p>Use the <b>Set Connection Settings</b> pane to compare the version of remote agent installed on the device with the latest version available for Carbide. In this pane you can:</p>
-<ul>
- <li>Set the device OS used by the device and supported by the selected remote agent</li>
- <li>Allow easy serial port selection when connecting to a device </li>
- <li>Verify that you have the latest remote agent installed on a device</li>
-</ul>
-<p align="center"><img src="../images/wnd_new_connection_wizard_02.png" width="456" height="554"></p>
-<p class="figure">Figure 2 - New Connection wizard Serial Connection Settings page</p>
-<p>Table 2. Serial Connection Setting page - Set Connection Settings tab</p>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="30%" scope="col">Item</th>
- <th width="59%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><strong>Serial Port </strong></td>
- <td>A dropdown list of serial ports with known identifiers for selecting the communication port used by the PC to communicate with the device. A named COM port (<span class="code">COM4 - BthModem0</span>) indicates an active port. Unnamed port numbers have usually not been opened and assigned by the PC.</td>
- </tr>
- <tr>
- <td><b>Baud Rate</b></td>
- <td>a dropdown list of baud rates common to serial connections.</td>
- </tr>
- <tr>
- <td><strong>Device OS </strong></td>
- <td><p>A dropdown list of device OSes that are supported by the remote agent software. Select the OS used by the device before running a check. </p></td>
- </tr>
- <tr>
- <td><b>Select a service to test</b></td>
- <td>Click to select a listed service for testing.</td>
- </tr>
- <tr>
- <td><strong>Test Service Status</strong></td>
- <td><p>Click <strong>Test Service Status</strong> to query the remote agent software on the device for its version number. It then compares the version number found with the latest version available for Carbide. A progress bar will appear should the Check TRK version operation requires more than a few seconds.</p>
- <p class="note"><strong>NOTE</strong> The PC must have an internet connection to perform a remote agent version check.</p>
- <p>Once the comparison is complete the Status text is updated with the result and further instructions as required.</p>
- <p align="center"><img src="../images/wnd_on_device_setup_install_new_version.png" width="466" height="67"></p>
- <p align="left">If a connection fails, the errors normally fall into these two categories: </p>
- <ul>
- <li><strong>connection failure</strong> - this usually indicates the chosen COM port is not open. Try selecting a different COM port, specifically one with a name attached to it (<span class="code">COM4 - BthModem0</span>) for the type of connection you are using (USB or Bluetooth). Repeat as necessary until you get a successful response. </li>
- <li><strong>TRK not responding</strong> - this indicates that the COM port is open but TRK is not responding. First, verify that TRK is up and running on the device. Second, TRK may be listening on a different COM port, so choose another named COM port and try again.</li>
- </ul>
- <p align="left"> </p></td>
- </tr>
-</table>
-<h3><strong><a name="INSTALL" id="INSTALL"></a>Install Remote Agents</strong> pane</h3>
-<p>Use the <strong>Install Remote Agents</strong> pane to select the latest remote agent version to download and install to the device. </p>
-<p align="center"><img src="../images/wnd_new_connection_wizard_03.png" width="456" height="554"></p>
-<p class="figure">Figure 2 - New Connection wizard Serial Connection Settings page</p>
-<p>Table 3. Serial Connection Setting page - Install Remote Agents tab</p>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="30%" scope="col">Item</th>
- <th width="59%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><strong>Install remote agents</strong></td>
- <td><p>A list of the most current versions of remote agents sorted by SDK and version. Select the version most compatable with the device. For example, a device running S60 3.1.0 needs a version of the TRK software compiled for that SDK, which in the image above is Application TRK 2.8.7. </p>
- <p>Additional information about the selected entry is displayed to the right to help you choose the correct version of TRK for the target device. </p></td>
- </tr>
- <tr>
- <td><strong>Save</strong></td>
- <td>Click <strong>Save</strong> to store a local copy of the currently selected TRK to disk. You can then manually install the file to your devices using the method of your choice. </td>
- </tr>
- <tr>
- <td><strong>Install</strong></td>
- <td><p>Click <strong>Install</strong> to download and install the TRK selected in the Install latest TRK list. A progress bar is shown if the install operation requires more than a few seconds to complete. </p>
- <p class="note"><strong>NOTE</strong> The SIS and SISX file types must be associated with an installer application like Nokia PC Suite in order to install them onto the device. Use the Save command above to perform a manual install to the device if you don't have an installer application. </p></td>
- </tr>
-</table>
-<p> </p>
-<h5>Related references</h5>
-<ul>
- <li><a href="wnd_on_device_setup.htm">On-Device Setup</a></li>
- <li><a href="wnd_new_conn_install_tab.htm">Install latest TRK</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="keywords" content="Check TRK, TRK, Install TRK"
+><meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Adding, Editing, and Deleting Connections</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Adding, Editing, and Deleting Connections</h2>
+<p>Use the <strong>Remote Connections</strong> view to monitor, create, edit, or remove common remote connection settings.</p>
+<ul>
+ <li><a href="#CONN_EDIT">Edit connection name and type</a></li>
+ <li><a href="#CONN_SET">Set Connection Settings pane</a></li>
+ <li><a href="#INSTALL">Install Remote Agents pane</a></li>
+</ul>
+<h3><strong><a name="CONN_EDIT" id="INSTALL3"></a></strong>Edit connection name and type</h3>
+<p>Use the <b>Edit connection name and type</b> page to assign a name and connection type to the new connection setup.</p>
+<p align="center"><img src="../images/wnd_new_connection_wizard_01.png" width="456" height="554"></p>
+<p class="figure">Figure 1 - New Connection wizard Edit connection name and type page</p>
+<p>Table 1. Edit connection name and type page - options</p>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="28%" scope="col">Item</th>
+ <th width="59%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><strong>Connetion Name</strong></td>
+ <td><p>Enter a name for the connection.</p> </td>
+ </tr>
+ <tr>
+ <td><strong>Conection Type</strong></td>
+ <td>Select the type of connection this setup will use.</td>
+ </tr>
+ <tr>
+ <td><strong>Supported Services</strong></td>
+ <td><p>Shows a list of services supported by the connection type chosen.</p> </td>
+ </tr>
+</table>
+<h3><strong><a name="CONN_SET" id="INSTALL2"></a></strong>Set Connection Settings pane</h3>
+<p>Use the <b>Set Connection Settings</b> pane to compare the version of remote agent installed on the device with the latest version available for Carbide. In this pane you can:</p>
+<ul>
+ <li>Set the device OS used by the device and supported by the selected remote agent</li>
+ <li>Allow easy serial port selection when connecting to a device </li>
+ <li>Verify that you have the latest remote agent installed on a device</li>
+</ul>
+<p align="center"><img src="../images/wnd_new_connection_wizard_02.png" width="456" height="554"></p>
+<p class="figure">Figure 2 - New Connection wizard Serial Connection Settings page</p>
+<p>Table 2. Serial Connection Setting page - Set Connection Settings tab</p>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="30%" scope="col">Item</th>
+ <th width="59%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><strong>Serial Port </strong></td>
+ <td>A dropdown list of serial ports with known identifiers for selecting the communication port used by the PC to communicate with the device. A named COM port (<span class="code">COM4 - BthModem0</span>) indicates an active port. Unnamed port numbers have usually not been opened and assigned by the PC.</td>
+ </tr>
+ <tr>
+ <td><b>Baud Rate</b></td>
+ <td>a dropdown list of baud rates common to serial connections.</td>
+ </tr>
+ <tr>
+ <td><strong>Device OS </strong></td>
+ <td><p>A dropdown list of device OSes that are supported by the remote agent software. Select the OS used by the device before running a check. </p></td>
+ </tr>
+ <tr>
+ <td><b>Select a service to test</b></td>
+ <td>Click to select a listed service for testing.</td>
+ </tr>
+ <tr>
+ <td><strong>Test Service Status</strong></td>
+ <td><p>Click <strong>Test Service Status</strong> to query the remote agent software on the device for its version number. It then compares the version number found with the latest version available for Carbide. A progress bar will appear should the Check TRK version operation requires more than a few seconds.</p>
+ <p class="note"><strong>NOTE</strong> The PC must have an internet connection to perform a remote agent version check.</p>
+ <p>Once the comparison is complete the Status text is updated with the result and further instructions as required.</p>
+ <p align="center"><img src="../images/wnd_on_device_setup_install_new_version.png" width="466" height="67"></p>
+ <p align="left">If a connection fails, the errors normally fall into these two categories: </p>
+ <ul>
+ <li><strong>connection failure</strong> - this usually indicates the chosen COM port is not open. Try selecting a different COM port, specifically one with a name attached to it (<span class="code">COM4 - BthModem0</span>) for the type of connection you are using (USB or Bluetooth). Repeat as necessary until you get a successful response. </li>
+ <li><strong>TRK not responding</strong> - this indicates that the COM port is open but TRK is not responding. First, verify that TRK is up and running on the device. Second, TRK may be listening on a different COM port, so choose another named COM port and try again.</li>
+ </ul>
+ <p align="left"> </p></td>
+ </tr>
+</table>
+<h3><strong><a name="INSTALL" id="INSTALL"></a>Install Remote Agents</strong> pane</h3>
+<p>Use the <strong>Install Remote Agents</strong> pane to select the latest remote agent version to download and install to the device. </p>
+<p align="center"><img src="../images/wnd_new_connection_wizard_03.png" width="456" height="554"></p>
+<p class="figure">Figure 2 - New Connection wizard Serial Connection Settings page</p>
+<p>Table 3. Serial Connection Setting page - Install Remote Agents tab</p>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="30%" scope="col">Item</th>
+ <th width="59%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><strong>Install remote agents</strong></td>
+ <td><p>A list of the most current versions of remote agents sorted by SDK and version. Select the version most compatable with the device. For example, a device running S60 3.1.0 needs a version of the TRK software compiled for that SDK, which in the image above is Application TRK 2.8.7. </p>
+ <p>Additional information about the selected entry is displayed to the right to help you choose the correct version of TRK for the target device. </p></td>
+ </tr>
+ <tr>
+ <td><strong>Save</strong></td>
+ <td>Click <strong>Save</strong> to store a local copy of the currently selected TRK to disk. You can then manually install the file to your devices using the method of your choice. </td>
+ </tr>
+ <tr>
+ <td><strong>Install</strong></td>
+ <td><p>Click <strong>Install</strong> to download and install the TRK selected in the Install latest TRK list. A progress bar is shown if the install operation requires more than a few seconds to complete. </p>
+ <p class="note"><strong>NOTE</strong> The SIS and SISX file types must be associated with an installer application like Nokia PC Suite in order to install them onto the device. Use the Save command above to perform a manual install to the device if you don't have an installer application. </p></td>
+ </tr>
+</table>
+<p> </p>
+<h5>Related references</h5>
+<ul>
+ <li><a href="wnd_on_device_setup.htm">On-Device Setup</a></li>
+ <li><a href="wnd_new_conn_install_tab.htm">Install latest TRK</a> </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_wiz_edit.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/trk/wnd_new_conn_wiz_edit.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,122 +1,122 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="keywords" content="Check TRK, TRK, Install TRK"
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Editing connections</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Editing connections</h2>
-<p>Use the <strong>Remote Connections</strong> view to monitor, create, edit, or remove common remote connection settings.</p>
-<ul>
- <li><a href="CONN_EDIT">Edit connection name and type</a></li>
- <li><a href="CONN_SET">Set Connection Settings pane</a></li>
- <li><a href="#INSTALL">Install Remote Agents pane</a></li>
-</ul>
-<h3><strong><a name="CONN_EDIT" id="INSTALL3"></a></strong>Edit connection name and type</h3>
-<p>Use the <b>Edit connection name and type</b> page to assign a name and connection type to the new connection setup.</p>
-<p align="center"><img src="../images/wnd_new_connection_wizard_01.png" width="456" height="554"></p>
-<p class="figure">Figure 1 - New Connection wizard Edit connection name and type page</p>
-<p>Table 1. Edit connection name and type page - options</p>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="28%" scope="col">Item</th>
- <th width="59%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><strong>Connetion Name</strong></td>
- <td><p>Enter a name for the connection.</p> </td>
- </tr>
- <tr>
- <td><strong>Conection Type</strong></td>
- <td>Select the type of connection this setup will use.</td>
- </tr>
- <tr>
- <td><strong>Supported Services</strong></td>
- <td><p>Shows a list of services supported by the connection type chosen.</p> </td>
- </tr>
-</table>
-<h3><strong><a name="CONN_SET" id="INSTALL2"></a></strong>Set Connection Settings pane</h3>
-<p>Use the <b>Set Connection Settings</b> pane to compare the version of remote agent installed on the device with the latest version available for Carbide. In this pane you can:</p>
-<ul>
- <li>Set the device OS used by the device and supported by the selected remote agent</li>
- <li>Allow easy serial port selection when connecting to a device </li>
- <li>Verify that you have the latest remote agent installed on a device</li>
-</ul>
-<p align="center"><img src="../images/wnd_new_connection_wizard_02.png" width="456" height="554"></p>
-<p class="figure">Figure 2 - New Connection wizard Serial Connection Settings page</p>
-<p>Table 2. Serial Connection Setting page - Set Connection Settings tab</p>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="30%" scope="col">Item</th>
- <th width="59%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><strong>Serial Port </strong></td>
- <td>A dropdown list of serial ports with known identifiers for selecting the communication port used by the PC to communicate with the device. A named COM port (<span class="code">COM4 - BthModem0</span>) indicates an active port. Unnamed port numbers have usually not been opened and assigned by the PC.</td>
- </tr>
- <tr>
- <td><b>Baud Rate</b></td>
- <td>a dropdown list of baud rates common to serial connections.</td>
- </tr>
- <tr>
- <td><strong>Device OS </strong></td>
- <td><p>A dropdown list of device OSes that are supported by the remote agent software. Select the OS used by the device before running a check. </p></td>
- </tr>
- <tr>
- <td><b>Select a service to test</b></td>
- <td>Click to select a listed service for testing.</td>
- </tr>
- <tr>
- <td><strong>Test Service Status</strong></td>
- <td><p>Click <strong>Test Service Status</strong> to query the remote agent software on the device for its version number. It then compares the version number found with the latest version available for Carbide. A progress bar will appear should the Check TRK version operation requires more than a few seconds.</p>
- <p class="note"><strong>NOTE</strong> The PC must have an internet connection to perform a remote agent version check.</p>
- <p>Once the comparison is complete the Status text is updated with the result and further instructions as required.</p>
- <p align="center"><img src="../images/wnd_on_device_setup_install_new_version.png" width="466" height="67"></p>
- <p align="left">If a connection fails, the errors normally fall into these two categories: </p>
- <ul>
- <li><strong>connection failure</strong> - this usually indicates the chosen COM port is not open. Try selecting a different COM port, specifically one with a name attached to it (<span class="code">COM4 - BthModem0</span>) for the type of connection you are using (USB or Bluetooth). Repeat as necessary until you get a successful response. </li>
- <li><strong>TRK not responding</strong> - this indicates that the COM port is open but TRK is not responding. First, verify that TRK is up and running on the device. Second, TRK may be listening on a different COM port, so choose another named COM port and try again.</li>
- </ul>
- <p align="left"> </p></td>
- </tr>
-</table>
-<h3><strong><a name="INSTALL" id="INSTALL"></a>Install Remote Agents</strong> pane</h3>
-<p>Use the <strong>Install Remote Agents</strong> pane to select the latest remote agent version to download and install to the device. </p>
-<p align="center"><img src="../images/wnd_new_connection_wizard_03.png" width="456" height="554"></p>
-<p class="figure">Figure 2 - New Connection wizard Serial Connection Settings page</p>
-<p>Table 3. Serial Connection Setting page - Install Remote Agents tab</p>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="30%" scope="col">Item</th>
- <th width="59%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><strong>Install remote agents</strong></td>
- <td><p>A list of the most current versions of remote agents sorted by SDK and version. Select the version most compatable with the device. For example, a device running S60 3.1.0 needs a version of the TRK software compiled for that SDK, which in the image above is Application TRK 2.8.7. </p>
- <p>Additional information about the selected entry is displayed to the right to help you choose the correct version of TRK for the target device. </p></td>
- </tr>
- <tr>
- <td><strong>Save</strong></td>
- <td>Click <strong>Save</strong> to store a local copy of the currently selected TRK to disk. You can then manually install the file to your devices using the method of your choice. </td>
- </tr>
- <tr>
- <td><strong>Install</strong></td>
- <td><p>Click <strong>Install</strong> to download and install the TRK selected in the Install latest TRK list. A progress bar is shown if the install operation requires more than a few seconds to complete. </p>
- <p class="note"><strong>NOTE</strong> The SIS and SISX file types must be associated with an installer application like Nokia PC Suite in order to install them onto the device. Use the Save command above to perform a manual install to the device if you don't have an installer application. </p></td>
- </tr>
-</table>
-<p> </p>
-<h5>Related references</h5>
-<ul>
- <li><a href="wnd_on_device_setup.htm">On-Device Setup</a></li>
- <li><a href="wnd_new_conn_install_tab.htm">Install latest TRK</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="keywords" content="Check TRK, TRK, Install TRK"
+><meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Editing connections</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Editing connections</h2>
+<p>Use the <strong>Remote Connections</strong> view to monitor, create, edit, or remove common remote connection settings.</p>
+<ul>
+ <li><a href="#CONN_EDIT">Edit connection name and type</a></li>
+ <li><a href="#CONN_SET">Set Connection Settings pane</a></li>
+ <li><a href="#INSTALL">Install Remote Agents pane</a></li>
+</ul>
+<h3><strong><a name="CONN_EDIT" id="INSTALL3"></a></strong>Edit connection name and type</h3>
+<p>Use the <b>Edit connection name and type</b> page to assign a name and connection type to the new connection setup.</p>
+<p align="center"><img src="../images/wnd_new_connection_wizard_01.png" width="456" height="554"></p>
+<p class="figure">Figure 1 - New Connection wizard Edit connection name and type page</p>
+<p>Table 1. Edit connection name and type page - options</p>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="28%" scope="col">Item</th>
+ <th width="59%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><strong>Connetion Name</strong></td>
+ <td><p>Enter a name for the connection.</p> </td>
+ </tr>
+ <tr>
+ <td><strong>Conection Type</strong></td>
+ <td>Select the type of connection this setup will use.</td>
+ </tr>
+ <tr>
+ <td><strong>Supported Services</strong></td>
+ <td><p>Shows a list of services supported by the connection type chosen.</p> </td>
+ </tr>
+</table>
+<h3><strong><a name="CONN_SET" id="INSTALL2"></a></strong>Set Connection Settings pane</h3>
+<p>Use the <b>Set Connection Settings</b> pane to compare the version of remote agent installed on the device with the latest version available for Carbide. In this pane you can:</p>
+<ul>
+ <li>Set the device OS used by the device and supported by the selected remote agent</li>
+ <li>Allow easy serial port selection when connecting to a device </li>
+ <li>Verify that you have the latest remote agent installed on a device</li>
+</ul>
+<p align="center"><img src="../images/wnd_new_connection_wizard_02.png" width="456" height="554"></p>
+<p class="figure">Figure 2 - New Connection wizard Serial Connection Settings page</p>
+<p>Table 2. Serial Connection Setting page - Set Connection Settings tab</p>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="30%" scope="col">Item</th>
+ <th width="59%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><strong>Serial Port </strong></td>
+ <td>A dropdown list of serial ports with known identifiers for selecting the communication port used by the PC to communicate with the device. A named COM port (<span class="code">COM4 - BthModem0</span>) indicates an active port. Unnamed port numbers have usually not been opened and assigned by the PC.</td>
+ </tr>
+ <tr>
+ <td><b>Baud Rate</b></td>
+ <td>a dropdown list of baud rates common to serial connections.</td>
+ </tr>
+ <tr>
+ <td><strong>Device OS </strong></td>
+ <td><p>A dropdown list of device OSes that are supported by the remote agent software. Select the OS used by the device before running a check. </p></td>
+ </tr>
+ <tr>
+ <td><b>Select a service to test</b></td>
+ <td>Click to select a listed service for testing.</td>
+ </tr>
+ <tr>
+ <td><strong>Test Service Status</strong></td>
+ <td><p>Click <strong>Test Service Status</strong> to query the remote agent software on the device for its version number. It then compares the version number found with the latest version available for Carbide. A progress bar will appear should the Check TRK version operation requires more than a few seconds.</p>
+ <p class="note"><strong>NOTE</strong> The PC must have an internet connection to perform a remote agent version check.</p>
+ <p>Once the comparison is complete the Status text is updated with the result and further instructions as required.</p>
+ <p align="center"><img src="../images/wnd_on_device_setup_install_new_version.png" width="466" height="67"></p>
+ <p align="left">If a connection fails, the errors normally fall into these two categories: </p>
+ <ul>
+ <li><strong>connection failure</strong> - this usually indicates the chosen COM port is not open. Try selecting a different COM port, specifically one with a name attached to it (<span class="code">COM4 - BthModem0</span>) for the type of connection you are using (USB or Bluetooth). Repeat as necessary until you get a successful response. </li>
+ <li><strong>TRK not responding</strong> - this indicates that the COM port is open but TRK is not responding. First, verify that TRK is up and running on the device. Second, TRK may be listening on a different COM port, so choose another named COM port and try again.</li>
+ </ul>
+ <p align="left"> </p></td>
+ </tr>
+</table>
+<h3><strong><a name="INSTALL" id="INSTALL"></a>Install Remote Agents</strong> pane</h3>
+<p>Use the <strong>Install Remote Agents</strong> pane to select the latest remote agent version to download and install to the device. </p>
+<p align="center"><img src="../images/wnd_new_connection_wizard_03.png" width="456" height="554"></p>
+<p class="figure">Figure 2 - New Connection wizard Serial Connection Settings page</p>
+<p>Table 3. Serial Connection Setting page - Install Remote Agents tab</p>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="30%" scope="col">Item</th>
+ <th width="59%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><strong>Install remote agents</strong></td>
+ <td><p>A list of the most current versions of remote agents sorted by SDK and version. Select the version most compatable with the device. For example, a device running S60 3.1.0 needs a version of the TRK software compiled for that SDK, which in the image above is Application TRK 2.8.7. </p>
+ <p>Additional information about the selected entry is displayed to the right to help you choose the correct version of TRK for the target device. </p></td>
+ </tr>
+ <tr>
+ <td><strong>Save</strong></td>
+ <td>Click <strong>Save</strong> to store a local copy of the currently selected TRK to disk. You can then manually install the file to your devices using the method of your choice. </td>
+ </tr>
+ <tr>
+ <td><strong>Install</strong></td>
+ <td><p>Click <strong>Install</strong> to download and install the TRK selected in the Install latest TRK list. A progress bar is shown if the install operation requires more than a few seconds to complete. </p>
+ <p class="note"><strong>NOTE</strong> The SIS and SISX file types must be associated with an installer application like Nokia PC Suite in order to install them onto the device. Use the Save command above to perform a manual install to the device if you don't have an installer application. </p></td>
+ </tr>
+</table>
+<p> </p>
+<h5>Related references</h5>
+<ul>
+ <li><a href="wnd_on_device_setup.htm">On-Device Setup</a></li>
+ <li><a href="wnd_new_conn_install_tab.htm">Install latest TRK</a> </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_debug.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,111 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debug View</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debug View </h2>
-<p>The <b>Debug</b> view shows the target debugging information in a tree hierarchy. The items that appear there include:</p>
-<ul>
- <li>Launch instance (<img src="../images/icons/debug_launch_instance_icon.png" width="16" height="16" align="absmiddle" />) - launch configuration name and type </li>
- <li>Debugger instance (<img src="../images/icons/debug_debugger_instance_icon.png" width="18" height="16" align="absmiddle" />) - debugger name and state </li>
- <li>Executable instances (<img src="../images/icons/debug_codebug_instance_icon.png" width="17" height="17" align="absmiddle" />) - other executables called by the launch instance </li>
- <li>Thread instance (<img src="../images/icons/debug_thread_instance_icon.png" width="16" height="15" align="absmiddle" />) - thread number and state </li>
- <li>Stack frame reference (<img src="../images/icons/debug_stack_frame_instance_icon.png" width="16" height="14" align="absmiddle" />) - displays stack frame number, function, filename, and file line number when symbols are available and stack frame number, memory address, and filename when symbols are not available </li>
-</ul>
-<p class="note"><b>NOTE</b> The number beside the thread label is a reference counter, not a thread
-identification number (TID).</p>
-<p>The CDT displays stack frames as child elements. It displays the reason for the suspension beside the thread, (such as end of stepping range, breakpoint hit, and signal received). When a program exits, the exit code is displayed.</p>
-<p>In addition to controlling the individual stepping of your programs, you can also control the debug session. You can perform actions such as terminating the session and stopping the program by using the debug launch controls available from Debug view. See Table 1 for details. </p>
-<p>Figure 1 shows the Debug view. Table 1 explains the items in the view.</p>
-<p align="center"><img src="images/view_debug.png" width="545" height="264" /></p>
-<p class="figure">Figure 1 - Debug view</p>
-<h5>Table 1 Debug view—items</h5>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="29%" scope="col">Item</th>
- <th width="14%" scope="col">Icon</th>
- <th width="57%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_resume.htm">Resume</a></td>
- <td><div align="center"><img src="images/view_debug_resume_btn.png" width="19" height="16" /></div></td>
- <td><p>Click to perform these tasks:</p>
- <ul>
- <li>Continue execution up to the next breakpoint, watchpoint, or eventpoint</li>
- <li>Run the program until it exits</li>
- <li>Continue execution of a currently stopped program</li>
- </ul></td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_stop.htm">Suspend</a></td>
- <td><div align="center"><img src="images/view_debug_suspend_btn.png" width="19" height="16" /></div></td>
- <td>Click to stop (pause) program execution.</td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_kill.htm">Terminate</a></td>
- <td><div align="center"><img src="images/view_debug_terminate_btn.png" width="17" height="17" /></div></td>
- <td>Click to terminate program execution.</td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_disconnect.htm">Disconnect</a></td>
- <td><div align="center"><img src="../images/icons/btn_disconnect.png" width="20" height="21" /></div></td>
- <td><p>Detaches the debugger from the selected process (useful for debugging attached processes).</p>
- <p class="note"><b>NOTE</b> After detaching the debugger from an on-device process, closing TRK on the device will also close the process. </p></td>
- </tr>
- <tr>
- <td><b>Remove All Terminated </b></td>
- <td><div align="center"><img src="../images/icons/breakpoints_remove_all_icon.png" width="21" height="19" /></div></td>
- <td>Clears all terminated processes in Debug view.</td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_start.htm">Restart</a></td>
- <td><div align="center"><img src="images/view_debug_restart_btn.png" width="19" height="19" /></div></td>
- <td>Returns the debugger to the beginning of the program and begins execution again. This behavior is equivalent to killing execution, then starting a new debugging session.</td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_stepover.htm">Step Over</a></td>
- <td><div align="center"><img src="images/view_debug_step_over_btn.png" width="18" height="14" /></div></td>
- <td>Click to execute the current line, including any routines, and proceed to the next statement.</td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_stepinto.htm">Step Into</a></td>
- <td><div align="center"><img src="images/view_debug_step_into_btn.png" width="18" height="14" /></div></td>
- <td>Click to execute the current line, following execution inside a routine.</td>
- </tr>
- <tr>
- <td><a href="../tasks/debugger/work_debug_act_stepout.htm">Step Return</a></td>
- <td><div align="center"><img src="images/view_debug_step_return_btn.png" width="18" height="15" /></div></td>
- <td>Click to continue execution to the end of the current routine, then follow execution to the routine’s caller.</td>
- </tr>
- <tr>
- <td><b>Instruction Stepping Mode </b></td>
- <td><div align="center"><img src="images/icon_instr_stepping_mode.png" width="18" height="16"></div></td>
- <td>Activate to enable instruction stepping mode to examine a program as it steps into disassembled code.</td>
- </tr>
-</table>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="../concepts/breakpoints.htm">Breakpoints</a></li>
-</ul>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="../tasks/breakpoints/pgm_bp_setting.htm">Setting Breakpoints</a></li>
- <li><a href="../tasks/breakpoints/pgm_bp_enable.htm">Enabling Breakpoints</a></li>
- <li><a href="../tasks/breakpoints/pgm_bp_disable.htm">Disabling Breakpoints</a></li>
-</ul>
-<h5>Related references</h5>
-<ul>
- <li><a href="../tasks/projects/prj_debug_config.htm">Debugger Configuration</a></li>
- <li><a href="launch_configs/emulator_debugger.htm">Debugger Pane </a></li>
- <li><a href="../reference/wnd_debugger_prefs.htm">Debugger Preferences</a></li>
- <li><a href="view_symbian_kernel.htm">Symbian OS View</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_disassembly.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_disassembly.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,101 +1,101 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Disassembly Window</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-<style type="text/css">
-<!--
-.style1 {
- color: #FF0000;
- font-weight: bold;
-}
--->
-</style>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Disassembly View</h2>
-<p> When debugging your application, the <b>Disassembly</b> view shows the loaded program as assembler instructions. When you use the Disassembly view, you can do the following tasks:</p>
-<ul>
- <li>Step through the disassembly instructions of your program using the <b>Instruction Stepping Mode</b> (<img src="images/icon_instr_stepping_mode.png" width="18" height="16" align="absmiddle">) icon in the <a href="view_debug.htm">Debug</a> view (Figure 1). </li>
- <li>Reposition the PC using the various move commands (Figure 1) by first selecting the line to move to, then select the command from the context menu.</li>
- <li>Set breakpoints at the start of any assembler instruction by right-clicking the left hand column to view the context menu options (Figure 2) </li>
-</ul>
-<p>Figure 1 shows the Dissassembly view and the PC context menu that appears when you right-click in the data pane. Right-clicking the left border opens the breakpoint context menu.</p>
-<p align="center"><img src="images/view_disassembly.png" width="555" height="272" alt="" /></p>
-<p class="figure">Figure 1 - Repositioning the PC in the Disassembly view</p>
-<p class="figure"><img src="images/view_disassm_breakpoint.png" width="506" height="172" alt="" /></p>
-<p class="figure">Figure 2 - Setting Breakpoints in the Disassembly view </p>
-<h5>Table 1. Disassembly view —context menu</h5>
-<table width="88%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="26%" scope="col">Item</th>
- <th width="8%" scope="col">Icon</th>
- <th width="66%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Run to Line </b></td>
- <td><center>
- <img src="images/icon_dis_run_to_line.png" width="18" height="18">
- </center> </td>
- <td>Select <b>Run to Line</b> to execute the program from the currently executed line (the green line) to the selected line (the blue line).</td>
- </tr>
- <tr>
- <td><b>Move to Line</b></td>
- <td><center>
- <img src="images/icon_dis_move_to_line.png" width="19" height="15">
- </center>
- </td>
- <td><p>Select <b>Move to Line</b> to move the program counter to the selected line (the blue line) skipping all intermediate lines but not resume execution. This enables you to skip suspect code and continue stepping through your program.</p>
- <p class="note"><span class="style1">WARNING</span> Using this command can leave a program in an unstable state. Use at your own risk.</p></td>
- </tr>
- <tr>
- <td><b>Resume at Line </b></td>
- <td><center>
- <img src="images/icon_dis_resume_at_line.png" width="18" height="14">
- </center> </td>
- <td><p>Select <b>Resume at Line</b> to begin program execution at the selected line (the blue line), skipping all lines between it and the currently executed line (the green line). </p>
- <p class="note"><span class="style1">WARNING</span> Using this command can leave a program in an unstable state. Use at your own risk.</p></td>
- </tr>
- <tr>
- <td><b>Toggle Breakpoint </b></td>
- <td><center>
- </center> </td>
- <td>Right-click in left-hand column of the Disassembly view and select this option to toggle the breakpoint state between <a href="../tasks/breakpoints/pgm_bp_setting.htm">setting</a> and <a href="../tasks/breakpoints/pgm_bp_clearing.htm">removing</a> the breakpoint. </td>
- </tr>
- <tr>
- <td><b>Disable/Enable Breakpoint </b></td>
- <td><center>
- </center> </td>
- <td>Right-click in left-hand column of the Disassembly view and select the breakpoint option shown as determined by the current state of the breakpoint.</td>
- </tr>
- <tr>
- <td><b>Breakpoint Properties </b></td>
- <td><center>
- </center> </td>
- <td>Select this option to open the Breakpoint Properties dialog. </td>
- </tr>
-</table>
-<div class="step">
- <h4>Opening the Disassembly view </h4>
- <ul>
- <li>Select Window > Show View > Disassembly </li>
- </ul>
- <blockquote>
- <p>OR</p>
- </blockquote>
- <ul>
- <li>Click the Instruction Stepping Mode (<img src="images/icon_instr_stepping_mode.png" width="18" height="16" align="absmiddle">) icon in the <a href="view_debug.htm">Debug</a> view
- <p>A Disassembly view appears in the current perspective.</p>
- </li>
- </ul>
- </div>
-<h5>Related reference</h5>
-<ul><li><a href="../concepts/breakpoints.htm">Breakpoints</a></li>
- <li><a href="../debugger/debug/cmds_reposition_pc.htm">Repositioning the Program Counter</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Disassembly Window</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+<style type="text/css">
+<!--
+.style1 {
+ color: #FF0000;
+ font-weight: bold;
+}
+-->
+</style>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Disassembly View</h2>
+<p> When debugging your application, the <b>Disassembly</b> view shows the loaded program as assembler instructions. When you use the Disassembly view, you can do the following tasks:</p>
+<ul>
+ <li>Step through the disassembly instructions of your program using the <b>Instruction Stepping Mode</b> (<img src="images/icon_instr_stepping_mode.png" width="18" height="16" align="absmiddle">) icon in the <a href="../debugger/debug/viewing_debug.htm">Debug</a> view (Figure 1). </li>
+ <li>Reposition the PC using the various move commands (Figure 1) by first selecting the line to move to, then select the command from the context menu.</li>
+ <li>Set breakpoints at the start of any assembler instruction by right-clicking the left hand column to view the context menu options (Figure 2) </li>
+</ul>
+<p>Figure 1 shows the Dissassembly view and the PC context menu that appears when you right-click in the data pane. Right-clicking the left border opens the breakpoint context menu.</p>
+<p align="center"><img src="images/view_disassembly.png" width="555" height="272" alt="" /></p>
+<p class="figure">Figure 1 - Repositioning the PC in the Disassembly view</p>
+<p class="figure"><img src="images/view_disassm_breakpoint.png" width="506" height="172" alt="" /></p>
+<p class="figure">Figure 2 - Setting Breakpoints in the Disassembly view </p>
+<h5>Table 1. Disassembly view —context menu</h5>
+<table width="88%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="26%" scope="col">Item</th>
+ <th width="8%" scope="col">Icon</th>
+ <th width="66%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><b>Run to Line </b></td>
+ <td><center>
+ <img src="images/icon_dis_run_to_line.png" width="18" height="18">
+ </center> </td>
+ <td>Select <b>Run to Line</b> to execute the program from the currently executed line (the green line) to the selected line (the blue line).</td>
+ </tr>
+ <tr>
+ <td><b>Move to Line</b></td>
+ <td><center>
+ <img src="images/icon_dis_move_to_line.png" width="19" height="15">
+ </center>
+ </td>
+ <td><p>Select <b>Move to Line</b> to move the program counter to the selected line (the blue line) skipping all intermediate lines but not resume execution. This enables you to skip suspect code and continue stepping through your program.</p>
+ <p class="note"><span class="style1">WARNING</span> Using this command can leave a program in an unstable state. Use at your own risk.</p></td>
+ </tr>
+ <tr>
+ <td><b>Resume at Line </b></td>
+ <td><center>
+ <img src="images/icon_dis_resume_at_line.png" width="18" height="14">
+ </center> </td>
+ <td><p>Select <b>Resume at Line</b> to begin program execution at the selected line (the blue line), skipping all lines between it and the currently executed line (the green line). </p>
+ <p class="note"><span class="style1">WARNING</span> Using this command can leave a program in an unstable state. Use at your own risk.</p></td>
+ </tr>
+ <tr>
+ <td><b>Toggle Breakpoint </b></td>
+ <td><center>
+ </center> </td>
+ <td>Right-click in left-hand column of the Disassembly view and select this option to toggle the breakpoint state between <a href="../tasks/breakpoints/pgm_bp_setting.htm">setting</a> and <a href="../tasks/breakpoints/pgm_bp_clearing.htm">removing</a> the breakpoint. </td>
+ </tr>
+ <tr>
+ <td><b>Disable/Enable Breakpoint </b></td>
+ <td><center>
+ </center> </td>
+ <td>Right-click in left-hand column of the Disassembly view and select the breakpoint option shown as determined by the current state of the breakpoint.</td>
+ </tr>
+ <tr>
+ <td><b>Breakpoint Properties </b></td>
+ <td><center>
+ </center> </td>
+ <td>Select this option to open the Breakpoint Properties dialog. </td>
+ </tr>
+</table>
+<div class="step">
+ <h4>Opening the Disassembly view </h4>
+ <ul>
+ <li>Select Window > Show View > Disassembly </li>
+ </ul>
+ <blockquote>
+ <p>OR</p>
+ </blockquote>
+ <ul>
+ <li>Click the Instruction Stepping Mode (<img src="images/icon_instr_stepping_mode.png" width="18" height="16" align="absmiddle">) icon in the <a href="../debugger/debug/viewing_debug.htm">Debug</a> view
+ <p>A Disassembly view appears in the current perspective.</p>
+ </li>
+ </ul>
+ </div>
+<h5>Related reference</h5>
+<ul><li><a href="../concepts/breakpoints.htm">Breakpoints</a></li>
+ <li><a href="../debugger/debug/cmds_reposition_pc.htm">Repositioning the Program Counter</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_executables.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_executables.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,103 +1,103 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Executables view</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Executables view </h2>
-<p> The <b>Executables</b> view provides a dynamic list of executables and their related source files. The Executables view makes it easy to:</p>
-<ul>
- <li>target all binaries for debugging because the symbolics are automatically loaded when a bld.inf is imported or a project is created from a template</li>
- <li>debug a binary that is not part of a project in the workspace by importing it into the Executables view to load the symbolics</li>
- <li> debug a process running on a device by <a href="../tasks/processes/attach_debugger_to_process.htm">attaching</a> to the process and importing the binaries associated with the process into the Executables view to load the symbolics. For example, you to debug a library loaded by the process, you would need to import the libary and the process executable. </li>
- <li>remove binaries when a project is closed or deleted from the workspace</li>
- <li>remove binaries imported from outside the workspace by clicking the <b>Remove the selected executables</b> icon (<img src="images/icon_delete_launch_config.png" width="17" height="16" align="absmiddle">) or deleting the binary from the Executables project in the <a href="view_cpp_projects.htm">Project Explorer</a> view </li>
- <li>locate and manage which source and resource files are associated with each executable. Paths shown in black text have been resolved, those in gray text cannot be found. </li>
- <li>identify and correct any path issues with missing source files (shown in gray text). Double-click the missing source file to open a <b>Locate File</b> editor view which enables you to find the missing file. </li>
- <li>view routines and header files used by the source file. Click the tree control to expand or collapse a list of included header files and routine names for fast navigation. </li>
- <li>find and set breakpoints, watchpoints, and eventpoints in source files. Double-click a source file to open it in an editor view and to review the status of its breakpoints. </li>
-</ul>
-<p>In addition, an <b>Executables</b> project is created in the <a href="view_cpp_projects.htm">Project Explorer</a> view. The binaries shown in the Executables project can be deleted which also removes them from the Executables view. For binaries outside the workspace you must import them into the Executables view so their symbolics can be used during the debug session. <span class="note">You can also drag and drop executables into the view. </span></p>
-<p class="note"><b>NOTE</b> To debug ROM DLLs with System TRK or in stop mode, always specify the <a href="launch_configs/sys_trk_rom_log.htm">ROM Log file</a> in the project's launch configuration. </p>
-<p align="center"><img src="images/view_executables.png" width="813" height="309" /></p>
-<p class="figure">Figure 1 - Executables view</p>
-<p align="left">The Executables view consists of the Executable Name and Source File Name panes describled in the table below. Use the Columns button in the toolbar to show or hide specific columns in each pane. Columns can be sorted and rearranged in the order desired. </p>
-<h5>Table 1. Executables view information </h5>
-<table width="88%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="17%" scope="col">Pane</th>
- <th width="83%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Executable Name </b></td>
- <td><p>Displays a list of executables in the workspace as well as other files added by the user. Select an executable to update the Source File Name pane with related files. The executable information shown can include: </p>
- <ul>
- <li><b>Executable Name</b> - (default) Name of the exectable file.</li>
- <li><b>Executable Project</b> - (default) The project associated with the executable.</li>
- <li><b>Executable Location</b> - (default) The current location of the executable.</li>
- <li><b>Executable Size</b> - The executable size shown in bytes.</li>
- <li><b>Executable Date</b> - The source file′s modification date.</li>
- <li><b>Executable Type</b> - The executable type (.exe, etc.) </li>
- </ul>
- <p>Click the Columns icon (<img src="../images/icons/btn_columns.png" width="14" height="14" align="absmiddle" />) to set which columns to show in this pane.</p></td>
- </tr>
- <tr>
- <td><b>Source File Name </b></td>
- <td><p>Displays a list of source files for the selected executable as extracted from the symbol table. The source file information shown can include: </p>
- <ul>
- <li><b>Source File Name</b> - (default) Name of the source file used by the executable. If no binary files are in the project the message <b>No source files found in <project_name></b> is shown. </li>
- <li><b>Source File Location</b> - (default) The current location of the source file. If the path is shown in gray text the source file was not located. To locate it, double-click to open a new editor, then click Locate File... to locate the missing file. The new path is compared to the old one and all files located in the same directory are automatically updated to use the new path.</li>
- <li><b>Source File Original Location </b> - (default) The original location of the source file which may be different than the current location. </li>
- <li><b>Source File Size</b> - The executable size shown in bytes.</li>
- <li><b>Source File </b><b>Date </b>- The source file′s modification date.</li>
- <li><b>Source File Type</b> - The source type (.h, .inc, etc.) </li>
- </ul>
- <p>Expand a file′s tree control to view the functions and header files used by the file. Double-click to open the source file for editing or to set breakpoints. </p>
- <p>Click the Columns icon (<img src="../images/icons/btn_columns.png" width="14" height="14" align="absmiddle" />) to set which columns to show in this pane.</p></td>
- </tr>
-</table>
-<h4>Executables view toolbar icons</h4>
-<p>The table below lists the unique icons displayed in the Executables view toolbar. </p>
-<h5>Table 2. Executables view toolbar options </h5>
-<table width="88%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="16%" scope="col">Command</th>
- <th width="32%" scope="col">Name</th>
- <th width="52%" scope="col">Description</th>
- </tr>
- <tr>
- <td><div align="center"><img src="../images/icons/btn_restart.png" width="20" height="18" /></div></td>
- <td><div align="left">Refresh the list of executables</div></td>
- <td>Click to refresh the executables list. </td>
- </tr>
- <tr>
- <td><div align="center"><img src="../images/icons/btn_import_executables.png" width="18" height="15" /></div></td>
- <td>Import an executable file </td>
- <td>Click to import an executable not in the workspace into the executables list. </td>
- </tr>
- <tr>
- <td><center>
- <img src="images/icon_delete_launch_config.png" width="17" height="16">
- </center>
- </td>
- <td>Remove the selected executables</td>
- <td>Click to remove one or more selected executables from the executables list. You will see a alert if the executable cannot be removed.</td>
- </tr>
- <tr>
- <td><div align="center"><img src="../images/icons/btn_columns.png" width="14" height="14" /></div></td>
- <td>Columns</td>
- <td>Opens the <b>Configure Columns</b> dialog for configuring which columns appear in the Executable and Source File panes. </td>
- </tr>
-</table>
-<h5>Other references</h5>
-<ul>
- <li><a href="perspective_debug.htm">Debug perspective </a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Executables view</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Executables view </h2>
+<p> The <b>Executables</b> view provides a dynamic list of executables and their related source files. The Executables view makes it easy to:</p>
+<ul>
+ <li>target all binaries for debugging because the symbolics are automatically loaded when a bld.inf is imported or a project is created from a template</li>
+ <li>debug a binary that is not part of a project in the workspace by importing it into the Executables view to load the symbolics</li>
+ <li> debug a process running on a device by <a href="../tasks/processes/attach_debugger_to_process.htm">attaching</a> to the process and importing the binaries associated with the process into the Executables view to load the symbolics. For example, you to debug a library loaded by the process, you would need to import the libary and the process executable. </li>
+ <li>remove binaries when a project is closed or deleted from the workspace</li>
+ <li>remove binaries imported from outside the workspace by clicking the <b>Remove the selected executables</b> icon (<img src="images/icon_delete_launch_config.png" width="17" height="16" align="absmiddle">) or deleting the binary from the Executables project in the <a href="view_cpp_projects.htm">Project Explorer</a> view </li>
+ <li>locate and manage which source and resource files are associated with each executable. Paths shown in black text have been resolved, those in gray text cannot be found. </li>
+ <li>identify and correct any path issues with missing source files (shown in gray text). Double-click the missing source file to open a <b>Locate File</b> editor view which enables you to find the missing file. </li>
+ <li>view routines and header files used by the source file. Click the tree control to expand or collapse a list of included header files and routine names for fast navigation. </li>
+ <li>find and set breakpoints, watchpoints, and eventpoints in source files. Double-click a source file to open it in an editor view and to review the status of its breakpoints. </li>
+</ul>
+<p>In addition, an <b>Executables</b> project is created in the <a href="view_cpp_projects.htm">Project Explorer</a> view. The binaries shown in the Executables project can be deleted which also removes them from the Executables view. For binaries outside the workspace you must import them into the Executables view so their symbolics can be used during the debug session. <span class="note">You can also drag and drop executables into the view. </span></p>
+<p class="note"><b>NOTE</b> To debug ROM DLLs with System TRK or in stop mode, always specify the <a href="../projects/launch/page_rom_log.htm">ROM Log file</a> in the project's launch configuration. </p>
+<p align="center"><img src="images/view_executables.png" width="813" height="309" /></p>
+<p class="figure">Figure 1 - Executables view</p>
+<p align="left">The Executables view consists of the Executable Name and Source File Name panes describled in the table below. Use the Columns button in the toolbar to show or hide specific columns in each pane. Columns can be sorted and rearranged in the order desired. </p>
+<h5>Table 1. Executables view information </h5>
+<table width="88%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="17%" scope="col">Pane</th>
+ <th width="83%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><b>Executable Name </b></td>
+ <td><p>Displays a list of executables in the workspace as well as other files added by the user. Select an executable to update the Source File Name pane with related files. The executable information shown can include: </p>
+ <ul>
+ <li><b>Executable Name</b> - (default) Name of the exectable file.</li>
+ <li><b>Executable Project</b> - (default) The project associated with the executable.</li>
+ <li><b>Executable Location</b> - (default) The current location of the executable.</li>
+ <li><b>Executable Size</b> - The executable size shown in bytes.</li>
+ <li><b>Executable Date</b> - The source file′s modification date.</li>
+ <li><b>Executable Type</b> - The executable type (.exe, etc.) </li>
+ </ul>
+ <p>Click the Columns icon (<img src="../images/icons/btn_columns.png" width="14" height="14" align="absmiddle" />) to set which columns to show in this pane.</p></td>
+ </tr>
+ <tr>
+ <td><b>Source File Name </b></td>
+ <td><p>Displays a list of source files for the selected executable as extracted from the symbol table. The source file information shown can include: </p>
+ <ul>
+ <li><b>Source File Name</b> - (default) Name of the source file used by the executable. If no binary files are in the project the message <b>No source files found in <project_name></b> is shown. </li>
+ <li><b>Source File Location</b> - (default) The current location of the source file. If the path is shown in gray text the source file was not located. To locate it, double-click to open a new editor, then click Locate File... to locate the missing file. The new path is compared to the old one and all files located in the same directory are automatically updated to use the new path.</li>
+ <li><b>Source File Original Location </b> - (default) The original location of the source file which may be different than the current location. </li>
+ <li><b>Source File Size</b> - The executable size shown in bytes.</li>
+ <li><b>Source File </b><b>Date </b>- The source file′s modification date.</li>
+ <li><b>Source File Type</b> - The source type (.h, .inc, etc.) </li>
+ </ul>
+ <p>Expand a file′s tree control to view the functions and header files used by the file. Double-click to open the source file for editing or to set breakpoints. </p>
+ <p>Click the Columns icon (<img src="../images/icons/btn_columns.png" width="14" height="14" align="absmiddle" />) to set which columns to show in this pane.</p></td>
+ </tr>
+</table>
+<h4>Executables view toolbar icons</h4>
+<p>The table below lists the unique icons displayed in the Executables view toolbar. </p>
+<h5>Table 2. Executables view toolbar options </h5>
+<table width="88%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="16%" scope="col">Command</th>
+ <th width="32%" scope="col">Name</th>
+ <th width="52%" scope="col">Description</th>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="../images/icons/btn_restart.png" width="20" height="18" /></div></td>
+ <td><div align="left">Refresh the list of executables</div></td>
+ <td>Click to refresh the executables list. </td>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="../images/icons/btn_import_executables.png" width="18" height="15" /></div></td>
+ <td>Import an executable file </td>
+ <td>Click to import an executable not in the workspace into the executables list. </td>
+ </tr>
+ <tr>
+ <td><center>
+ <img src="images/icon_delete_launch_config.png" width="17" height="16">
+ </center>
+ </td>
+ <td>Remove the selected executables</td>
+ <td>Click to remove one or more selected executables from the executables list. You will see a alert if the executable cannot be removed.</td>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="../images/icons/btn_columns.png" width="14" height="14" /></div></td>
+ <td>Columns</td>
+ <td>Opens the <b>Configure Columns</b> dialog for configuring which columns appear in the Executable and Source File panes. </td>
+ </tr>
+</table>
+<h5>Other references</h5>
+<ul>
+ <li><a href="perspective_debug.htm">Debug perspective </a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_log.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_log.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,72 +1,72 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Console View</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Console View </h2>
-<p> The <b>Console</b> view display<span><span>s the output of a process and allows you to provide keyboard input to a process</span></span>. There are numerous consoles available, see the Open Console dropdown list for those available to you. Most are enabled from various project panels in Carbide. </p>
-<p align="center"><img src="../images/views/view_console_build.png" width="778" height="203" /></p>
-<p class="figure">Figure 1 - Console view showing build console information</p>
-<p>To view <span class="code">RDebug::Printf</span> output in the <b>Console</b> view when targeting devices, ensure that the following <a href="launch_configs/emulator_debugger.htm">Debugger</a> options are matched with settings in the <span class="code">epoc.ini</span> file. </p>
-<ul>
- <li>Set <span class="code">LogToDebugger 1</span> to use the <b>View program output</b> option </li>
- <li>Set <span class="code">LogToFile 1</span> to enable the <b>View emulator output</b> option</li>
-</ul>
-<h5>Table 1 Console view—items </h5>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="29%" scope="col">Item</th>
- <th width="14%" scope="col">Icon</th>
- <th width="57%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Scroll Lock </b></td>
- <td><div align="center"><img src="../images/icons/console_scroll_lock_icon.png" width="15" height="18" /></div></td>
- <td>Toggles the scrolling of the console view contents. </td>
- </tr>
- <tr>
- <td><b>Clear Console </b></td>
- <td><div align="center"><img src="../images/icons/console_clear_console_icon.png" width="19" height="18" /></div></td>
- <td>Clears all content in the Console view.</td>
- </tr>
- <tr>
- <td><b>Pin Console </b></td>
- <td><div align="center"><img src="../images/icons/console_pin_console_icon.png" width="19" height="18" /></div></td>
- <td><p>Toggles the behavior of the console. When enabled the current console content is fixed all the time instead of scrolling out of sight. When disabled, the console changes according to the action. </p>
- </td>
- </tr>
- <tr>
- <td><b>Display Selected Console </b></td>
- <td><div align="center"><img src="../images/icons/console_display_selected_icon.png" width="30" height="18" /></div></td>
- <td>Changes the contents of the current console view to show the selected console output. </td>
- </tr>
- <tr>
- <td><b>Open Console </b></td>
- <td><div align="center"><img src="../images/icons/console_open_console_icon.png" width="30" height="18" /></div></td>
- <td><p>Opens a new console to display the log for:</p>
- <ul>
- <li>Platform Security Diagnostics</li>
- <li>New Windows System Messages Console </li>
- <li>New Emulation Program Output Console</li>
- <li>New TRK Program Output Console</li>
- <li>New TRK Communications Log Console</li>
- <li>New Trace32 Communications Log Console</li>
- <li>New Symbian Rom Log Console</li>
- <li>New Emulator Output Console</li>
- <li>CVS</li>
- <li>New Console View</li>
- </ul>
- <p>Remember that <i>program output</i> is console output from the running binary and <i>communications log</i> is the messages sent between TRK and the on-device debug agent. </p>
- <p class="note"><b>NOTE</b> You can pin any message log view so that it does not lose focus.</p></td>
- </tr>
-</table>
-<p> </p>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Console View</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Console View </h2>
+<p> The <b>Console</b> view display<span><span>s the output of a process and allows you to provide keyboard input to a process</span></span>. There are numerous consoles available, see the Open Console dropdown list for those available to you. Most are enabled from various project panels in Carbide. </p>
+<p align="center"><img src="../images/views/view_console_build.png" width="778" height="203" /></p>
+<p class="figure">Figure 1 - Console view showing build console information</p>
+<p>To view <span class="code">RDebug::Printf</span> output in the <b>Console</b> view when targeting devices, ensure that the following <a href="../projects/launch/page_debugger.htm">Debugger</a> options are matched with settings in the <span class="code">epoc.ini</span> file. </p>
+<ul>
+ <li>Set <span class="code">LogToDebugger 1</span> to use the <b>View program output</b> option </li>
+ <li>Set <span class="code">LogToFile 1</span> to enable the <b>View emulator output</b> option</li>
+</ul>
+<h5>Table 1 Console view—items </h5>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="29%" scope="col">Item</th>
+ <th width="14%" scope="col">Icon</th>
+ <th width="57%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><b>Scroll Lock </b></td>
+ <td><div align="center"><img src="../images/icons/console_scroll_lock_icon.png" width="15" height="18" /></div></td>
+ <td>Toggles the scrolling of the console view contents. </td>
+ </tr>
+ <tr>
+ <td><b>Clear Console </b></td>
+ <td><div align="center"><img src="../images/icons/console_clear_console_icon.png" width="19" height="18" /></div></td>
+ <td>Clears all content in the Console view.</td>
+ </tr>
+ <tr>
+ <td><b>Pin Console </b></td>
+ <td><div align="center"><img src="../images/icons/console_pin_console_icon.png" width="19" height="18" /></div></td>
+ <td><p>Toggles the behavior of the console. When enabled the current console content is fixed all the time instead of scrolling out of sight. When disabled, the console changes according to the action. </p>
+ </td>
+ </tr>
+ <tr>
+ <td><b>Display Selected Console </b></td>
+ <td><div align="center"><img src="../images/icons/console_display_selected_icon.png" width="30" height="18" /></div></td>
+ <td>Changes the contents of the current console view to show the selected console output. </td>
+ </tr>
+ <tr>
+ <td><b>Open Console </b></td>
+ <td><div align="center"><img src="../images/icons/console_open_console_icon.png" width="30" height="18" /></div></td>
+ <td><p>Opens a new console to display the log for:</p>
+ <ul>
+ <li>Platform Security Diagnostics</li>
+ <li>New Windows System Messages Console </li>
+ <li>New Emulation Program Output Console</li>
+ <li>New TRK Program Output Console</li>
+ <li>New TRK Communications Log Console</li>
+ <li>New Trace32 Communications Log Console</li>
+ <li>New Symbian Rom Log Console</li>
+ <li>New Emulator Output Console</li>
+ <li>CVS</li>
+ <li>New Console View</li>
+ </ul>
+ <p>Remember that <i>program output</i> is console output from the running binary and <i>communications log</i> is the messages sent between TRK and the on-device debug agent. </p>
+ <p class="note"><b>NOTE</b> You can pin any message log view so that it does not lose focus.</p></td>
+ </tr>
+</table>
+<p> </p>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_module_wnd.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_module_wnd.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,24 +1,24 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Modules View</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Modules View</h2>
-<p>The <b>Modules</b> view displays a list of modules loaded while debugging your program. The listed modules can be selected to show related information. You can open the Modules view in the <a href="../concepts/CarbidePerspective.html">Carbide C/C++</a> perspective by selecting <b>Window > Show view > Other...</b>, then expand the Debug folder and select Modules. In the <a href="perspective_debug.htm">Debug</a> perspective select <b>Window > Show view > Modules</b>.</p>
-<p>The Modules view is only loaded during a debug session and closes when the debug session ends. Select the running man icon to list the Type, Symbols, and Symbols file for the executable. Select the stack of books icon to list the Type, Symbols, Symbols file, and Base address for the shared library. </p>
-<p>Figure 1 shows the Modules view.</p>
-<p align="center"><img src="../images/views/view_module.png" width="595" height="181" /></p>
-<p class="figure">Figure 1 - Modules view</p>
-<h5>Related reference </h5>
-<ul>
- <li> <a href="view_debug.htm">Debug view</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Modules View</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Modules View</h2>
+<p>The <b>Modules</b> view displays a list of modules loaded while debugging your program. The listed modules can be selected to show related information. You can open the Modules view in the <a href="../concepts/CarbidePerspective.html">Carbide C/C++</a> perspective by selecting <b>Window > Show view > Other...</b>, then expand the Debug folder and select Modules. In the <a href="perspective_debug.htm">Debug</a> perspective select <b>Window > Show view > Modules</b>.</p>
+<p>The Modules view is only loaded during a debug session and closes when the debug session ends. Select the running man icon to list the Type, Symbols, and Symbols file for the executable. Select the stack of books icon to list the Type, Symbols, Symbols file, and Base address for the shared library. </p>
+<p>Figure 1 shows the Modules view.</p>
+<p align="center"><img src="../images/views/view_module.png" width="595" height="181" /></p>
+<p class="figure">Figure 1 - Modules view</p>
+<h5>Related reference </h5>
+<ul>
+ <li> <a href="../debugger/debug/viewing_debug.htm">Debug view</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_signals_wnd.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_signals_wnd.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,49 +1,49 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Signals View</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Signals View</h2>
-<p> The Signals view of the Debug perspective lets you view the signals defined on the selected debug target and how the debugger handles each one.</p>
-<p class="note"><b>NOTE</b> Currently Carbide.c++ does not support this CDT feature.</p>
-<p> </p>
-<p>Figure 1 shows the Signals view.</p>
-<p align="center"><img src="../images/views/view_signals.png" width="500" height="205" /></p>
-<p class="figure">Figure 1 - Signals view</p>
-<h5>Table 1 Signals view—items </h5>
-<table width="100%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="36%" scope="col">Item</th>
- <th width="64%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td>Name</td>
- <td>Displays the name of the signal.</td>
- </tr>
- <tr>
- <td>Pass</td>
- <td>Where "yes" is displayed, the debugger lets your program see the signal. Your program can handle the signal, or else it may terminate if the signal is fatal and not handled.</td>
- </tr>
- <tr>
- <td>Suspend</td>
- <td>Where "yes" is displayed, the debugger suspends your program when this signal is handled.</td>
- </tr>
- <tr>
- <td>Description</td>
- <td>Displays a description of the signal.</td>
- </tr>
-</table>
-<p> </p>
-<h5>Related reference </h5>
-<ul>
- <li> <a href="view_debug.htm">Debug view</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Signals View</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Signals View</h2>
+<p> The Signals view of the Debug perspective lets you view the signals defined on the selected debug target and how the debugger handles each one.</p>
+<p class="note"><b>NOTE</b> Currently Carbide.c++ does not support this CDT feature.</p>
+<p> </p>
+<p>Figure 1 shows the Signals view.</p>
+<p align="center"><img src="../images/views/view_signals.png" width="500" height="205" /></p>
+<p class="figure">Figure 1 - Signals view</p>
+<h5>Table 1 Signals view—items </h5>
+<table width="100%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="36%" scope="col">Item</th>
+ <th width="64%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td>Name</td>
+ <td>Displays the name of the signal.</td>
+ </tr>
+ <tr>
+ <td>Pass</td>
+ <td>Where "yes" is displayed, the debugger lets your program see the signal. Your program can handle the signal, or else it may terminate if the signal is fatal and not handled.</td>
+ </tr>
+ <tr>
+ <td>Suspend</td>
+ <td>Where "yes" is displayed, the debugger suspends your program when this signal is handled.</td>
+ </tr>
+ <tr>
+ <td>Description</td>
+ <td>Displays a description of the signal.</td>
+ </tr>
+</table>
+<p> </p>
+<h5>Related reference </h5>
+<ul>
+ <li> <a href="../debugger/debug/viewing_debug.htm">Debug view</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_sym_proj_nav.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_sym_proj_nav.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,52 +1,52 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Symbian Project Navigator view</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Symbian Project Navigator view</h2>
-<p>The <img src="../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=com.nokia.carbide.cpp.project.ui.views.SymbianProjectNavigatorView)")'>Symbian Project Navigator</a> view shows all files that belong to the
-current build configuration. This view lists the Symbian projects in your current workspace and their corresponding *.inf file (typically bld.inf). The *.inf file contains the related MMP project files, which are also listed in a tree structure. You can collapse or expand the list for each MMP to see which sources belong to each MMP.</p>
-<p>To open this view select <b>Window > Show View > Symbian Project Navigator</b>, or select <b>Window > Show View > Other ...</b> and expand the Carbide.c++ folder then choose Symbian Project Navigator. </p>
-<p>Figure 1 shows the Symbian Project Navigator view.</p>
-<p align="center"><img src="images/view_sym_proj_nav.png" width="279" height="404" alt=""/></p>
-<p class="figure">Figure 1 - Symbian Project Navigator view</p>
-<h5>Table 1. Symbian Project Navigator view —shortcut menu</h5>
-<table width="88%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="30%" scope="col">Item</th>
- <th width="9%" scope="col">Icon</th>
- <th width="61%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Toggle SOURCEPATH </b></td>
- <td><div align="center"><img src="images/icon_sourcepath_filter.png" width="18" height="15"></div></td>
- <td>Toggles the display between showing the <span class="code">SOURCEPATH</span> folders contained in the MMP file and showing the <span class="code">Bld.inf</span> structure. </td>
- </tr>
- <tr>
- <td><b>Toggle MMPs</b></td>
- <td><div align="center"><img src="images/icon_mmp_filter.png" width="20" height="17"></div></td>
- <td>Toggle the display to show all MMP files or the MMP files associated with the current build configuration. </td>
- </tr>
- <tr>
- <td><b>Toggle MMP Order</b></td>
- <td><center>
- <img src="images/icon_svn_mmp_order.png" width="21" height="20">
- </center>
- </td>
- <td>Toggle to show the MMPs list in alphabetical or build order. The default setting is build order.</td>
- </tr>
-</table>
-<h5>Related references</h5>
-<ul><li><a href="view_symbian_kernel.htm">Symbian OS View</a></li>
- <li><a href="view_debug.htm">Debug View</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Symbian Project Navigator view</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Symbian Project Navigator view</h2>
+<p>The <img src="../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=com.nokia.carbide.cpp.project.ui.views.SymbianProjectNavigatorView)")'>Symbian Project Navigator</a> view shows all files that belong to the
+current build configuration. This view lists the Symbian projects in your current workspace and their corresponding *.inf file (typically bld.inf). The *.inf file contains the related MMP project files, which are also listed in a tree structure. You can collapse or expand the list for each MMP to see which sources belong to each MMP.</p>
+<p>To open this view select <b>Window > Show View > Symbian Project Navigator</b>, or select <b>Window > Show View > Other ...</b> and expand the Carbide.c++ folder then choose Symbian Project Navigator. </p>
+<p>Figure 1 shows the Symbian Project Navigator view.</p>
+<p align="center"><img src="images/view_sym_proj_nav.png" width="279" height="404" alt=""/></p>
+<p class="figure">Figure 1 - Symbian Project Navigator view</p>
+<h5>Table 1. Symbian Project Navigator view —shortcut menu</h5>
+<table width="88%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="30%" scope="col">Item</th>
+ <th width="9%" scope="col">Icon</th>
+ <th width="61%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><b>Toggle SOURCEPATH </b></td>
+ <td><div align="center"><img src="images/icon_sourcepath_filter.png" width="18" height="15"></div></td>
+ <td>Toggles the display between showing the <span class="code">SOURCEPATH</span> folders contained in the MMP file and showing the <span class="code">Bld.inf</span> structure. </td>
+ </tr>
+ <tr>
+ <td><b>Toggle MMPs</b></td>
+ <td><div align="center"><img src="images/icon_mmp_filter.png" width="20" height="17"></div></td>
+ <td>Toggle the display to show all MMP files or the MMP files associated with the current build configuration. </td>
+ </tr>
+ <tr>
+ <td><b>Toggle MMP Order</b></td>
+ <td><center>
+ <img src="images/icon_svn_mmp_order.png" width="21" height="20">
+ </center>
+ </td>
+ <td>Toggle to show the MMPs list in alphabetical or build order. The default setting is build order.</td>
+ </tr>
+</table>
+<h5>Related references</h5>
+<ul><li><a href="view_symbian_kernel.htm">Symbian OS View</a></li>
+ <li><a href="../debugger/debug/viewing_debug.htm">Debug View</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/view_symbian_kernel.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_symbian_kernel.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,114 +1,114 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Symbian OS Data</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Symbian OS Data view</h2>
-<p>The <img src="../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=com.nokia.carbide.cpp.debug.kernelaware.ui.SymbianOSView)")'>Symbian OS Data</a> view displays the processes and threads for the suspended debug session based on the selection in the <a href="view_debug.htm">Debug</a> view. Read-only data is displayed for ARM build configurations. To open the Symbian OS Data view select<b> Window > Show View > Symbian OS Data</b> when the <a href="perspective_debug.htm">Debug</a> perspective is visible or select <b>Window > Show View > Other...</b>, then expand the Carbide.c++ folder and select <b>Symbian OS Data</b> when the <a href="../concepts/CarbidePerspective.html">Carbide C/C++ perspective</a> is visible. Click <b>Ok</b> to display the Symbian OS Data window (Figure 1).</p>
-<p class="note"><b>NOTE</b> The Symbian OS Data view works with the debugger and will only display data during a live debug session. The Symbian OS Data view is not supported for emulator debugging, and will not show anything during emulator debug.</p>
-<p>The <b>Symbian OS Data</b> view reveals kernel data in the Symbian OS running on the device being debugged. The kernel data displayed is always that of the device with the currently selected thread or process in <a href="view_debug.htm">Debug</a> view. If you are debugging two devices at the same time, the content of the view will change when focus is switched from a thread on one device to a thread on another device. The kernel data includes more than just processes and threads. </p>
-<p>For the stop mode debugger and the crash debugger, all the data listed above is supported. For the Application and System TRK debuggers, the chunks and libraries views are not supported. The Symbian OS Data view is not supported for the emulator debugger and will show nothing during an emulator debug session. During a stop mode debug session or a TRK debug session, you are able to select a process or a thread in the Symbian OS Data view and attach the debugger to it for source level debugging if the binary is listed in the <a href="view_executables.htm">Executables</a> view. Binaries listed in the Executable view can be source level debugged. Binaries not listed in the Executables view can only be assembly code debugged in the <a href="view_disassembly.htm">Disassembly</a> view.</p>
-<p class="note"><b>NOTE</b> Any executable must be included in the <b>Executables</b> view before it can be debugged. </p>
-<p>When the <a href="wnd_debugger_prefs.htm">Time interval for auto-refreshing OS View</a> option is enabled (which is on by default except for crash debugger), the data in the Symbian OS Data view will be auto-refreshed. Note that "auto-refresh" has a different meaning in different debuggers. During a stop mode debug session, the view will refresh data whenever the debugged program on the device is stopped and shows data as stale (greyed out) when the program is running. During a TRK debug session, the View will refresh data at a time interval regardless of whether the debugged program is stopped or not. The time interval is specified by an option in the Carbide.c++ global preference panel, which is five seconds by default.</p>
-<p>When auto-refresh is turned off, the debugger will not automatically refresh data in the View and will show the data as stale (greyed out). However you can manually refresh the data by clicking on the "Refresh" button in the View. Usually you may want to turn off the auto-refresh if you think it is slowing down your debug operations such as stepping.</p>
-<h3>Symbian OS Data pages
-</h3>
-<p>The Symbian OS Data view consists of five tabs. Each tabbed pane is described below. In all panes, the <b>Name Filter</b> field is a standard Eclipse UI control that allows you to find an item by filtering out items by name using wildcards (*, ?) and camel case naming conventions. Camel case refers to using mixed case multiple names merged together in coding like <span class="code">SecInvInit</span> and <span class="code">DosServer</span>. In all panes, you can select an item and view its properties (attributes). In panes with columns you can click a column title to toggle between ascending and descending sorting. </p>
-<p>Data to be viewed includes:</p>
-<ul>
- <li><a href="#overview">Overview</a></li>
- <li><a href="#processes">Processes</a></li>
- <li><a href="#threads">Threads</a></li>
- <li><a href="#chunks">Chunks</a></li>
- <li><a href="#Library">Libraries</a></li>
-</ul>
-<p class="note"><b>NOTE</b> Information for the Chunks and Libraries tabs is not available when debugging with the TRK debug agent.</p>
-<p align="center"><img src="images/view_symbianOSkernel.png" width="602" height="300" alt="" /></p>
-<p class="figure">Figure 1. Symbian OS Data view</p>
-<h5>Table 1 - Symbian OS Data view toolbar buttons </h5>
-<table cellpadding="2" cellspacing="0"
-border="0">
- <tr valign="top">
- <th width="209" class="Cell">Button</th>
- <th width="49" class="Cell">Icon</th>
- <th width="534" class="Cell">Function</th>
- </tr>
- <tr valign="top">
- <td class="Cell"><p> <b>Refresh data</b></p></td>
- <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_refresh.png" width="19" height="19" alt="" /></div></td>
- <td class="Cell"><p> Click this button to force a refresh of data in the view. Use the <a href="wnd_debugger_prefs.htm">Carbide.c++ Debugger</a> preference panel <b>Time interval for auto-refreshing OS View</b> option to control the automatic refreshing of data. </p></td>
- </tr>
- <tr valign="top">
- <td class="Cell"><p> <b>Enable/disable auto-refresh</b> </p></td>
- <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_autorefresh.png" width="19" height="21" alt="" /></div></td>
- <td class="Cell"><p> Click this button to turn on/off auto refresh of data.</p></td>
- </tr>
- <tr valign="top">
- <td class="Cell"><p> <b>Debug process or thread</b> </p></td>
- <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_debug.png" width="22" height="20" alt="" /></div></td>
- <td class="Cell"><p> Click the <b>Debug</b> button to attach to the process and debug the selected process or thread. Or right-click an item and choose <b>Debug</b>. This applys to both TRK (run mode) and Sophia/Trace32 (stop mode).</p>
- </td>
- </tr>
- <tr valign="top">
- <td class="Cell"><p> <b>Properties</b> </p></td>
- <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_prop.png" width="21" height="18" alt="" /></div></td>
- <td class="Cell"><p>Click this button to show properties of currently selected item in the <b>Properties</b> view. Or right-click an item and choose <b>Properties</b>.</p></td>
- </tr>
- <tr valign="top">
- <td class="Cell"><p> <b>Timer</b></p></td>
- <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_timer.png" width="21" height="18" alt="" /></div></td>
- <td class="Cell"><p> Click this button to define the time interval for auto-refreshing data. This applies to run mode debugging only. </p></td>
- </tr>
- <tr valign="top">
- <td class="Cell"><b>Collapse All </b></td>
- <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_collapse.png" width="17" height="17" alt="" /></div></td>
- <td class="Cell">Click the <b>Collaps All</b> command to collapse all of the currently elements in the view.</td>
- </tr>
-</table>
-<h4><a name="overview" id="overview"></a>Overview Tab</h4>
-<p>This tab (shown in Figure 1) provides a tree view of ownership of all processes, threads, and chunks in the OS.
-In contrast, the other tabs provide a flat list of corresponding kernel objects such as process, thread, chunk, library, etc.</p>
-<h4><a name="processes" id="processes"></a>Processes</h4>
-<p>The Processes tab (Figure 2) provides a flat list of corresponding kernel objects.
-Click a column title to sort the list by the title attribute in alternating ascending and descending order. For example, you may choose to sort the process list by Name, ID, or by Priority. </p>
-<p align="center"><img src="images/view_symbianOS_PTC.png" width="602" height="291" alt="" /></p>
-<p class="figure">Figure 2. Processes Pane of Symbian OS View</p>
-<p>The process(es) being debugged will be shown in bold font. You can debug (attach debugger to) any process in the Processes tab by selecting it and clicking the "Debug" button or just by double clicking on it. In that case a new process item will show up in the Debug View if the process is not being debugged. Otherwise, you will get a message saying it's already under debug.</p>
-<h4><a name="threads" id="threads"></a>Threads</h4>
-<p>The Threads tab (Figure 3) provides a flat list of corresponding kernel objects. The list will display “sortable” attributes of that type of object in columns. The “sortable attribute” means you can sort the list by that attribute. For example, you may want to sort the list by the owning process name. Sort the list of any column by clicking on the column header. The thread(s) being debugged will be shown in bold font.</p>
-<p class="note"><b>NOTE</b> You can debug (attach debugger to) any thread in the Thread tab by double clicking on it or selecting it and clicking the Debug button. In that case, a new thread item will show up in Debug view if the thread is not being debugged.</p>
-<p align="center"><img src="images/view_symbianOS_threads.png" width="602" height="291" alt="" /></p>
-<p class="figure">Figure 3. Threads Pane of Symbian OS View</p>
-<h4><a name="chunks" id="chunks"></a>Chunks</h4>
-<p>Chunks are an area of contiguous linear memory. It is the unit of memory allocation where a region of RAM is mapped into contiguous logical addresses. Chunks are allocated during boot for such things as the Kernel's data and stack.</p>
-<p>The Chunks tab (Figure 4) provides a flat list of corresponding kernel objects. The list will display “sortable” attributes of that type of object in columns. The “sortable attribute” means you can sort the list by that attribute. For example, you may want to sort the list by the owning process name. Sort the list of any column by clicking on the column header.</p>
-<p class="note"> <b>NOTE</b> Chunks data is not available during TRK debugging.</p>
-<p align="center"><img src="images/view_symbianOS_chunks.png" width="530" height="278" alt="" /></p>
-<p class="figure">Figure 4. Chunks Pane of Symbian OS View</p>
-<h4><a name="Library" id="Library"></a>Libraries Tab</h4>
-<p> The Libraries pane (Figure 5) in the Symbian OS view provides information on libraries in the Symbian OS residing on the target.</p>
-<p class="note"> <b>NOTE</b> Library data is not available during TRK debugging.</p>
-<p align="center"><img src="images/view_symbianOS_Lib.png" width="531" height="278" alt="" /></p>
-<p class="figure">Figure 5. Libraries Pane of Symbian OS View</p>
-<h3><a name="attach" id="attach"></a>Attaching to a Process</h3>
-<p>If <span class="note">you double click on a thread item in the Thread tab, or right-click and choose <b>Debug</b>, the owning process of the thread will be attached.</span> The thread with an attached process will appear in bold. You can also select a thread and click the bug icon in the Symbian OS Data toolbar. You can also view properties for the attached process by clicking the "Show properties of the selected item" icon () in the Symbian OS Data toolbar or right-click the thread and choose <b>Properties</b>.</p>
-<p class="note"><b>NOTE </b>If an executable is not part of a project in the workspace use the Executables view to import an executable to make it visible to the debugger. Once included in the Executables list, the symbolics for that executable can be loaded and breakpoints resolved and hit. Open a source file in an editor view or use the <a href="view_breakpoints.htm">Breakpoints</a> view to verify that the executable breakpoints have been <a href="../concepts/breakpoints.htm">resolved</a>. </p>
-<p class="note"><b>IMPORTANT</b> In stop mode debugging when debugging multiple processes at the same time, selecting a process in the <a href="view_debug.htm">Debug</a> pane and clicking <b>Terminate</b> disconnects the attached process on the board, leaving all other processes running. It does not terminate the debug session. However, if there is only one debug process when you click <b>Terminate</b> the CPU is suspended until the next debug session.</p>
-<p class="note"><b>WARNING</b> Detaching from a system process or any process not initiated by the program you are attempting to debug may cause the device to stop working, forcing a restart of the device. </p>
-<p><img src="images/symOSData_attachprocess.png" width="1144" height="332" alt="" /></p>
-<h5>Other references</h5>
-<ul>
- <li><a href="view_debug.htm">Debug view</a></li>
- <li><a href="../tasks/debugger/view_symbian_kernel_set.htm">Setting Symbian OS View Refresh Rate</a><br />
- </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Symbian OS Data</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Symbian OS Data view</h2>
+<p>The <img src="../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=com.nokia.carbide.cpp.debug.kernelaware.ui.SymbianOSView)")'>Symbian OS Data</a> view displays the processes and threads for the suspended debug session based on the selection in the <a href="../debugger/debug/viewing_debug.htm">Debug</a> view. Read-only data is displayed for ARM build configurations. To open the Symbian OS Data view select<b> Window > Show View > Symbian OS Data</b> when the <a href="perspective_debug.htm">Debug</a> perspective is visible or select <b>Window > Show View > Other...</b>, then expand the Carbide.c++ folder and select <b>Symbian OS Data</b> when the <a href="../concepts/CarbidePerspective.html">Carbide C/C++ perspective</a> is visible. Click <b>Ok</b> to display the Symbian OS Data window (Figure 1).</p>
+<p class="note"><b>NOTE</b> The Symbian OS Data view works with the debugger and will only display data during a live debug session. The Symbian OS Data view is not supported for emulator debugging, and will not show anything during emulator debug.</p>
+<p>The <b>Symbian OS Data</b> view reveals kernel data in the Symbian OS running on the device being debugged. The kernel data displayed is always that of the device with the currently selected thread or process in <a href="../debugger/debug/viewing_debug.htm">Debug</a> view. If you are debugging two devices at the same time, the content of the view will change when focus is switched from a thread on one device to a thread on another device. The kernel data includes more than just processes and threads. </p>
+<p>For the stop mode debugger and the crash debugger, all the data listed above is supported. For the Application and System TRK debuggers, the chunks and libraries views are not supported. The Symbian OS Data view is not supported for the emulator debugger and will show nothing during an emulator debug session. During a stop mode debug session or a TRK debug session, you are able to select a process or a thread in the Symbian OS Data view and attach the debugger to it for source level debugging if the binary is listed in the <a href="view_executables.htm">Executables</a> view. Binaries listed in the Executable view can be source level debugged. Binaries not listed in the Executables view can only be assembly code debugged in the <a href="view_disassembly.htm">Disassembly</a> view.</p>
+<p class="note"><b>NOTE</b> Any executable must be included in the <b>Executables</b> view before it can be debugged. </p>
+<p>When the <a href="wnd_debugger_prefs.htm">Time interval for auto-refreshing OS View</a> option is enabled (which is on by default except for crash debugger), the data in the Symbian OS Data view will be auto-refreshed. Note that "auto-refresh" has a different meaning in different debuggers. During a stop mode debug session, the view will refresh data whenever the debugged program on the device is stopped and shows data as stale (greyed out) when the program is running. During a TRK debug session, the View will refresh data at a time interval regardless of whether the debugged program is stopped or not. The time interval is specified by an option in the Carbide.c++ global preference panel, which is five seconds by default.</p>
+<p>When auto-refresh is turned off, the debugger will not automatically refresh data in the View and will show the data as stale (greyed out). However you can manually refresh the data by clicking on the "Refresh" button in the View. Usually you may want to turn off the auto-refresh if you think it is slowing down your debug operations such as stepping.</p>
+<h3>Symbian OS Data pages
+</h3>
+<p>The Symbian OS Data view consists of five tabs. Each tabbed pane is described below. In all panes, the <b>Name Filter</b> field is a standard Eclipse UI control that allows you to find an item by filtering out items by name using wildcards (*, ?) and camel case naming conventions. Camel case refers to using mixed case multiple names merged together in coding like <span class="code">SecInvInit</span> and <span class="code">DosServer</span>. In all panes, you can select an item and view its properties (attributes). In panes with columns you can click a column title to toggle between ascending and descending sorting. </p>
+<p>Data to be viewed includes:</p>
+<ul>
+ <li><a href="#overview">Overview</a></li>
+ <li><a href="#processes">Processes</a></li>
+ <li><a href="#threads">Threads</a></li>
+ <li><a href="#chunks">Chunks</a></li>
+ <li><a href="#Library">Libraries</a></li>
+</ul>
+<p class="note"><b>NOTE</b> Information for the Chunks and Libraries tabs is not available when debugging with the TRK debug agent.</p>
+<p align="center"><img src="images/view_symbianOSkernel.png" width="602" height="300" alt="" /></p>
+<p class="figure">Figure 1. Symbian OS Data view</p>
+<h5>Table 1 - Symbian OS Data view toolbar buttons </h5>
+<table cellpadding="2" cellspacing="0"
+border="0">
+ <tr valign="top">
+ <th width="209" class="Cell">Button</th>
+ <th width="49" class="Cell">Icon</th>
+ <th width="534" class="Cell">Function</th>
+ </tr>
+ <tr valign="top">
+ <td class="Cell"><p> <b>Refresh data</b></p></td>
+ <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_refresh.png" width="19" height="19" alt="" /></div></td>
+ <td class="Cell"><p> Click this button to force a refresh of data in the view. Use the <a href="wnd_debugger_prefs.htm">Carbide.c++ Debugger</a> preference panel <b>Time interval for auto-refreshing OS View</b> option to control the automatic refreshing of data. </p></td>
+ </tr>
+ <tr valign="top">
+ <td class="Cell"><p> <b>Enable/disable auto-refresh</b> </p></td>
+ <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_autorefresh.png" width="19" height="21" alt="" /></div></td>
+ <td class="Cell"><p> Click this button to turn on/off auto refresh of data.</p></td>
+ </tr>
+ <tr valign="top">
+ <td class="Cell"><p> <b>Debug process or thread</b> </p></td>
+ <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_debug.png" width="22" height="20" alt="" /></div></td>
+ <td class="Cell"><p> Click the <b>Debug</b> button to attach to the process and debug the selected process or thread. Or right-click an item and choose <b>Debug</b>. This applys to both TRK (run mode) and Sophia/Trace32 (stop mode).</p>
+ </td>
+ </tr>
+ <tr valign="top">
+ <td class="Cell"><p> <b>Properties</b> </p></td>
+ <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_prop.png" width="21" height="18" alt="" /></div></td>
+ <td class="Cell"><p>Click this button to show properties of currently selected item in the <b>Properties</b> view. Or right-click an item and choose <b>Properties</b>.</p></td>
+ </tr>
+ <tr valign="top">
+ <td class="Cell"><p> <b>Timer</b></p></td>
+ <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_timer.png" width="21" height="18" alt="" /></div></td>
+ <td class="Cell"><p> Click this button to define the time interval for auto-refreshing data. This applies to run mode debugging only. </p></td>
+ </tr>
+ <tr valign="top">
+ <td class="Cell"><b>Collapse All </b></td>
+ <td class="Cell"><div align="center"><img src="images/view_symbianOSbtn_collapse.png" width="17" height="17" alt="" /></div></td>
+ <td class="Cell">Click the <b>Collaps All</b> command to collapse all of the currently elements in the view.</td>
+ </tr>
+</table>
+<h4><a name="overview" id="overview"></a>Overview Tab</h4>
+<p>This tab (shown in Figure 1) provides a tree view of ownership of all processes, threads, and chunks in the OS.
+In contrast, the other tabs provide a flat list of corresponding kernel objects such as process, thread, chunk, library, etc.</p>
+<h4><a name="processes" id="processes"></a>Processes</h4>
+<p>The Processes tab (Figure 2) provides a flat list of corresponding kernel objects.
+Click a column title to sort the list by the title attribute in alternating ascending and descending order. For example, you may choose to sort the process list by Name, ID, or by Priority. </p>
+<p align="center"><img src="images/view_symbianOS_PTC.png" width="602" height="291" alt="" /></p>
+<p class="figure">Figure 2. Processes Pane of Symbian OS View</p>
+<p>The process(es) being debugged will be shown in bold font. You can debug (attach debugger to) any process in the Processes tab by selecting it and clicking the "Debug" button or just by double clicking on it. In that case a new process item will show up in the Debug View if the process is not being debugged. Otherwise, you will get a message saying it's already under debug.</p>
+<h4><a name="threads" id="threads"></a>Threads</h4>
+<p>The Threads tab (Figure 3) provides a flat list of corresponding kernel objects. The list will display “sortable” attributes of that type of object in columns. The “sortable attribute” means you can sort the list by that attribute. For example, you may want to sort the list by the owning process name. Sort the list of any column by clicking on the column header. The thread(s) being debugged will be shown in bold font.</p>
+<p class="note"><b>NOTE</b> You can debug (attach debugger to) any thread in the Thread tab by double clicking on it or selecting it and clicking the Debug button. In that case, a new thread item will show up in Debug view if the thread is not being debugged.</p>
+<p align="center"><img src="images/view_symbianOS_threads.png" width="602" height="291" alt="" /></p>
+<p class="figure">Figure 3. Threads Pane of Symbian OS View</p>
+<h4><a name="chunks" id="chunks"></a>Chunks</h4>
+<p>Chunks are an area of contiguous linear memory. It is the unit of memory allocation where a region of RAM is mapped into contiguous logical addresses. Chunks are allocated during boot for such things as the Kernel's data and stack.</p>
+<p>The Chunks tab (Figure 4) provides a flat list of corresponding kernel objects. The list will display “sortable” attributes of that type of object in columns. The “sortable attribute” means you can sort the list by that attribute. For example, you may want to sort the list by the owning process name. Sort the list of any column by clicking on the column header.</p>
+<p class="note"> <b>NOTE</b> Chunks data is not available during TRK debugging.</p>
+<p align="center"><img src="images/view_symbianOS_chunks.png" width="530" height="278" alt="" /></p>
+<p class="figure">Figure 4. Chunks Pane of Symbian OS View</p>
+<h4><a name="Library" id="Library"></a>Libraries Tab</h4>
+<p> The Libraries pane (Figure 5) in the Symbian OS view provides information on libraries in the Symbian OS residing on the target.</p>
+<p class="note"> <b>NOTE</b> Library data is not available during TRK debugging.</p>
+<p align="center"><img src="images/view_symbianOS_Lib.png" width="531" height="278" alt="" /></p>
+<p class="figure">Figure 5. Libraries Pane of Symbian OS View</p>
+<h3><a name="attach" id="attach"></a>Attaching to a Process</h3>
+<p>If <span class="note">you double click on a thread item in the Thread tab, or right-click and choose <b>Debug</b>, the owning process of the thread will be attached.</span> The thread with an attached process will appear in bold. You can also select a thread and click the bug icon in the Symbian OS Data toolbar. You can also view properties for the attached process by clicking the "Show properties of the selected item" icon () in the Symbian OS Data toolbar or right-click the thread and choose <b>Properties</b>.</p>
+<p class="note"><b>NOTE </b>If an executable is not part of a project in the workspace use the Executables view to import an executable to make it visible to the debugger. Once included in the Executables list, the symbolics for that executable can be loaded and breakpoints resolved and hit. Open a source file in an editor view or use the <a href="view_breakpoints.htm">Breakpoints</a> view to verify that the executable breakpoints have been <a href="../concepts/breakpoints.htm">resolved</a>. </p>
+<p class="note"><b>IMPORTANT</b> In stop mode debugging when debugging multiple processes at the same time, selecting a process in the <a href="../debugger/debug/viewing_debug.htm">Debug</a> pane and clicking <b>Terminate</b> disconnects the attached process on the board, leaving all other processes running. It does not terminate the debug session. However, if there is only one debug process when you click <b>Terminate</b> the CPU is suspended until the next debug session.</p>
+<p class="note"><b>WARNING</b> Detaching from a system process or any process not initiated by the program you are attempting to debug may cause the device to stop working, forcing a restart of the device. </p>
+<p><img src="images/symOSData_attachprocess.png" width="1144" height="332" alt="" /></p>
+<h5>Other references</h5>
+<ul>
+ <li><a href="../debugger/debug/viewing_debug.htm">Debug view</a></li>
+ <li><a href="../tasks/debugger/view_symbian_kernel_set.htm">Setting Symbian OS View Refresh Rate</a><br />
+ </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/wnd_Trace32_config.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,297 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Trace32 Support</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Symbian OS Trace32 Support</h2>
-<p>After installing all necessary software such as Perl, JTAG, compilers, Devkits and SDKs and creating your project, you will need to define a Debug launch configuration for your project. For this example, we will define a Trace32 launch configuration. For new projects that do not have a launch configuration, a New Launch Configuration Wizard will appear and allow you to define settings.</p>
-<p><a href="../projects/launch/launch_configs_overview.htm">Launch configurations</a> define a collection of settings used to tell the debugger how to start a debug session. The launch configuration panes for creating a Trace32 stop mode debug launch configuration are described below. Figure 1 is an example of the Trace32 Debug launch configuration window and the related panes accessible in a tabbed format. Click <b>Debug</b> after all the preference panels have been set. The Debug window closes and the Carbide.c++ debugger begins a debugging session using the new configuration. The next time you click the Debug icon, this debug launch configuration is used to start a debug session.</p>
-<div class="step">
- <h4>To open the Debug window </h4>
- <ul>
- <li>Select the Project in the C/C++ Project view that you want to debug</li>
- <li>Select the Run > Debug... menu item to display the Debug launch configuration window (figure 1) </li>
- <li>Define a debug launch configuration to communicate with the protocol interface</li>
- </ul>
-</div>
-<p>The panes include: </p>
-<ul>
- <li>The <a href="#Main">Main</a> tab (Figure 1) defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
- <li>The <a href="#Connection">Connection</a> tab (Figure 2) defines the Trace32 executable, configuration file and initialization script.</li>
- <li>The <a href="#Debugger">Debugger</a> tab (Figure3) defines debug configurations, such as entry point to begin debugging and target options.</li>
- <li>The <a href="#ROM">ROM Image</a> tab (Figure 4) allows you to define startup options and ROM image download information.</li>
- <li>The <a href="#Executables">Executables</a> tab (Figure 5) allows you to specify which executables that you want to debug that are part of the project.</li>
- <li>The <a href="#Source">Source</a> tab (Figure 6) (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="#Common">Common</a> tab (Figure 7) (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
-</ul>
-<h2>Main<a name="Main" id="Main"></a></h2>
-<p align="center"><img src="images/panel_debug_T32_main.png" width="560" height="254" /></p>
-<p class="figure">Figure 1 - Trace32 Launch Configuration Settings - Main Tab</p>
-<h5>Table 1. Debug Launch configuration window—Main tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Project</b></td>
- <td>The project to associate with this debug launch configuration. Click Browse to select a different project. </td>
- </tr>
- <tr>
- <td><b>Executable</b></td>
- <td><span
- style="font-weight: normal;">This is the name of the executable that is linked to the project. </span>Click <b>Browse</b> to select a different executable. </td>
- </tr>
-</table>
-<h2>Connection<a name="Connection" id="Connection"></a></h2>
-<p align="center"><img src="images/panel_debug_T32_connection.png" width="732" height="246" /></p>
-<p class="figure">Figure 2 - Trace32 Launch Configuration Settings - Connection Tab</p>
-<h5>Table 2. Launch configuration window—Connection tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Trace32 Executable </b></td>
- <td>Enter or browse to the Trace32 executable to be launched for debugging. By default, it will be set to <span class="code">c:\t32\t32marm.exe</span>. The default installation path is <span class="code">c:\t32</span>.</td>
- </tr>
- <tr>
- <td><b>Trace32 Configuration File </b></td>
- <td><p>Enter or browse to the Trace32 Configuration File. The default configuration file is a Carbide specific T32 config file (config_carbide.t32). Default location is </p>
- <p><span class="code">C:\Program Files\Nokia\Carbide.c++ v2.0.x\plugins\com.nokia.carbide.cpp.support_<br>
- <<em>version</em>>\Symbian_Support\Trace32\</span></p>
- <p>You can modify the <span class="code">config_carbide.t32</span> file to support UDP (User Datagram Protocol) connections by adding the following lines: <br />
-<br />
-RCL=NETASSIST<br />
-PACKLEN=1024<br />
-PORT=20000</p></td>
- </tr>
- <tr>
- <td><b>Trace32 Initialization Script </b></td>
- <td><p>Enter or browse to the Trace32 initialization cmm script file. This script will be run in Trace32 after connecting to Trace32. Users are expected to have their own scripts for the targets they are using. The cmm files are provided here for H2 and H4 boards:</p>
- <p><span class="code">C:\Program Files\Nokia\Carbide.c++ v2.0.x\plugins\com.nokia.carbide.cpp.support_<br>
- <<em>version></em>>\Symbian_Support\Trace32\cmm_scripts\H2 & H4</span></p></td>
- </tr>
- <tr>
- <td><b>View Messages between Carbide and Trace32 </b></td>
- <td>The View Messages between Carbide and Trace32 check box allows you to specify whether or not the debug protocol messages between Carbide and T32 should be logged in a T32 Communication Log console window.</td>
- </tr>
-</table>
-<h2>Debugger<a name="Debugger" id="Debugger"></a></h2>
-<p align="center"><img src="images/panel_debug_T32_debugger.png" width="593" height="403" /></p>
-<p class="figure">Figure 3 - Trace32 Launch Configuration Settings - Debugger Tab</p>
-<h5>Table 3. Launch configuration window—Debugger tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Break at entry point </b></td>
- <td>Select the check box and specify an entry point in the text box if you want the debugger to break at an entry point in the program being debugged. The default is set to E32Main since most applications entry point is E32Main. But you can specify a function name in the program being debugged.</td>
- </tr>
- <tr>
- <td><b>Soft attach </b></td>
- <td>Select to attach to a target without restarting the target device. This is very handy when the device uses flash, memory cards, or other external media for booting purposes and when it's not possible to configure the device to restart by the debugger. With soft attach, the debugger doesn't change the state of the target device. The debugger halts the target after attaching to the target to show the current PC location. User can preform normal debugging operations from then onwards. </td>
- </tr>
- <tr>
- <td><b>Debug from start address</b></td>
- <td>Select this option to stop the target at the start address once the target initialization is done and the OS is downloaded; if you have chosen to download the OS.</td>
- </tr>
- <tr>
- <td><b>Run from start address </b></td>
- <td><p>Select this option to run the target from the start address once the target initialization is done.</p></td>
- </tr>
- <tr>
- <td><b>Start Address (hex) </b></td>
- <td>Specify the memory address that the Carbide debugger will use to set the program counter to start the target. This is typically the start address of the Symbian OS.</td>
- </tr>
- <tr>
- <td><b>Reset target at the start of each debug session </b></td>
- <td><p>Select this check box to reset the target at the start of each debug session. For Trace32, the reset is typically done as part of the CMM script file.</p>
- <p>Consult board specifications to determine if resetting is necessary.</p></td>
- </tr>
- <tr>
- <td><b>Target Processor </b></td>
- <td>Select a target processor from the drop down list of all supported processors. By default the field is set to Generic. When you select a processor, Carbide determines whether the debugger provides ARMV5 or ARMV6 support.</td>
- </tr>
- <tr>
- <td><b>Target Initialization File</b></td>
- <td><p>Select the check box and enter or browse to the target initialization file. Typically, this initialization file is used to initialize the target after connecting. When using Trace32, the initialization is done in the CMM script file.</p></td>
- </tr>
- <tr>
- <td><b>Memory Configuration File </b></td>
- <td>Select the check box and enter or browse to the memory configuration file. The Carbide debugger uses this configuration file to determine which memory is accessible, readable, and writable on the target.</td>
- </tr>
- <tr>
- <td><b>Default Instruction set </b></td>
- <td><p>The following options are available:</p>
- <ul>
- <li>Auto (examine code at current PC location) </li>
- <li>Arm (32 bit) </li>
- <li>Thumb (16 bit) </li>
- </ul>
- <p>Arm is the default. It is used by the debugger to determine the processor mode when it cannot be determined otherwise. This can happen at addresses for which there is no symbolic information. The debugger uses the mode when setting breakpoints and disassembling code.</p></td>
- </tr>
-</table>
-<h2>ROM Image<a name="ROM" id="ROM"></a></h2>
-<p align="center"><img src="images/panel_debug_T32_image.png" width="593" height="306" /></p>
-<p class="figure">Figure 4 - Trace32 Launch Configuration Settings - ROM Image Tab</p>
-<h5>Table 4. Launch configuration window—ROM Image tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Parse Rom Log File</b></td>
- <td>Check this option to parse the ROM log file. </td>
- </tr>
- <tr>
- <td><b>Symbian Rom Log File</b></td>
- <td>Enter or browse to the Rom log file that is generated when the Symbian OS image is built. This is necessary for debugging any Symbian OS module.</td>
- </tr>
- <tr>
- <td><b>Symbian Epoc32 Directory </b></td>
- <td><p>Enter or browse to the epoc32 directory for the Symbian OS kit that is being targeted for debugging. This is necessary for the debugger to resolve the full paths for each module in the log file since the log file does not contain the full paths.</p></td>
- </tr>
- <tr>
- <td><b>Log unresolved modules</b></td>
- <td>Check this option to log unresolved modules. If the actual binary in the log file doesn’t exist on the PC, then a warning message will be logged in a Rom Log console window.</td>
- </tr>
- <tr>
- <td><b>Debug non-XIP executables</b></td>
- <td>Check this option to target non-XIP executables. This allows the debugger to target a non-XIP module whenever it’s loaded.</td>
- </tr>
- <tr>
- <td><b>Download Rom Image </b></td>
- <td>Check this box to enable downloading. </td>
- </tr>
- <tr>
- <td><b>Symbian Rom Image</b></td>
- <td>Enter or browse to the Symbian OS image (.img file) that will be downloaded onto the target at the specified download address.</td>
- </tr>
- <tr>
- <td><b>Download Address (hex) </b></td>
- <td><p>Specify the address where the image is to be downloaded. This address is target-specific. The address should be in hexadecimal format with the 0x prefix.</p> </td>
- </tr>
- <tr>
- <td><b>Same as start address</b></td>
- <td>Check this option to make the download address the same as the start address.</td>
- </tr>
- <tr>
- <td><b>Ask for download at the start of each debug session</b></td>
- <td>Select this option to prompt you to download the image at the start of the debug session.</td>
- </tr>
-</table>
-<h2>Executables<a name="Executables" id="exe"></a></h2>
-<p>The <b>Executables</b> pane specifies which executables to debug with your project based on the chosen rule. The Executables pane gives you project level control over the executables associated with it. The pane shows all the executables in the workspace or those imported into the Executables view from outside the workspace that can be debugged by this project. See the <a href="../view_executables.htm">Executables</a> view for information on controlling executables from the workspace. </p>
-<p align="center"><img src="images/panel_trk_exes.png" width="558" height="279"></p>
-<p class="figure">Figure 5 - Trace32 Launch Configuration Settings - Executables Tab</p>
-<h5>Table 5. Executable pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Load symbols for these executables and target them for debugging </b></td>
- <td><p>Select the rule which govern the executable support used by this project for debugging purposes. The options include: </p>
- <ul>
- <li><b>Executables in the workspace from this SDK</b> — shows all executables in the workspace built using the specified SDK. This is the default setting. </li>
- <li><b>Executables built by this project</b> — shows only the executables built by this project using the specified SDK</li>
- <li><b>Executables selected below</b> — shows only the executables chosen by the user. Initial list display uses the All Executables listing. </li>
- <li><b>All executables (slows launch)</b> — shows all the executables in the workspace regardless of which SDK created them. Selecting this option will slow down Carbide launches as the list is populated. </li>
- </ul></td>
- </tr>
- <tr>
- <td><b>Executables list </b></td>
- <td>Shows all the executables associated with this project. </td>
- </tr>
- <tr>
- <td><b>Add...</b></td>
- <td>Opens the <b>Select an executable file</b> dialog which can locate and select executable files and add them to the project's executables list. </td>
- </tr>
- <tr>
- <td><b>Select All </b></td>
- <td>Enables all the executables in the list for debugging. </td>
- </tr>
- <tr>
- <td><b>Unselect All </b></td>
- <td>Disables all the executables in the list from debugging. </td>
- </tr>
-</table>
-<h2>Source<a name="Source" id="Source"></a></h2>
-<p align="center"><img src="images/panel_debug_source.png" width="550" height="299" /></p>
-<p class="figure">Figure 6 - Trace32 Launch Configuration Settings - Source Tab</p>
-<h5>Table 6. Launch configuration window—Source tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Source Lookup Path</b></td>
- <td>Allows you to add locations to search for source files. You can arrange the list by selecting the type of source path and clicking Up and Down buttons. Select a type of source and click Remove button to delete the item from the list.</td>
- </tr>
- <tr>
- <td><b>Search for duplicate source files on the path </b></td>
- <td>Enable this option to search for duplicate source files on source paths listed.</td>
- </tr>
-</table>
-<h2>Common<a name="Common" id="Common"></a></h2>
-<p align="center"><img src="images/panel_debug_common.png" width="556" height="330" /></p>
-<p class="figure">Figure 7 - Trace32 Launch Configuration Settings - Common Tab</p>
-<h5>Table 7. Launch configuration window—Common tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Save As </b></td>
- <td>Allows you to save the launch configuration as a file local to the project or as shared file. For a shared file you can enter or browse to a folder within an existing project directory.</td>
- </tr>
- <tr>
- <td><b>Display in favorites menu </b></td>
- <td>Select menu for launch configuration to appear.</td>
- </tr>
- <tr>
- <td><b>Console Encoding</b></td>
- <td>Select the character set to use to display information in the console window. </td>
- </tr>
- <tr>
- <td><b>Standard Input and Output</b> </td>
- <td>Allocate input and output to console and/or specified file. If a file is selected, you can select Append option to append data to selected file. </td>
- </tr>
- <tr>
- <td><b>Launch in background</b></td>
- <td>Enable this option to launch debug operation in a background process. </td>
- </tr>
-</table>
-<p> </p>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="../projects/launch/launch_configs_overview.htm">Launch Configurations</a></li>
- <li><a href="../concepts/debugger_about.htm">About the Debugger</a></li>
-</ul>
-<h5 align="left">Related tasks</h5>
-<ul>
- <li><a href="../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
-</ul>
-<h5 align="left">Related references</h5>
-<ul>
- <li><a href="wnd_sophia_config.htm">Symbian OS Sophia Target Interface Support</a></li>
- <li><a href="perspective_debug.htm">Debug Perspective</a></li>
- <li><a href="view_debug.htm">Debug View</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/wnd_debug_configuration.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/wnd_debug_configuration.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,80 +1,80 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debug Window</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debug Window</h2>
-<p>The <b>Debug</b> or launch configuration window provides C/C++ debugger options. A <a href="../projects/launch/launch_configs_overview.htm">launch configuration</a> defines the settings used by the Carbide debugger to launch and debug programs. A project must have at least one debug launch configuration in order to debug a project and can have many more. </p>
-<p>By default, Carbide creates a debug launch configuration the first time you launch the debugger based on current project settings. If additional information is required, like a port ID, the <a href="../tasks/projects/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> appears asking for the additional information. </p>
-<p>The tabs in the window vary depending upon the currently selected launch configuration.</p>
-<p align="center" class="figure"><img src="images/wnd_debug_overview.png" width="864" height="471"><br />
-Figure 1 - Debug or launch configuration window (Symbian OS emulation view)</p>
-<h5>Table 1. Debug window — common items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="7%" scope="col">Icon</th>
- <th width="41%" scope="col">Item</th>
- <th width="52%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><div align="center"><img src="images/icon_new_launch_config.png" width="16" height="17"></div></td>
- <td><b>New Launch Configuration</b></td>
- <td><p>Click the New Launch Configuration icon to add a launch configuration to the Configurations list. Default information based upon the project is automatically entered into the various text boxes.</p>
- <p class="note"><b>NOTE</b> Normally, you should not have to change any of the default text box entries unless you are creating multiple debug launch configurations for the same project.</p></td>
- </tr>
- <tr>
- <td><div align="center"><img src="images/icon_dup_launch_config.png" width="19" height="19"></div></td>
- <td><b>Duplicate</b></td>
- <td>Click the Duplicate icon to duplicate the currently selected launch configuration. </td>
- </tr>
- <tr>
- <td><div align="center"><img src="images/icon_delete_launch_config.png" width="17" height="16"></div></td>
- <td><b>Delete selected launch configuration(s) </b></td>
- <td>Click the Delete icon to remove the currently selected configuration from the Configurations list.</td>
- </tr>
- <tr>
- <td> </td>
- <td><b>Collapse</b></td>
- <td>Click the Collapse icon to collapse expanded lists of launch configurations.</td>
- </tr>
- <tr>
- <td><div align="center"><img src="images/icon_filter_launch_config.png" width="21" height="18"></div></td>
- <td><b>Filter launch configurations... </b></td>
- <td><p>Click the Filter icon to select filter options that control which launch configurations appear in the list. Filter options include:</p>
- <ul>
- <li>Filter Closed Projects</li>
- <li>Filter Deleted/Unavailable Projects</li>
- <li>Filter Configuration Types</li>
- <li>Apply Window Working Set(s)</li>
- <li><a href="trk/panel_filter.htm">Filtering Preferences...</a></li>
- </ul></td>
- </tr>
-</table>
-<div class="step">
- <h4>To open the Debug window </h4>
- <ul>
- <li>Select the Run > Open Debug Dialog... menu item</li>
- </ul>
- <ol>
- The Debug window (Figure 1) appears.</ol>
- <ul>
- <li>Select Run > Open Run Dialog... to open a Run window to create a launch configuration for a release build.</li>
- </ul>
-</div>
-<h5>Other references</h5>
-<ul>
- <li><a href="perspective_debug.htm">Debug Perspective</a></li>
- <li><a href="../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- <li><a href="launch_configs/emulator_overview.htm">Emulator overview</a></li>
- <li><a href="launch_configs/run_mode_overview.htm">Run-mode overview</a></li>
- <li><a href="launch_configs/stop_mode_overview.htm">Stop-mode overview</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Debug Window</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debug Window</h2>
+<p>The <b>Debug</b> or launch configuration window provides C/C++ debugger options. A <a href="../projects/launch/launch_configs_overview.htm">launch configuration</a> defines the settings used by the Carbide debugger to launch and debug programs. A project must have at least one debug launch configuration in order to debug a project and can have many more. </p>
+<p>By default, Carbide creates a debug launch configuration the first time you launch the debugger based on current project settings. If additional information is required, like a port ID, the <a href="../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> appears asking for the additional information. </p>
+<p>The tabs in the window vary depending upon the currently selected launch configuration.</p>
+<p align="center" class="figure"><img src="images/wnd_debug_overview.png" width="864" height="471"><br />
+Figure 1 - Debug or launch configuration window (Symbian OS emulation view)</p>
+<h5>Table 1. Debug window — common items</h5>
+<table width="94%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="7%" scope="col">Icon</th>
+ <th width="41%" scope="col">Item</th>
+ <th width="52%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="images/icon_new_launch_config.png" width="16" height="17"></div></td>
+ <td><b>New Launch Configuration</b></td>
+ <td><p>Click the New Launch Configuration icon to add a launch configuration to the Configurations list. Default information based upon the project is automatically entered into the various text boxes.</p>
+ <p class="note"><b>NOTE</b> Normally, you should not have to change any of the default text box entries unless you are creating multiple debug launch configurations for the same project.</p></td>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="images/icon_dup_launch_config.png" width="19" height="19"></div></td>
+ <td><b>Duplicate</b></td>
+ <td>Click the Duplicate icon to duplicate the currently selected launch configuration. </td>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="images/icon_delete_launch_config.png" width="17" height="16"></div></td>
+ <td><b>Delete selected launch configuration(s) </b></td>
+ <td>Click the Delete icon to remove the currently selected configuration from the Configurations list.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><b>Collapse</b></td>
+ <td>Click the Collapse icon to collapse expanded lists of launch configurations.</td>
+ </tr>
+ <tr>
+ <td><div align="center"><img src="images/icon_filter_launch_config.png" width="21" height="18"></div></td>
+ <td><b>Filter launch configurations... </b></td>
+ <td><p>Click the Filter icon to select filter options that control which launch configurations appear in the list. Filter options include:</p>
+ <ul>
+ <li>Filter Closed Projects</li>
+ <li>Filter Deleted/Unavailable Projects</li>
+ <li>Filter Configuration Types</li>
+ <li>Apply Window Working Set(s)</li>
+ <li><a href="trk/panel_filter.htm">Filtering Preferences...</a></li>
+ </ul></td>
+ </tr>
+</table>
+<div class="step">
+ <h4>To open the Debug window </h4>
+ <ul>
+ <li>Select the Run > Open Debug Dialog... menu item</li>
+ </ul>
+ <ol>
+ The Debug window (Figure 1) appears.</ol>
+ <ul>
+ <li>Select Run > Open Run Dialog... to open a Run window to create a launch configuration for a release build.</li>
+ </ul>
+</div>
+<h5>Other references</h5>
+<ul>
+ <li><a href="perspective_debug.htm">Debug Perspective</a></li>
+ <li><a href="../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
+ <li><a href="../projects/launch/emulation.htm">Emulator overview</a></li>
+ <li><a href="../projects/launch/run_mode.htm">Run-mode overview</a></li>
+ <li><a href="../projects/launch/stop_mode.htm">Stop-mode overview</a> </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/wnd_sophia_config.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,301 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Sophia Support</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Symbian OS Sophia Target Interface Support</h2>
-<p><a href="../projects/launch/launch_configs_overview.htm">Launch configurations </a>define a collection of settings used to tell the debugger how to start a debug session. The launch configuration panes for creating a Sophia (STI) stop mode debug launch configuration are described below. Figure 1 is an example of the STI Debug launch configuration window and the related panes accessible in a tabbed format.</p>
-<div class="step">
- <h4>To open the Debug window </h4>
- <ul>
- <li>Select the Run > Debug... menu item</li>
- </ul>
- <ol>
- <p>The Debug window (Figure 1) appears.</p>
- </ol>
-</div>
-<p>The panes include:</p>
-<ul>
- <li>The <a href="#Main">Main</a> tab (Figure 1) defines the project to be launched. Enter the name of the project in the Project field, and the executable name in the Executable field.</li>
- <li>The <a href="#Connection">Connection</a> tab (Figure 2) defines the Sophia Target Interface, EJ_Debug type, and JTAG TCLK Frequency.</li>
- <li>The <a href="#Debugger">Debugger</a> tab (Figure3) defines debug configurations, such as entry point to begin debugging, target options, and instruction set.</li>
- <li>The <a href="#ROM">ROM Image</a> tab (Figure 4) allows you to define startup options and ROM image and ROM log file download information.</li>
- <li>The <a href="#Executables">Executables</a> tab (Figure 5) allows you to specify which executables that you want to debug that are part of the project.</li>
- <li>The <a href="#Source">Source</a> tab (Figure 6) (<i>standard CDT page</i>) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here. </li>
- <li>The <a href="#Common">Common</a> tab (Figure 7) (<i>standard CDT page</i>) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file.</li>
-</ul>
-<h2>Main<a name="Main" id="Main"></a></h2>
-<p align="center"><img src="images/panel_debug_sti_main.png" width="540" height="229" /></p>
-<p class="figure">Figure 1 - Sophia (STI) Launch Configuration Settings - Main Tab</p>
-<h5>Table 1. Debug Launch configuration window—Main tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Project</b></td>
- <td>The project to associate with this debug launch configuration. Click Browse to select a different project. </td>
- </tr>
- <tr>
- <td><b>Executable</b></td>
- <td><span
- style="font-weight: normal;">This is the name of the executable that is linked to the project. </span>Click <b>Browse</b> to select a different executable.</td>
- </tr>
-</table>
-<h2>Connection<a name="Connection" id="Connection"></a></h2>
-<p align="center"><img src="images/panel_debug_sti_connection.png" width="530" height="211" /></p>
-<p class="figure">Figure 2 - Sophia Launch Configuration Settings - Connection Tab</p>
-<h5>Table 2. Launch configuration window—Connection tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Sophia Target Interface Location</b></td>
- <td>Enter or browse to the Sophia interface (WTI.dll) to be launched for debugging. By default, it will be set to <span class="code">C:\CarbideIF_ARM\WTI.dll</span>. If default file does not exist then an error message will appear.</td>
- </tr>
- <tr>
- <td><b>EJ_Debug Type</b></td>
- <td><p>Sophia Systems' EJ-Debug is a compact, USB-powered JTAG emulator. Select the EJ_Debug type. Options include:</p>
- <ul>
- <li>Auto (automatically detects target CPU) </li>
- <li>ARM9 (target CPU) </li>
- <li>ARM11 (target CPU)</li>
- <li>ARM9_11 (target CPU)</li>
- <li>ARM7_9_11 (target CPU)</li>
- </ul></td>
- </tr>
- <tr>
- <td><b>JTAG TCLK Frequency </b></td>
- <td><p>Select the JTAG TCLK frequency. Options include:</p>
- <ul>
- <li>Auto</li>
- <li>33 MHz</li>
- <li>16 MHz</li>
- <li>8 MHz</li>
- <li>500 KHz </li>
- </ul></td>
- </tr>
- <tr>
- <td><b>View Messages between Carbide and STI </b></td>
- <td>The View Messages between Carbide and STI check box allows you to specify if the debug protocol messages between Carbide and STI should be logged in a Communication Log console window.</td>
- </tr>
-</table>
-<h2>Debugger<a name="Debugger" id="Debugger"></a></h2>
-<p align="center"><img src="images/panel_debug_T32_debugger.png" width="593" height="403"></p>
-<p class="figure">Figure 3 - Sophia Launch Configuration Settings - Debugger Tab</p>
-<h5>Table 3. Launch configuration window—Debugger tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Break at entry point </b></td>
- <td>Select the check box and specify an entry point in the text box if you want the debugger to break at an entry point in the program being debugged. The default is set to E32Main since most applications entry point is E32Main. But you can specify a function name in the program being debugged.</td>
- </tr>
- <tr>
- <td><b>Soft attach </b></td>
- <td>Select to attach to a target without restarting the target device. This is very handy when the device uses flash, memory cards, or other external media for booting purposes and when it's not possible to configure the device to restart by the debugger. With soft attach, the debugger doesn't change the state of the target device. The debugger halts the target after attaching to the target to show the current PC location. User can preform normal debugging operations from then onwards. </td>
- </tr>
- <tr>
- <td><b>Debug from start address</b></td>
- <td>Select this option to stop the target at the start address once the target initialization is done and the OS is downloaded; if you have chosen to download the OS.</td>
- </tr>
- <tr>
- <td><b>Run from start address </b></td>
- <td><p>Select this option to run the target from the start address once the target initialization is done.</p></td>
- </tr>
- <tr>
- <td><b>Start Address (hex) </b></td>
- <td>Specify the memory address that the Carbide debugger will use to set the program counter to start the target. This is typically the start address of the Symbian OS.</td>
- </tr>
- <tr>
- <td><b>Reset target at the start of each debug session </b></td>
- <td><p>Select this check box to reset the target at the start of each debug session. For Trace32, the reset is typically done as part of the CMM script file.</p>
- <p>Consult board specifications to determine if resetting is necessary.</p></td>
- </tr>
- <tr>
- <td><b>Target Processor </b></td>
- <td>Select a target processor from the drop down list of all supported processors. By default the field is set to Generic. When you select a processor, Carbide determines whether the debugger provides ARMV5 or ARMV6 support.</td>
- </tr>
- <tr>
- <td><b>Target Initialization File</b></td>
- <td><p>Select the check box and enter or browse to the target initialization file. Typically, this initialization file is used to initialize the target after connecting. When using Trace32, the initialization is done in the CMM script file.</p></td>
- </tr>
- <tr>
- <td><b>Memory Configuration File </b></td>
- <td>Select the check box and enter or browse to the memory configuration file. The Carbide debugger uses this configuration file to determine which memory is accessible, readable, and writable on the target.</td>
- </tr>
- <tr>
- <td><b>Default Instruction set </b></td>
- <td><p>The following options are available:</p>
- <ul>
- <li>Auto (examine code at current PC location) </li>
- <li>Arm (32 bit) </li>
- <li>Thumb (16 bit) </li>
- </ul>
- <p>Arm is the default. It is used by the debugger to determine the processor mode when it cannot be determined otherwise. This can happen at addresses for which there is no symbolic information. The debugger uses the mode when setting breakpoints and disassembling code.</p></td>
- </tr>
-</table>
-<h2>ROM Image<a name="ROM" id="ROM"></a></h2>
-<p align="center"><img src="images/panel_debug_T32_image.png" width="593" height="306"></p>
-<p class="figure">Figure 4 - Sophia Launch Configuration Settings - ROM Image Tab</p>
-<h5>Table 4. Launch configuration window—ROM Image tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Parse Rom Log File</b></td>
- <td>Check this option to parse the ROM log file. </td>
- </tr>
- <tr>
- <td><b>Symbian Rom Log File</b></td>
- <td>Enter or browse to the Rom log file that is generated when the Symbian OS image is built. This is necessary for debugging any Symbian OS module.</td>
- </tr>
- <tr>
- <td><b>Symbian Epoc32 Directory </b></td>
- <td><p>Enter or browse to the epoc32 directory for the Symbian OS kit that is being targeted for debugging. This is necessary for the debugger to resolve the full paths for each module in the log file since the log file does not contain the full paths.</p></td>
- </tr>
- <tr>
- <td><b>Log unresolved modules</b></td>
- <td>Check this option to log unresolved modules. If the actual binary in the log file doesn’t exist on the PC, then a warning message will be logged in a Rom Log console window.</td>
- </tr>
- <tr>
- <td><b>Debug non-XIP executables</b></td>
- <td>Check this option to target non-XIP executables. This allows the debugger to target a non-XIP module whenever it’s loaded.</td>
- </tr>
- <tr>
- <td><b>Download Rom Image </b></td>
- <td>Check this box to enable downloading. </td>
- </tr>
- <tr>
- <td><b>Symbian Rom Image</b></td>
- <td>Enter or browse to the Symbian OS image (.img file) that will be downloaded onto the target at the specified download address.</td>
- </tr>
- <tr>
- <td><b>Download Address (hex) </b></td>
- <td><p>Specify the address where the image is to be downloaded. This address is target-specific. The address should be in hexadecimal format with the 0x prefix.</p></td>
- </tr>
- <tr>
- <td><b>Same as start address</b></td>
- <td>Check this option to make the download address the same as the start address.</td>
- </tr>
- <tr>
- <td><b>Ask for download at the start of each debug session</b></td>
- <td>Select this option to prompt you to download the image at the start of the debug session.</td>
- </tr>
-</table>
-<h2>Executables<a name="Executables" id="exe"></a></h2>
-<p align="center"><img src="images/panel_trk_exes.png" width="558" height="279"></p>
-<p class="figure">Figure 5 - Sophia Launch Configuration Settings - Executables Tab</p>
-<h5>Table 5. Executable pane —items </h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Load symbols for these executables and target them for debugging </b></td>
- <td><p>Select the rule which govern the executable support used by this project for debugging purposes. The options include: </p>
- <ul>
- <li><b>Executables in the workspace from this SDK</b> — shows all executables in the workspace built using the specified SDK. This is the default setting. </li>
- <li><b>Executables built by this project</b> — shows only the executables built by this project using the specified SDK</li>
- <li><b>Executables selected below</b> — shows only the executables chosen by the user. Initial list display uses the All Executables listing. </li>
- <li><b>All executables (slows launch)</b> — shows all the executables in the workspace regardless of which SDK created them. Selecting this option will slow down Carbide launches as the list is populated. </li>
- </ul></td>
- </tr>
- <tr>
- <td><b>Executables list </b></td>
- <td>Shows all the executables associated with this project. </td>
- </tr>
- <tr>
- <td><b>Add...</b></td>
- <td>Opens the <b>Select an executable file</b> dialog which can locate and select executable files and add them to the project's executables list. </td>
- </tr>
- <tr>
- <td><b>Select All </b></td>
- <td>Enables all the executables in the list for debugging. </td>
- </tr>
- <tr>
- <td><b>Unselect All </b></td>
- <td>Disables all the executables in the list from debugging. </td>
- </tr>
-</table>
-<h2>Source<a name="Source" id="Source"></a></h2>
-<p align="center"><img src="images/panel_debug_source.png" width="550" height="299" /></p>
-<p class="figure">Figure 6 - Sophia Launch Configuration Settings - Source Tab</p>
-<h5>Table 6. Launch configuration window—Source tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Source Lookup Path</b></td>
- <td>Allows you to add locations to search for source files. You can arrange the list by selecting the type of source path and clicking Up and Down buttons. Select a type of source and click Remove button to delete the item from the list.</td>
- </tr>
- <tr>
- <td><b>Search for duplicate source files on the path </b></td>
- <td>Enable this option to search for duplicate source files on source paths listed.</td>
- </tr>
-</table>
-<h2>Common<a name="Common" id="Common"></a></h2>
-<p align="center"><img src="images/panel_debug_common.png" width="556" height="330" /></p>
-<p class="figure">Figure 7 - Sophia Launch Configuration Settings - Common Tab</p>
-<h5>Table 7. Launch configuration window—Common tab items</h5>
-<table width="94%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="32%" scope="col">Item</th>
- <th width="68%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>Save As </b></td>
- <td>Allows you to save the launch configuration as a file local to the project or as shared file. For a shared file you can enter or browse to a folder within an existing project directory.</td>
- </tr>
- <tr>
- <td><b>Display in favorites menu </b></td>
- <td>Select menu for launch configuration to appear.</td>
- </tr>
- <tr>
- <td><b>Console Encoding</b></td>
- <td>Select the character set to use to display information in the console window. </td>
- </tr>
- <tr>
- <td><b>Standard Input and Output</b> </td>
- <td>Allocate input and output to console and/or specified file. If a file is selected, you can select Append option to append data to selected file. </td>
- </tr>
- <tr>
- <td><b>Launch in background</b></td>
- <td>Enable this option to launch debug operation in a background process. </td>
- </tr>
-</table>
-<p> </p>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="../projects/launch/launch_configs_overview.htm">Launch Configurations</a></li>
- <li><a href="../concepts/debugger_about.htm">About the Debugger</a></li>
-</ul>
-<h5 align="left">Related tasks</h5>
-<ul>
- <li><a href="../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
-</ul>
-<h5 align="left">Related references </h5>
-<ul>
- <li><a href="wnd_Trace32_config.htm">Symbian OS Trace32 Support</a></li>
- <li><a href="perspective_debug.htm">Debug Perspective</a></li>
- <li><a href="view_debug.htm">Debug View</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/AddingClasses.html Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/AddingClasses.html Mon Aug 10 15:50:55 2009 -0500
@@ -1,84 +1,80 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head>
-<title>Adding Classes in Tasks</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
- <body>
- <h2>Adding Classes</h2>
-
- <p>Use the <b>New Class</b> wizard to add a new C++ class to a project. </p>
-
- <div class="step">
- <h4>To add a new C++ class</h4>
-
- <ol><li>
- <p>
- Click <b>File > New > Class</b> from the menu bar,
- or select <b>New > Class</b> from the project′s pop-up
- menu where you want the new class to reside. </p>
- <p>
- The New C++ Class wizard then appears.
- </p>
- </li>
- <li>
- <p>
- Specify the folder when the class should be created by typing the <b>Source Folder</b> name or by clicking <b>Browse</b> and
- selecting the source folder. </p>
-
- <p align="center" class="Image"><img src="../images/newclasswiz.gif" alt="" width="500" height="568" border="0" /></p>
- </li>
- <li>
- <p>
- Select the <b>Namespace</b> checkbox, if you want to add
- the class to a namespace. Click <b>Browse</b> to select an existing
- namespace, or type the name of the new namespace. </p>
- </li>
- <li>
- <p>
- In the <b>Class Name</b> field, type the name of the class. </p>
- </li>
- <li>
- <p>
- Click <b>Add</b> to choose the <b>Base Classes</b> from which the class has to be derived</p>
-
- <p align="center" class="Image"><img src="../images/choosebaseclass.gif" alt="" width="306" height="565" border="0" /></p>
- <p>To select a base type you are looking for, do the following: </p>
- <ol type="a">
- <li>Type the search string to locate the class, struct and other low-level types you are looking for</li>
-
- <li>Select a Visible Type to narrow your search. <br />
- <p>For example, if you are for looking for only classes then select the Class checkbox, etc. The Matching Types lists all the types matching the visible type and search string. The Qualifier lists the header file which contain the type
- declaration of all the type listed.</p>
- </li>
- <li>Click Add to add the selected type to the Base Classes list. <br />
- <p>By default, the types are added with Public access and without Virtual inheritance, although these settings can be changed. </p>
- </li>
- <li>Click OK when you have completed adding base classes, or click Cancel to cancel the action.</li>
- </ol>
- </li>
- <li>Once the Base Classes are added, you can click Remove to remove a selected class from the list. You can also click Up and Down after selecting a class from the list to change the order in which the base classes are inherited. </p>
- <p>Select the Method Stubs you want the wizard to generate by selecting the appropriate checkbox. By default, both Constructor and Destructor are selected. By
- default, the constructor is added with public access, and as non-virtual and non-inline, and the destructor is added as public, virtual, and not inline. </p>
- <p>
- Select the Use Default checkbox to create the C++
- class in new header and source files with default names. Otherwise, deselect
- the Use Default checkbox, and enter the Header and Source file names. Click Browse to select the Header and Source files, if you want to
- add the class declaration and definition to existing files. </p>
-
- <li>
- Click Finish to create a C++ class according to the
- specification, or click Cancel to cancel the task.</li>
-</ol>
- </div>
- <h5>Related concepts</h5>
- <ul>
- <li><a href="../concepts/SDKSupport.html">SDK Support</a></li>
- </ul>
- <h5>Related tasks</h5>
- <ul>
- <li><a href="../reference/NewClassWizard.html">New C++ Classs Wizard</a></li>
- </ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
- </body>
- </html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head>
+<title>Adding Classes in Tasks</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+ <body>
+ <h2>Adding Classes</h2>
+
+ <p>Use the <b>New Class</b> wizard to add a new C++ class to a project. </p>
+
+ <div class="step">
+ <h4>To add a new C++ class</h4>
+
+ <ol><li>
+ <p>
+ Click <b>File > New > Class</b> from the menu bar,
+ or select <b>New > Class</b> from the project′s pop-up
+ menu where you want the new class to reside. </p>
+ <p>
+ The New C++ Class wizard then appears.
+ </p>
+ </li>
+ <li>
+ <p>
+ Specify the folder when the class should be created by typing the <b>Source Folder</b> name or by clicking <b>Browse</b> and
+ selecting the source folder. </p>
+
+ <p align="center" class="Image"><img src="../images/newclasswiz.gif" alt="" width="500" height="568" border="0" /></p>
+ </li>
+ <li>
+ <p>
+ Select the <b>Namespace</b> checkbox, if you want to add
+ the class to a namespace. Click <b>Browse</b> to select an existing
+ namespace, or type the name of the new namespace. </p>
+ </li>
+ <li>
+ <p>
+ In the <b>Class Name</b> field, type the name of the class. </p>
+ </li>
+ <li>
+ <p>
+ Click <b>Add</b> to choose the <b>Base Classes</b> from which the class has to be derived</p>
+
+ <p align="center" class="Image"><img src="../images/choosebaseclass.gif" alt="" width="306" height="565" border="0" /></p>
+ <p>To select a base type you are looking for, do the following: </p>
+ <ol type="a">
+ <li>Type the search string to locate the class, struct and other low-level types you are looking for</li>
+
+ <li>Select a Visible Type to narrow your search. <br />
+ <p>For example, if you are for looking for only classes then select the Class checkbox, etc. The Matching Types lists all the types matching the visible type and search string. The Qualifier lists the header file which contain the type
+ declaration of all the type listed.</p>
+ </li>
+ <li>Click Add to add the selected type to the Base Classes list. <br />
+ <p>By default, the types are added with Public access and without Virtual inheritance, although these settings can be changed. </p>
+ </li>
+ <li>Click OK when you have completed adding base classes, or click Cancel to cancel the action.</li>
+ </ol>
+ </li>
+ <li>Once the Base Classes are added, you can click Remove to remove a selected class from the list. You can also click Up and Down after selecting a class from the list to change the order in which the base classes are inherited. <p></p>
+ <p>Select the Method Stubs you want the wizard to generate by selecting the appropriate checkbox. By default, both Constructor and Destructor are selected. By
+ default, the constructor is added with public access, and as non-virtual and non-inline, and the destructor is added as public, virtual, and not inline. </p>
+ <p>
+ Select the Use Default checkbox to create the C++
+ class in new header and source files with default names. Otherwise, deselect
+ the Use Default checkbox, and enter the Header and Source file names. Click Browse to select the Header and Source files, if you want to
+ add the class declaration and definition to existing files. </p>
+
+ <li>
+ Click Finish to create a C++ class according to the
+ specification, or click Cancel to cancel the task.</li>
+</ol>
+ </div>
+ <h5>Related tasks</h5>
+ <ul>
+ <li><a href="../reference/NewClassWizard.html">New C++ Classs Wizard</a></li>
+ </ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+ </body>
+ </html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_08.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_08.htm Mon Aug 10 15:50:55 2009 -0500
@@ -27,7 +27,7 @@
<li>Import the MMP or INF file</li>
<li>Select the Project in the C/C++ Project pane you want to debug</li>
<li>From the IDE select Run > Debug…</li>
- <li>The <a href="../projects/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> appears</li>
+ <li>The <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> appears</li>
<p>To communicate between the Carbide.c++ debugger and the on-device debug agent or protocol interface you must define a debug launch configuration. The Debug window is where you define the type of debug launch configuration to use when debugging programs on the target device (Figure 4).</p>
<p><img src="images/Debug_Config_main.png" width="830" height="506" /></p>
<p class="figure">Figure 4. Debug Window</p>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/soft_attach_debug.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/soft_attach_debug.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,117 +1,117 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Using Soft Attach for On-Device Debugging</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Using Soft Attach for On-Device Debugging</h2>
-<p>You can debug hardware via Trace32 using the soft attach option. This enables you to debug an image flashed to ROM or on a memory card. Soft attach includes all the capabilities fo Stop-mode debugging but can't debug any code loaded before the OS is booted. </p>
-<p>There are several components that must be provided to the debugger so that it can communicate with the attached hardware device. They are:</p>
-<ul>
- <li><b>Config_carbide.t32</b> - a required configuration file used to configure Carbide for soft attach debugging</li>
- <li><b>.cmm file</b> - you must select the correct .cmm script file for the hardware otherwise it will not initialize properly and the debugger will be unable to communicate. The .cmm script files are located in the <span class="code"><Carbide>\plugins\com.nokia.carbide.cpp.support_2.0.x.xxx\Symbian_Support\Trace32\cmm_scripts</span> directory.<br>
- <br>
- Also, if there is a specific .cmm file for the device, like H2 or H4, especially if it includes <span class="code">_attach</span> in the name, choose that version over the others to do soft attach on the hardware. </li>
- <li><b>.log file</b> - you must have a valid .log file for the ROM image in order to debug the image </li>
-</ul>
-<p>If the <a href="../projects/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> is used, you will be asked to identify the above files. If you used the <b>New</b> or <b><a href="../../reference/wnd_debug_configuration.htm">Debug</a></b> dialog to create a launch configuration, make sure that the above files are supplied. </p>
-<p>The major steps to perform a soft attach are: </p>
-<ol>
- <li><a href="#buildProject">Import and build</a> your project and the ROM image </li>
- <li><a href="#startHardware">Startup the device</a> using the ROM image </li>
- <li><a href="#debuggerSetup">Setup the debugger</a> and begin debugging </li>
-</ol>
-<div class="step">
- <h4><a name="buildProject" id="buildProject"> </a>1. Importing and building the project and ROM image </h4>
- <ol>
- <li><a href="../ImportingProjects.html">Import</a> the project</li>
- <li><a href="../projects/prj_build.htm">Build</a> the project</li>
- <li><a href="../../reference/ROM_build_settings.html">Create</a> a ROM image
- <p>Enter the desired command-line arguments for the ROM image in the ROM Build Command Line text box in the <b>Carbide ROM Build Settings</b> panel of the <b>Properties for <project></b> dialog. </p>
- </li>
- </ol>
-</div>
-<div class="step">
-<h4><a name="startHardware" id="startHardware"> </a>2. Starting up the device with the ROM image </h4>
-<ol>
- <li>Transfer the ROM image to the hardware via memory card or flash </li>
- <p class="note"><b>NOTE</b> Ensure that the hardware includes a boot loader program so that it can boot the ROM image from the memory card. </p>
- <li>Power up the device
- <p>Once the operating system has booted up, it is ready for the debugger to attach </p>
- </li>
- </ol>
- <p> </p>
-</div>
-<div class="step">
-<h4><a name="debuggerSetup" id="debuggerSetup"> </a>3. Setting up the debugger to debug </h4>
-<ol>
- <li>On the hardware, launch the program to debug</li>
- <li>Click Run > Debug to launch the <a href="../projects/wiz_new_launch_config.htm">New Launch Configuration Wizard</a></li>
- <li>In the Launch Types page
- <ol type="a">
- <li>Select the Trace32 Launch Configuration</li>
- <li>Click Next </li>
- </ol>
- </li>
- <li>In the Symbian ROM Image Settings page
- <ol type="a">
- <li>Enter the path to the Trace32 Initialization Script .cmm file </li>
- <li>Select the Target Processor </li>
- <li>Click Next </li>
- </ol>
- In the Symbian ROM Image Settings page
- <ol type="a">
- <li>Enable Soft attach</li>
- <li>Enter the Symbian ROM Log File </li>
- <li>Click Next </li>
- </ol>
- </li>
- <li>In the New Launch Configuration page
- <ol type="a">
- <li>Enable the "Open launch configuration for additional customization of launch settings" option </li>
- <li>Click Finish </li>
- </ol>
- </li>
- <li>In the Debug > Symbian OS Trace 32 > <i>New_Configuration</i> > Connection tab
- <ol type="a">
- <li>Enable the "View messages between Carbide and Trace32"</li>
- <li>Click Debug </li>
- </ol>
- </li>
- <p align="left">If the View messages between Carbide and Trace32 option is enabled, the Console view will show the communications between the debugger and the hardware (Figure 1). If you do not see the messages, verify that the <b>Trace32 Communications Log</b> is the active log view. </p>
- <p align="center"><img src="images/soft_attach_cmm_console.png" width="927" height="199" class="figure"></p>
- <p class="figure">Figure 1. Debugger log showing .cmm file being used to initialize hardware </p>
- <li>Once the debugger connects to the hardware it will halt the hardware at a random memory address (Figure 2). Press Resume in the Debug view to begin debugging.</li>
- <p align="center"><img src="images/soft_attach_random_address.png" width="593" height="268" class="figure"></p>
- <p class="figure">Figure 2. Debugger stopping at a random address using soft attach </p>
- <li>Debug the program in the Carbide debugger </li>
- <p>Once the debugger is connected to the hardware you can: </p>
- <ul>
- <li>Set breakpoints in the editor view </li>
- </ul>
- <blockquote>
- <p>If breakpoints were already set in the project then an Editor view should display them as <a href="../../concepts/breakpoints.htm">resolved</a>. If no breakpoints have been set, now is the time to add them. </p>
- <p class="note"><b>NOTE</b> The number of breakpoints you can set is controlled by the hardware. </p>
- </blockquote>
- <ul><li>Click Suspend to halt the processor on the hardware </li>
- <li>Use Disconnect (<i>preferred</i>) to stop debugging the program. This does not halt the processor. </li>
- <li>Use Terminate to end the debug session</li>
- </ul>
-</ol>
-</div>
-<h4>Related references</h4>
-<ul>
- <li><a href="../../reference/panel_debug_exceptions.htm">Debug</a> perspective </li>
- <li><a href="../../reference/view_executables.htm">Executables</a> view</li>
- <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view</li>
- <li><a href="../../reference/view_registers.htm">Registers</a> view</li>
- <li><a href="../../reference/view_breakpoints.htm">Breakpoint</a> view </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Using Soft Attach for On-Device Debugging</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Using Soft Attach for On-Device Debugging</h2>
+<p>You can debug hardware via Trace32 using the soft attach option. This enables you to debug an image flashed to ROM or on a memory card. Soft attach includes all the capabilities fo Stop-mode debugging but can't debug any code loaded before the OS is booted. </p>
+<p>There are several components that must be provided to the debugger so that it can communicate with the attached hardware device. They are:</p>
+<ul>
+ <li><b>Config_carbide.t32</b> - a required configuration file used to configure Carbide for soft attach debugging</li>
+ <li><b>.cmm file</b> - you must select the correct .cmm script file for the hardware otherwise it will not initialize properly and the debugger will be unable to communicate. The .cmm script files are located in the <span class="code"><Carbide>\plugins\com.nokia.carbide.cpp.support_2.0.x.xxx\Symbian_Support\Trace32\cmm_scripts</span> directory.<br>
+ <br>
+ Also, if there is a specific .cmm file for the device, like H2 or H4, especially if it includes <span class="code">_attach</span> in the name, choose that version over the others to do soft attach on the hardware. </li>
+ <li><b>.log file</b> - you must have a valid .log file for the ROM image in order to debug the image </li>
+</ul>
+<p>If the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> is used, you will be asked to identify the above files. If you used the <b>New</b> or <b><a href="../../reference/wnd_debug_configuration.htm">Debug</a></b> dialog to create a launch configuration, make sure that the above files are supplied. </p>
+<p>The major steps to perform a soft attach are: </p>
+<ol>
+ <li><a href="#buildProject">Import and build</a> your project and the ROM image </li>
+ <li><a href="#startHardware">Startup the device</a> using the ROM image </li>
+ <li><a href="#debuggerSetup">Setup the debugger</a> and begin debugging </li>
+</ol>
+<div class="step">
+ <h4><a name="buildProject" id="buildProject"> </a>1. Importing and building the project and ROM image </h4>
+ <ol>
+ <li><a href="../ImportingProjects.html">Import</a> the project</li>
+ <li><a href="../projects/prj_build.htm">Build</a> the project</li>
+ <li><a href="../../reference/ROM_build_settings.html">Create</a> a ROM image
+ <p>Enter the desired command-line arguments for the ROM image in the ROM Build Command Line text box in the <b>Carbide ROM Build Settings</b> panel of the <b>Properties for <project></b> dialog. </p>
+ </li>
+ </ol>
+</div>
+<div class="step">
+<h4><a name="startHardware" id="startHardware"> </a>2. Starting up the device with the ROM image </h4>
+<ol>
+ <li>Transfer the ROM image to the hardware via memory card or flash </li>
+ <p class="note"><b>NOTE</b> Ensure that the hardware includes a boot loader program so that it can boot the ROM image from the memory card. </p>
+ <li>Power up the device
+ <p>Once the operating system has booted up, it is ready for the debugger to attach </p>
+ </li>
+ </ol>
+ <p> </p>
+</div>
+<div class="step">
+<h4><a name="debuggerSetup" id="debuggerSetup"> </a>3. Setting up the debugger to debug </h4>
+<ol>
+ <li>On the hardware, launch the program to debug</li>
+ <li>Click Run > Debug to launch the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a></li>
+ <li>In the Launch Types page
+ <ol type="a">
+ <li>Select the Trace32 Launch Configuration</li>
+ <li>Click Next </li>
+ </ol>
+ </li>
+ <li>In the Symbian ROM Image Settings page
+ <ol type="a">
+ <li>Enter the path to the Trace32 Initialization Script .cmm file </li>
+ <li>Select the Target Processor </li>
+ <li>Click Next </li>
+ </ol>
+ In the Symbian ROM Image Settings page
+ <ol type="a">
+ <li>Enable Soft attach</li>
+ <li>Enter the Symbian ROM Log File </li>
+ <li>Click Next </li>
+ </ol>
+ </li>
+ <li>In the New Launch Configuration page
+ <ol type="a">
+ <li>Enable the "Open launch configuration for additional customization of launch settings" option </li>
+ <li>Click Finish </li>
+ </ol>
+ </li>
+ <li>In the Debug > Symbian OS Trace 32 > <i>New_Configuration</i> > Connection tab
+ <ol type="a">
+ <li>Enable the "View messages between Carbide and Trace32"</li>
+ <li>Click Debug </li>
+ </ol>
+ </li>
+ <p align="left">If the View messages between Carbide and Trace32 option is enabled, the Console view will show the communications between the debugger and the hardware (Figure 1). If you do not see the messages, verify that the <b>Trace32 Communications Log</b> is the active log view. </p>
+ <p align="center"><img src="images/soft_attach_cmm_console.png" width="927" height="199" class="figure"></p>
+ <p class="figure">Figure 1. Debugger log showing .cmm file being used to initialize hardware </p>
+ <li>Once the debugger connects to the hardware it will halt the hardware at a random memory address (Figure 2). Press Resume in the Debug view to begin debugging.</li>
+ <p align="center"><img src="images/soft_attach_random_address.png" width="593" height="268" class="figure"></p>
+ <p class="figure">Figure 2. Debugger stopping at a random address using soft attach </p>
+ <li>Debug the program in the Carbide debugger </li>
+ <p>Once the debugger is connected to the hardware you can: </p>
+ <ul>
+ <li>Set breakpoints in the editor view </li>
+ </ul>
+ <blockquote>
+ <p>If breakpoints were already set in the project then an Editor view should display them as <a href="../../concepts/breakpoints.htm">resolved</a>. If no breakpoints have been set, now is the time to add them. </p>
+ <p class="note"><b>NOTE</b> The number of breakpoints you can set is controlled by the hardware. </p>
+ </blockquote>
+ <ul><li>Click Suspend to halt the processor on the hardware </li>
+ <li>Use Disconnect (<i>preferred</i>) to stop debugging the program. This does not halt the processor. </li>
+ <li>Use Terminate to end the debug session</li>
+ </ul>
+</ol>
+</div>
+<h4>Related references</h4>
+<ul>
+ <li><a href="../../reference/panel_debug_exceptions.htm">Debug</a> perspective </li>
+ <li><a href="../../reference/view_executables.htm">Executables</a> view</li>
+ <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view</li>
+ <li><a href="../../reference/view_registers.htm">Registers</a> view</li>
+ <li><a href="../../reference/view_breakpoints.htm">Breakpoint</a> view </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/stop_mode_debug.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/stop_mode_debug.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,37 +1,37 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<title>Stop Mode On-Device Debugging</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF" dir="ltr">
-<h2>Stop Mode Debug Example</h2>
-<p>This example shows how to create and build an application and debug it on a device using JTAG debug software and Lauterbach or Sophia hardware.</p>
-<p>The basic steps include:</p>
-<ul>
- <li>Verify that your SDK or customer kit is recognized in the <a href="../../reference/SDKPreferences.html">SDK preferences</a> panel.</li>
- <li>Create project or <a href="../ImportingProjects.html">Import</a> the project's bld.inf file into Carbide.c++</li>
-<li>Specify your <a href="../../reference/ROM_build_settings.html">ROM build settings</a> for the selected project</li>
- <li><a href="../projects/prj_build.htm">Build</a> your Project with the ARMV5 Debug Build Configuration</li>
-<li>Create a <a href="../projects/wiz_new_launch_config.htm">launch configuration</a> for <a href="../../reference/wnd_Trace32_config.htm">Trace32</a> or <a href="../../reference/wnd_sophia_config.htm">Sophia</a></li>
-<li><a href="work_debug_act_debug.htm">Launch</a> the debugger</li>
-</ul>
-<p>With stop mode debugging you can use the Carbide.c++ IDE and a JTAG interface to communicate between the debugger and a board to debug any target type within the Symbian OS.</p>
-<h3>Attach to Process </h3>
-<p>Use <a href="../../reference/view_symbian_kernel.htm#attach">Attach to Process</a> to debug any binaries outside the workspace. The methods to do this include:</p>
-<ul>
- <li>Select a process in the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data View</a>, then click <a href="work_debug_act_debug.htm">Debug</a> to launch the debugger which then attaches to the selected process. Ensure that the binary to debug is included in the <a href="../../reference/view_executables.htm">Executables</a> view in order to set and hit any breakpoints. </li>
- <li>Create an <b>Attach to Process Launch Configuration</b> using the <a href="../projects/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> for the project</li>
-</ul>
-<h5>Related Tasks</h5>
-<ul>
- <li><a href="stop_mode_debug_precond.htm">Stop Mode On-Device Debugging Preconditions</a></li>
- <li><a href="../../reference/wnd_Trace32_config.htm">Symbian OS Trace32 Support</a></li>
-<li><a href="../../reference/wnd_sophia_config.htm">Symbian OS Sophia Target Interface Support</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<title>Stop Mode On-Device Debugging</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF" dir="ltr">
+<h2>Stop Mode Debug Example</h2>
+<p>This example shows how to create and build an application and debug it on a device using JTAG debug software and Lauterbach or Sophia hardware.</p>
+<p>The basic steps include:</p>
+<ul>
+ <li>Verify that your SDK or customer kit is recognized in the <a href="../../reference/SDKPreferences.html">SDK preferences</a> panel.</li>
+ <li>Create project or <a href="../ImportingProjects.html">Import</a> the project's bld.inf file into Carbide.c++</li>
+<li>Specify your <a href="../../reference/ROM_build_settings.html">ROM build settings</a> for the selected project</li>
+ <li><a href="../projects/prj_build.htm">Build</a> your Project with the ARMV5 Debug Build Configuration</li>
+<li>Create a <a href="../../projects/launch/wiz_new_launch_config.htm">launch configuration</a> for <a href="../../projects/launch/trace32.htm">Trace32</a> or <a href="../../projects/launch/sophia.htm">Sophia</a></li>
+<li><a href="work_debug_act_debug.htm">Launch</a> the debugger</li>
+</ul>
+<p>With stop mode debugging you can use the Carbide.c++ IDE and a JTAG interface to communicate between the debugger and a board to debug any target type within the Symbian OS.</p>
+<h3>Attach to Process </h3>
+<p>Use <a href="../../reference/view_symbian_kernel.htm#attach">Attach to Process</a> to debug any binaries outside the workspace. The methods to do this include:</p>
+<ul>
+ <li>Select a process in the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data View</a>, then click <a href="work_debug_act_debug.htm">Debug</a> to launch the debugger which then attaches to the selected process. Ensure that the binary to debug is included in the <a href="../../reference/view_executables.htm">Executables</a> view in order to set and hit any breakpoints. </li>
+ <li>Create an <b>Attach to Process Launch Configuration</b> using the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> for the project</li>
+</ul>
+<h5>Related Tasks</h5>
+<ul>
+ <li><a href="stop_mode_debug_precond.htm">Stop Mode On-Device Debugging Preconditions</a></li>
+ <li><a href="../../projects/launch/trace32.htm">Symbian OS Trace32 Support</a></li>
+<li><a href="../../projects/launch/sophia.htm">Symbian OS Sophia Target Interface Support</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/stop_mode_debug_precond.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/stop_mode_debug_precond.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,32 +1,32 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<title>Stop Mode On-Device Debugging</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF" dir="ltr">
-<h2>Stop Mode On-Device Debugging Preconditions</h2>
-<p>Before conducting a Stop Mode On-Device debug session the following preconditions should be met.</p>
-<div class="step">
-<h4>Verifying On-device Debugging Preconditions</h4>
-<ul>
- <li>Install ActiveState PERL. You can download a copy of Perl at www.ActiveState.com.</li>
-<li>Install the GCCE or RVCT 2.2 or greater compiler (not included with Carbide.c++).</li>
-<li>Install the TechView Devkit</li>
-<li>Install Board Support Package (BSP) for your target board</li>
-<li>Install JTAG software and drivers for <a href="http://www.lauterbach.com">Trace32</a> or <a href="http://www.sophia.com">Sophia</a> I/F tool support</li>
-<li>Connect JTAG interface between PC and hardware</li>
-<li>Verify that your SDK or customer kit is recognized in the <a href="../../reference/SDKPreferences.html">SDK preferences</a> panel.</li>
-<li>Build your <a href="../../reference/ROM_build_settings.html">ROM Image</a></li>
-</ul>
-</div>
-<h5>Related Tasks</h5>
-<ul>
- <li><a href="../../reference/wnd_Trace32_config.htm">Symbian OS Trace32 Support</a></li>
-<li><a href="../../reference/wnd_sophia_config.htm">Symbian OS Sophia Target Interface Support</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<title>Stop Mode On-Device Debugging</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF" dir="ltr">
+<h2>Stop Mode On-Device Debugging Preconditions</h2>
+<p>Before conducting a Stop Mode On-Device debug session the following preconditions should be met.</p>
+<div class="step">
+<h4>Verifying On-device Debugging Preconditions</h4>
+<ul>
+ <li>Install ActiveState PERL. You can download a copy of Perl at www.ActiveState.com.</li>
+<li>Install the GCCE or RVCT 2.2 or greater compiler (not included with Carbide.c++).</li>
+<li>Install the TechView Devkit</li>
+<li>Install Board Support Package (BSP) for your target board</li>
+<li>Install JTAG software and drivers for <a href="http://www.lauterbach.com">Trace32</a> or <a href="http://www.sophia.com">Sophia</a> I/F tool support</li>
+<li>Connect JTAG interface between PC and hardware</li>
+<li>Verify that your SDK or customer kit is recognized in the <a href="../../reference/SDKPreferences.html">SDK preferences</a> panel.</li>
+<li>Build your <a href="../../reference/ROM_build_settings.html">ROM Image</a></li>
+</ul>
+</div>
+<h5>Related Tasks</h5>
+<ul>
+ <li><a href="../../projects/launch/trace32.htm">Symbian OS Trace32 Support</a></li>
+<li><a href="../../projects/launch/sophia.htm">Symbian OS Sophia Target Interface Support</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/view_symbian_kernel_set.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/view_symbian_kernel_set.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,37 +1,37 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Stopping Program Execution</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Setting Symbian OS Data View Refresh Rate</h2>
-<p>A global preference option in the Preferences window of Carbide.c++ allows a user to change the time interval for auto-refreshing kernel data in the Symbian OS View.</p>
-<div class="step">
- <h4>To set the refresh rate</h4>
- <ol>
- <li>Select Window > Preferences to display Preferences window</li>
- <li>Expand C/C++ and Debug from list</li>
- <li>Select Carbide.c++ to display the Carbide.c++ Global settings panel (figure 1)</li>
- <li>Enter a time interval from 3 to 600 seconds for kernel data to be refreshed. 20 seconds is the default.</li>
- </ol>
- <p align="center"><img src="images/setinterval_symOS_view.png" width="627" height="544" /> </p>
- <p align="center" class="figure">Figure 1. Symbian OS Kernel Data Refresh Rate </p>
-</div>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS Kernel View</a></li>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
-</ul>
-<h5>Related references </h5>
-<ul>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
- <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS View Window</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Stopping Program Execution</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Setting Symbian OS Data View Refresh Rate</h2>
+<p>A global preference option in the Preferences window of Carbide.c++ allows a user to change the time interval for auto-refreshing kernel data in the Symbian OS View.</p>
+<div class="step">
+ <h4>To set the refresh rate</h4>
+ <ol>
+ <li>Select Window > Preferences to display Preferences window</li>
+ <li>Expand C/C++ and Debug from list</li>
+ <li>Select Carbide.c++ to display the Carbide.c++ Global settings panel (figure 1)</li>
+ <li>Enter a time interval from 3 to 600 seconds for kernel data to be refreshed. 20 seconds is the default.</li>
+ </ol>
+ <p align="center"><img src="images/setinterval_symOS_view.png" width="627" height="544" /> </p>
+ <p align="center" class="figure">Figure 1. Symbian OS Kernel Data Refresh Rate </p>
+</div>
+<h5>Related concepts</h5>
+<ul>
+ <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS Kernel View</a></li>
+ <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
+</ul>
+<h5>Related references </h5>
+<ul>
+ <li><a href="../../debugger/debug/viewing_debug.htm">Debug View</a></li>
+ <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS View Window</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_debug.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_debug.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,36 +1,36 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debugging a Program</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debugging a Program</h2>
-<p>Use the <b>Debug</b> command (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) to execute a program under debugger control using the current <a href="../../reference/wnd_debug_configuration.htm">launch configuration</a> settings.</p>
-<p>If this is the first time the program is launched for debugging, a new debug launch configuration is automatically created for you based on current project settings and assigned a name. If a debug launch configuration is already available, the Debug command launches using the last debug launch configuration used with the project. </p>
-<div class="step">
- <h4>Launching a Program for Debugging </h4>
- <ul>
- <li>Click the Debug button (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) in the C/C++ perspective</li>
- <p>or</p>
- <li>Select Run > Debug from the menu bar </li>
- <p>Both of these methods create a new debug launch configuration if none previously existed in the project or uses the last one launched for debugging. </p>
- <li>To launch using a specific debug launch configuration, right-click the project's EXE file in the C/C++ Projects view and select Debug As > <em>Project_Name</em> from the C/C++ Projects context menu</li>
- </ul>
- <ul>
- <p>The debugger assumes control of the program execution as the program runs.</p>
- </ul>
-</div>
- <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
- <h5>Related references</h5>
- <ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
- </ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Debugging a Program</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debugging a Program</h2>
+<p>Use the <b>Debug</b> command (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) to execute a program under debugger control using the current <a href="../../reference/wnd_debug_configuration.htm">launch configuration</a> settings.</p>
+<p>If this is the first time the program is launched for debugging, a new debug launch configuration is automatically created for you based on current project settings and assigned a name. If a debug launch configuration is already available, the Debug command launches using the last debug launch configuration used with the project. </p>
+<div class="step">
+ <h4>Launching a Program for Debugging </h4>
+ <ul>
+ <li>Click the Debug button (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) in the C/C++ perspective</li>
+ <p>or</p>
+ <li>Select Run > Debug from the menu bar </li>
+ <p>Both of these methods create a new debug launch configuration if none previously existed in the project or uses the last one launched for debugging. </p>
+ <li>To launch using a specific debug launch configuration, right-click the project's EXE file in the C/C++ Projects view and select Debug As > <em>Project_Name</em> from the C/C++ Projects context menu</li>
+ </ul>
+ <ul>
+ <p>The debugger assumes control of the program execution as the program runs.</p>
+ </ul>
+</div>
+ <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
+ <h5>Related references</h5>
+ <ul>
+ <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
+ <li><a href="../../debugger/debug/viewing_debug.htm">Debug View</a></li>
+ </ul>
+ <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_disconnect.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,34 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Disconnecting the Debugger</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Disconnecting the Debugger</h2>
-<p>Use the <b>Disconnect</b> command (<img src="../../images/icons/btn_disconnect.png" width="20" height="21" align="absmiddle" />) when debugging with Application TRK or System TRK to detach the debugger from a process on the device while leaving the device running. </p>
-<p>When debugging in stop-mode it will detach the debugger and leave the CPU running on the device. </p>
-<div class="step">
- <h4>Disconnecting the Debugger </h4>
- <ul>
- <li>Click the Disconnect button (<img src="../../images/icons/btn_disconnect.png" width="20" height="21" align="absmiddle" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- </ul>
- <blockquote>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Right-click the thread in the Debug view and select Disconnect from the Debug context menu</li>
- </ul>
-</div>
- <h5>Related references</h5>
- <ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
- </ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_kill.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,45 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Killing Program Execution</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Terminate Program Execution</h2>
-<p>Use the <b>Terminate</b> command (<img src="../../images/icons/btn_terminate.png" width="17" height="15" align="absmiddle" />) to stop or halt a program based on the type of debugging session underway. Terminate behavior includes: </p>
-<ul>
- <li><b>Emulator</b> - terminates program execution and ends the debug session</li>
- <li><b>Application TRK</b> or <b>System TRK</b> - kills the process on the device and ends the debug session. To terminate without killing the process, use <a href="work_debug_act_disconnect.htm">Disconnect</a> instead. </li>
- <li><b>Stop-mode soft attach</b> - suspends the attached process while other processes continue to run on the device. If only a single process is running on the device, the device CPU is suspended. Once the CPU is suspended you must launch a new debug session to resume the device CPU. </li>
-</ul>
-<p>This behavior differs from <a href="work_debug_act_stop.htm">suspending</a> a program, as this temporarily suspends execution.</p>
-<p class="note"><b>NOTE</b> If the <a href="../../reference/view_debug.htm">Debug</a> view loses focus, the Terminate control will appear disabled. To regain focus, select a thread in the Debug view to update the tool bar and reactivate the Terminate control. </p>
-<div class="step">
- <h4>Terminating Program Execution </h4>
- <ul>
- <li>Click the Terminate button (<img src="../../images/icons/btn_terminate.png" width="17" height="15" align="absmiddle" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- </ul>
- <blockquote>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Right-click and select Terminate from the Debug context menu</li>
- <p>or</p>
- <li>Select Run > Terminate from the menu bar </li>
- <p>The debugger kills program execution and ends the debugging session.</p>
- <p class="note"><b>NOTE</b> If using an emulator, exiting it will also end the debugging session. </p>
- </ul>
-</div>
-<p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
-<h5>Related references</h5>
-<ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_restart.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,36 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Common Debugging Actions</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Restarting the Debugger</h2>
-<p>Use the <b>Restart</b> command (<img src="../../images/icons/btn_restart.png" width="20" height="18" align="absmiddle" />) after stopping program execution. The debugger goes back to the beginning of the program and begins execution again. This behavior is equivalent to killing execution, then starting a new debugging session.</p>
-<div class="step">
- <h4>Restarting the Debugger </h4>
- <ul>
- <li>Click the Restart button (<img src="../../images/icons/btn_restart.png" width="20" height="18" align="absmiddle" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- </ul>
- <blockquote>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Right-click the thread in the Debug view and select Restart from the Debug contextual menu</li>
- <p>or</p>
- <li>Select Run > Restart from the menu bar </li>
- </ul>
-</div>
- <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
- <h5>Related references</h5>
- <ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
- </ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_resume.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,41 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Resuming Program Execution</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Resuming Program Execution</h2>
-<p>Use the <b>Resume</b> command (<img src="../../images/icons/btn_resume.png" width="19" height="14" align="absmiddle" />) to continue executing a suspended debugging session. If the debugging session is already active, use this command to switch view from the Thread window to the executing program.</p>
-<p class="note"><b>NOTE</b> If the <a href="../../reference/view_debug.htm">Debug</a> view loses focus, the Resume control will appear disabled. To regain focus, select a thread in the Debug view to update the tool bar and reactivate the Resume control.</p>
-<div class="step">
- <h4>Resuming Program Execution </h4>
- <ul>
- <li>Click the Resume button (<img src="../../images/icons/btn_resume.png" width="19" height="14" align="absmiddle" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- </ul>
- <blockquote>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Right-click the thread in the Debug view and select Resume from the Debug contextual menu</li>
- </ul>
- <ul>
- <p>or</p>
- <li>Select Run > Resume from the menu bar </li>
- <p>The suspended session resumes, or the view changes to the running program.</p>
- </ul>
-</div>
-<p class="note"><b>NOTE</b> The Resume command appears only for those platforms that support it. If your platform does not support this command, you must stop the current debugging session and start a new session.</p>
- <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
- <h5>Related references</h5>
- <ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
- </ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_run.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,42 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Running a Program</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Running a Program</h2>
-<p>Use the <b>Run</b> command (<img src="../../images/icons/btn_run.png" width="16" height="16" align="absmiddle" />) to execute a program normally, without debugger control. If the target is an emulator, the emulator is launched and the program installed. Use the emulator controls to run the program within the emulator environment. If the target is not an emulator, the program is installed and can be run on the device like any other program.</p>
-<p>When starting the program for the first time, there are two types of launch configurations that you can choose between: </p>
-<ul>
- <li><b>Run As > Symbian OS Application</b> <em>— </em> select this option to create a new run <a href="../../projects/launch/launch_configs_overview.htm">launch configuration</a> for the project or run the the first launch configuration it finds in the run launch configuration list (starting at the top of the list). Basically, this is a shortcut to help you start debugging immediately.</li>
- <li><b>Open Run Dialog... </b><em>— </em>enables you to define one or more <a href="../projects/prj_debug_config.htm">launch configurations</a> for this project.</li>
-</ul>
-<div class="step">
- <h4>Running a Program </h4>
- <ul>
- <li>Click the Run (<img src="../../images/icons/btn_run.png" width="16" height="16" align="absmiddle" />) control in the tool bar </li>
- </ul>
- <blockquote>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Right-click the project's EXE file in the C/C++ Projects view and select Run As > <em>Project_Name</em> from the C/C++ Projects context menu</li>
- </ul>
- <ul>
- <p>The debugger does not control program execution as the program runs.</p>
- </ul>
-</div>
- <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
- <h5>Related references</h5>
- <ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
- </ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_start.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,45 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Starting the Debugger</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Starting the Debugger</h2>
-<p>Use the <b>Debug</b> command (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) to begin debugging a compiled program. The debugger takes control of program execution, starting at the main entry point of the program. When starting the debugger for the first time, there are two types of debug launch configurations that you can choose between: </p>
-<ul>
- <li><b>Debug As > Symbian OS Application</b> <em>— </em> select this option to create a new debug <a href="../../projects/launch/launch_configs_overview.htm">launch configuration</a> for the project or run the the first debug launch configuration it finds in the debug launch configuration list (starting at the top of the list). Basically, this is a shortcut to help you start debugging immediately.</li>
- <li><b>Open Debug Dialog... </b><em>— </em>enables you to define one or more <a href="../projects/prj_debug_config.htm">launch configurations</a> for this project.</li>
-</ul>
-<p>In the following steps, <i>Config_Name</i> refers to both debug launch configuration types. </p>
-<div class="step">
- <h4>Starting the Debugger </h4>
- <p class="note"><b>NOTE</b> You can only debug compiled programs. Use the <a href="../projects/prj_build.htm">Build Project</a> command to compile project sources into a binary file.</p>
- <ul>
- <li>Right-click the project's EXE file in the C/C++ Projects view and select Debug As > <em>Config_Name</em> from the C/C++ Projects contextual menu</li>
- <p>or</p>
- <li>Select the project to debug and click the Debug button (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" />) in the C/C++ perspective</li>
- </ul>
- <blockquote>
- <p class="note"><b>NOTE</b> If you don't see the Debug button on your EXE file you'll need to define a <a href="../projects/prj_debug_config.htm">Configuration</a> for the program.</p>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Select the project to debug and then select Run > Debug As > <em>Config_Name</em> from the menu bar </li>
- <p>The current routine executes and returns to its caller, then program execution stops</p>
- </ul>
-</div>
-<p class="note"><b>NOTE</b> Some projects require additional configuration before the debugging session can begin. The IDE might prompt you for permission to perform this configuration automatically.</p>
- <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
- <h5>Related references</h5>
- <ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
- </ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_stepinto.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,44 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Stepping Into a Routine</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Stepping Into a Routine</h2>
-<p>Use the <b>Step Into</b> command (<img src="../../images/icons/btn_stepinto.png" width="18" height="14" />) to execute one source-code statement at a time and follow execution into a routine call.</p>
-<p>When stepping through a program in a debug session the IDE attempts to match the program counter (PC) location in the executable with a known project source file. If there is no source file associated with the PC the debugger displays in the Debug view the current PC address of the thread (e.g. <span class="code">0x6002CC11(EUSER.DLL)()</span>) instead of the function name. At this point you can open the Disassembly view to step through the assembler code. This most commonly happens when trying to step into Symbian OS code. We recommend that you <a href="work_debug_act_stepover.htm">Step Return</a> out of the OS code and back into your project to continue debugging.<br />
-</p>
-<div class="step">
- <h4>Stepping Into a Routine </h4>
- <ul>
- <li>Click the Step Into button (<img src="../../images/icons/btn_stepinto.png" width="18" height="14" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- </ul>
- <blockquote>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Right-click the thread in the Debug view and select Step Into from the Debug contextual menu</li>
- <p>or</p>
- <li>Select Run > Step Into from the menu bar </li>
- <p>After the debugger executes the source-code statement, the current-statement arrow moves to the next statement determined by these rules:</p>
- <ul>
- <li>If the executed statement did not call a routine, the current-statement arrow moves to the next statement in the source code.</li>
- <li>If the executed statement called a routine, the current-statement arrow moves to the first statement in the called routine.</li>
- <li>If the executed statement is the last statement in a called routine, the current-statement arrow moves to the statement that follows the calling routine.</li>
- </ul>
- </ul>
-</div>
-<p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
-<h5>Related references</h5>
-<ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_stepout.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,38 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Step Return Out of a Routine</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Step Return Out of a Routine</h2>
-Use the <b>Step Return</b> command (<img src="../../images/icons/btn_stepreturn.png" width="17" height="14" />) to execute the rest of the current routine and stop program execution after the routine returns to its caller.
-<p>This command causes execution to return up the calling chain.</p>
-<div class="step">
- <h4>Step Returning from a Routine </h4>
- <ul>
- <li>Click the Step Return button (<img src="../../images/icons/btn_stepreturn.png" width="17" height="14" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- </ul>
- <blockquote>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Right-click the thread in the Debug view, then select Step Return from the Debug context menu</li>
- <p>or</p>
- <li>Select Run > Step Return from the menu bar </li>
- <p>The current routine executes and returns to its caller, then program execution stops</p>
- </ul>
-</div>
- <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
-<h5>Related references</h5>
-<ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_stepover.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,43 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Stepping Over a Statement</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Stepping Over a Statement </h2>
-<p>Use the <b>Step Over</b> command (<img src="../../images/icons/btn_stepover.png" width="19" height="14" />) to execute the current statement and advance to the next statement in the source code. If the current statement is a routine call, program execution continues until reaching one of these points:</p>
-<ul>
- <li>the end of the called routine</li>
- <li>a breakpoint</li>
- <li>a watchpoint</li>
- <li>an eventpoint that stops execution</li>
-</ul>
-<div class="step">
- <h4>Stepping Over a Routine </h4>
- <ul>
- <li>Click the Step Over button (<img src="../../images/icons/btn_stepover.png" width="19" height="14" />) in the <a href="../../reference/view_debug.htm">Debug</a> view </li>
- </ul>
- <blockquote>
- <p>or</p>
- </blockquote>
- <ul>
- <li>Right-click the thread in the Debug view and select Step Over from the Debug contextual menu</li>
- <p>or</p>
- <li>Select Run > Step Over from the menu bar </li>
- <p>The current statement or routine executes, then program execution stops.</p>
- </ul>
-</div>
- <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
-<h5>Related references</h5>
-<ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/work_debug_act_stop.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,30 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Suspending Program Execution</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Suspending Program Execution</h2>
-<p>Use the <b>Suspend</b> command (<img src="../../images/icons/btn_suspend.png" width="17" height="17" align="absmiddle" />) to stop program execution during a debugging session.</p>
-<div class="step">
- <h4>Stopping a Debug Session </h4>
- <ol>
- <li>Select the thread in the <a href="../../reference/view_debug.htm">Debug</a> view to suspend</li>
- <li>Click the Suspend (<img src="../../images/icons/btn_suspend.png" width="17" height="17" align="absmiddle" />) button, or right-click the thread and select Suspend</li>
- </ol>
- <p>The operating system surrenders control to the debugger, which suspends program execution.</p>
-</div>
- <p>For more information on debugging, see <b>C/C++ Development User Guide > Tasks > Running and debugging projects > Debugging</b>.</p>
-<h5>Related references</h5>
-<ul>
- <li><a href="../../concepts/working_with_debugger.htm">Working with the Debugger </a></li>
- <li><a href="../../reference/view_debug.htm">Debug View</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/processes/attach_debugger_to_process.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/processes/attach_debugger_to_process.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,46 +1,46 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Attaching to a Symbian OS Process</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Attaching to a Symbian OS Process</h2>
-<div>
- <p>Use the <b>Symbian OS Attach to Process</b> launch configuration to attach the debugger to an already running Symbian OS process or thread on a target device. This is useful for debugging servers running in RAM in a client-server relationship where the client relies on the presence of the server process to operate as one example.</p>
- <p><span class="note">You can also attach to a process in the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view when debugging.</span></p>
- <p class="note"><b>NOTE</b> You cannot attach to a process running on the emulator. It must be a target device running the Symbian OS and the TRK debug agent.</p>
- <p>When attempting to find a process the debugger uses the UID3 to locate the process. </p>
- <div class="step">
- <h4>Attaching to a Symbian OS Process</h4>
- <ol>
- <li><a href="../projects/prj_import_exe.htm">Import an executable</a> to import it into the <a href="../../reference/view_executables.htm">Executables</a> view </li>
- <li>Select any project in the workspace or the binary to attach to in the Executables view</li>
- <p>In this example, we select the Executables project created when the binary was imported from the Project Explorer view (Figure 1). </p>
- <p align="center"><img src="images/sos_processes_executables.png" width="258" height="189"></p>
- <p class="figure">Figure 1 - Executables project created when importing an executable </p>
- <li>Click Debug (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">) to launch the <a href="../projects/wiz_new_launch_config.htm">New Configuration Launch Wizard</a> </li>
- <li>Select the Attach to Process Launch Configuration option and fill in the requested information</li>
- <li>Click Debug</li>
- <p>The <b>Attach to Process </b>window appears. Click a column title to sort the processes in ascending or descending order to help you locate a specific process or use the filter text box to show specific processes. </p>
- <p align="center"><img src="images/sos_processes_choose_thread.png" width="300" height="375" /></p>
- <p class="figure">Figure 2 -<b> Attach to Process</b> window </p>
- <li>Select a process, click OK</li>
- <p>The <b>Attach to Process </b>window closes. Open a <a href="../../reference/view_symbian_kernel.htm">Symbian OS</a> view to show the process and thread information.</p>
- <p class="note"><b>NOTE</b> Terminating an Attach to Process session actually kills the process on the device. This means you must restart the process on the device in order to attach to it again. </p>
- </ol>
- </div>
-</div>
-<h5>Related references</h5>
-<ul>
- <li><a href="../../reference/view_debug.htm">Debug View</a></li>
- <li><a href="../../reference/wnd_debug_configuration.htm">Debug Window </a></li>
- <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS View</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Attaching to a Symbian OS Process</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Attaching to a Symbian OS Process</h2>
+<div>
+ <p>Use the <b>Symbian OS Attach to Process</b> launch configuration to attach the debugger to an already running Symbian OS process or thread on a target device. This is useful for debugging servers running in RAM in a client-server relationship where the client relies on the presence of the server process to operate as one example.</p>
+ <p><span class="note">You can also attach to a process in the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view when debugging.</span></p>
+ <p class="note"><b>NOTE</b> You cannot attach to a process running on the emulator. It must be a target device running the Symbian OS and the TRK debug agent.</p>
+ <p>When attempting to find a process the debugger uses the UID3 to locate the process. </p>
+ <div class="step">
+ <h4>Attaching to a Symbian OS Process</h4>
+ <ol>
+ <li><a href="../projects/prj_import_exe.htm">Import an executable</a> to import it into the <a href="../../reference/view_executables.htm">Executables</a> view </li>
+ <li>Select any project in the workspace or the binary to attach to in the Executables view</li>
+ <p>In this example, we select the Executables project created when the binary was imported from the Project Explorer view (Figure 1). </p>
+ <p align="center"><img src="images/sos_processes_executables.png" width="258" height="189"></p>
+ <p class="figure">Figure 1 - Executables project created when importing an executable </p>
+ <li>Click Debug (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">) to launch the <a href="../../projects/launch/wiz_new_launch_config.htm">New Configuration Launch Wizard</a> </li>
+ <li>Select the Attach to Process Launch Configuration option and fill in the requested information</li>
+ <li>Click Debug</li>
+ <p>The <b>Attach to Process </b>window appears. Click a column title to sort the processes in ascending or descending order to help you locate a specific process or use the filter text box to show specific processes. </p>
+ <p align="center"><img src="images/sos_processes_choose_thread.png" width="300" height="375" /></p>
+ <p class="figure">Figure 2 -<b> Attach to Process</b> window </p>
+ <li>Select a process, click OK</li>
+ <p>The <b>Attach to Process </b>window closes. Open a <a href="../../reference/view_symbian_kernel.htm">Symbian OS</a> view to show the process and thread information.</p>
+ <p class="note"><b>NOTE</b> Terminating an Attach to Process session actually kills the process on the device. This means you must restart the process on the device in order to attach to it again. </p>
+ </ol>
+ </div>
+</div>
+<h5>Related references</h5>
+<ul>
+ <li><a href="../../debugger/debug/viewing_debug.htm">Debug View</a></li>
+ <li><a href="../../reference/wnd_debug_configuration.htm">Debug Window </a></li>
+ <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS View</a> </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/processes/images/launch_config_toolbar.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/processes/images/new_config.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/processes/images/sos_processes_attach.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/add_build_config_create_wnd.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/icon_add_item_to_list.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/menu_build_config_select_tgt_02.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/menu_prj_debugas_debug.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/menu_prj_debugas_sos_menu.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/new_launch_config_wiz.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/page_debug_app.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/page_debug_dlls.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/page_debug_dlls_02.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/page_debug_dlls_bld_tgt.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/page_debug_dlls_cpp_view.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/pref_launching.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/proj_prop_builders.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/run_config_device.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/symprojnav_mmp.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/view_cpp_prj_mutli_build_01.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/view_cpp_prj_mutli_build_02.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/view_cpp_prj_mutli_build_03.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/view_cpp_prj_mutli_build_04.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/view_hellocarbide_cpp_view.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wiz_add_sos_class_01.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wiz_add_sos_class_02.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wnd_debug_configuration.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wnd_import_executable_03.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wnd_import_executable_04.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wnd_import_executable_07.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wnd_import_executable_08.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wnd_prj_freeze_def_files.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/images/wnd_prj_props_createsis.png has changed
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_creating_sis_file.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_creating_sis_file.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,63 +1,63 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Working with PKG and SIS Files</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2><b>Creating a .SIS File</b></h2>
-<p>Carbide.c++ attempts to build SIS files for all phone targets when a PKG file exists in a given build project. More than one SIS/PKG file can be included and built by a project, but only one can be downloaded to the device for debugging purposes. </p>
-<p>There are three main tools involved in generating SIS files from PKG files.</p>
-<ul>
- <li>Makekeys - We invoke this tool when you don't specify a key/cert pair for OS
- 9.x SIS file creation.</li>
- <li>Makesis — This tool takes a single PKG file as input and generates an unsigned SIS file. This is generally sufficient to run an application on a pre platform security device (EKA1). This tool is also used to generate SIS files for Platform Security, but in that case <span class="code">signsis</span> must be used.</li>
- <li>Signsis — This tool is used to sign a SIS file generated by <span class="code">makesis</span>. This tool is not available on all SDKs. This tool requires an existing certificate/key pair and does not randomly generate the pair for self-signing.</li>
-</ul>
-<p>When a phone target build detects a PKG file at the end of a build, a post-link stage will be executed to create a SIS file, that is: </p>
-<ul>
- <li>For non-Platform Security SDKs (pre-OS 9.x), <span class="code">makesis</span> is called</li>
-</ul>
-<p>Depending upon which tool is used, you will need to complete some entries in the<a href="../../reference/build_properties/pane_build_config_sis.htm"> SIS Builder</a> pane of the Carbide Build Configurations window of the project Properties dialog box. You can access this pane by selecting a project in the C/C++ Projects view and select <b>Project > Properties</b> > <b>Carbide Build Configurations</b>. Fill in the necessary information to add PKG files to the project for downloading. </p>
-<table width="88%" border="0" cellpadding="2" cellspacing="0">
- <tr>
- <th width="19%" scope="col">Tool</th>
- <th width="81%" scope="col">Explanation</th>
- </tr>
- <tr>
- <td><b>SIS Builder </b></td>
- <td><p>Use the <b>Add</b> control to add one or more SIS or PKG files to the project up to the maximum number Carbide supports. Note that the <b>SIS Builder</b> pane operates on a build configuration level. You will need to add files in this pane for every build configuration in the project. </p>
- <p>In addition, any PKG file added here is picked up by the <a href="../../reference/launch_configs/app_trk_installation.htm">Installation</a> tab in Application TRK configurations. However, as only one SIS file can be debugged at a time you must specify which SIS/PKG file to install for debugging purposes. This is handy if you have both a developer SIS file and a certified SIS file that you want to remain in sync during development. Both are always built but you only need to debug one. </p>
- <p><img src="images/sis_builder_tab.png" width="550" height="221" /></p>
- <p class="figure">Figure 1 - SIS Builder tab </p></td>
- </tr>
- <tr>
- <td><b>SIS Properties </b></td>
- <td><div align="center">
- <p align="left">Complete the PKG File, and Signing Options settings in the <a href="../../reference/build_properties/wnd_sis_properties.htm">SIS Properties</a> dialog. By default, SIS files are output in the directory of the original SIS file.</p>
- <p><img src="../../reference/images/wnd_sis_properties.png" width="455" height="452"></p>
- <p class="figure">Figure 2 - SIS Properties dialog </p>
- </div></td>
- </tr>
-</table>
-<p>For phones that utilize OS 9.x, all SIS files must be signed before being installed on a device. You can specify your certificate and key pair file in the SIS Builder pane. By default, if no certificate/key pair is defined, temporary ones will be created in the build directory. This is a process called self-signing. However, not all devices allow self-signed applications to be installed. For information on obtaining certificate and key pairs for your development please visit <a href="https://www.symbiansigned.com">https://www.symbiansigned.com</a>.</p>
-<p><b>Self-signing Tips</b></p>
-<p>The MMP file must have certain keywords specified correctly including: </p>
-<ul>
- <li>The keyword <span class="code">uid3</span> must be specified in the correct range. See <a href="https://www.symbiansigned.com/app/page/uidfaq">https://www.symbiansigned.com/app/page/uidfaq</a> for more info.</li>
- <li>VendorID requires a value, even if its zero (<span class="code">VENDORID 0</span>) </li>
- <li>Capability requires a value, in this case none (<span class="code">CAPABILITY none</span>) </li>
-</ul>
-<p>Failure to include the above keywords can cause a self-signed APP/DLL process to fail to launch.</p>
-<p>After you have a valid .sis file, it will need to be uploaded to the target device. The sis file is uploaded and installed automatically once you run a Debug launch configuration.</p>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="../start/carbide_deploying.htm">Manually Deploying Programs to Devices</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Working with PKG and SIS Files</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2><b>Creating a .SIS File</b></h2>
+<p>Carbide.c++ attempts to build SIS files for all phone targets when a PKG file exists in a given build project. More than one SIS/PKG file can be included and built by a project, but only one can be downloaded to the device for debugging purposes. </p>
+<p>There are three main tools involved in generating SIS files from PKG files.</p>
+<ul>
+ <li>Makekeys - We invoke this tool when you don't specify a key/cert pair for OS
+ 9.x SIS file creation.</li>
+ <li>Makesis — This tool takes a single PKG file as input and generates an unsigned SIS file. This is generally sufficient to run an application on a pre platform security device (EKA1). This tool is also used to generate SIS files for Platform Security, but in that case <span class="code">signsis</span> must be used.</li>
+ <li>Signsis — This tool is used to sign a SIS file generated by <span class="code">makesis</span>. This tool is not available on all SDKs. This tool requires an existing certificate/key pair and does not randomly generate the pair for self-signing.</li>
+</ul>
+<p>When a phone target build detects a PKG file at the end of a build, a post-link stage will be executed to create a SIS file, that is: </p>
+<ul>
+ <li>For non-Platform Security SDKs (pre-OS 9.x), <span class="code">makesis</span> is called</li>
+</ul>
+<p>Depending upon which tool is used, you will need to complete some entries in the<a href="../../reference/build_properties/pane_build_config_sis.htm"> SIS Builder</a> pane of the Carbide Build Configurations window of the project Properties dialog box. You can access this pane by selecting a project in the C/C++ Projects view and select <b>Project > Properties</b> > <b>Carbide Build Configurations</b>. Fill in the necessary information to add PKG files to the project for downloading. </p>
+<table width="88%" border="0" cellpadding="2" cellspacing="0">
+ <tr>
+ <th width="19%" scope="col">Tool</th>
+ <th width="81%" scope="col">Explanation</th>
+ </tr>
+ <tr>
+ <td><b>SIS Builder </b></td>
+ <td><p>Use the <b>Add</b> control to add one or more SIS or PKG files to the project up to the maximum number Carbide supports. Note that the <b>SIS Builder</b> pane operates on a build configuration level. You will need to add files in this pane for every build configuration in the project. </p>
+ <p>In addition, any PKG file added here is picked up by the <a href="../../projects/launch/page_installation.htm">Installation</a> tab in Application TRK configurations. However, as only one SIS file can be debugged at a time you must specify which SIS/PKG file to install for debugging purposes. This is handy if you have both a developer SIS file and a certified SIS file that you want to remain in sync during development. Both are always built but you only need to debug one. </p>
+ <p><img src="images/sis_builder_tab.png" width="550" height="221" /></p>
+ <p class="figure">Figure 1 - SIS Builder tab </p></td>
+ </tr>
+ <tr>
+ <td><b>SIS Properties </b></td>
+ <td><div align="center">
+ <p align="left">Complete the PKG File, and Signing Options settings in the <a href="../../reference/build_properties/wnd_sis_properties.htm">SIS Properties</a> dialog. By default, SIS files are output in the directory of the original SIS file.</p>
+ <p><img src="../../reference/images/wnd_sis_properties.png" width="455" height="452"></p>
+ <p class="figure">Figure 2 - SIS Properties dialog </p>
+ </div></td>
+ </tr>
+</table>
+<p>For phones that utilize OS 9.x, all SIS files must be signed before being installed on a device. You can specify your certificate and key pair file in the SIS Builder pane. By default, if no certificate/key pair is defined, temporary ones will be created in the build directory. This is a process called self-signing. However, not all devices allow self-signed applications to be installed. For information on obtaining certificate and key pairs for your development please visit <a href="https://www.symbiansigned.com">https://www.symbiansigned.com</a>.</p>
+<p><b>Self-signing Tips</b></p>
+<p>The MMP file must have certain keywords specified correctly including: </p>
+<ul>
+ <li>The keyword <span class="code">uid3</span> must be specified in the correct range. See <a href="https://www.symbiansigned.com/app/page/uidfaq">https://www.symbiansigned.com/app/page/uidfaq</a> for more info.</li>
+ <li>VendorID requires a value, even if its zero (<span class="code">VENDORID 0</span>) </li>
+ <li>Capability requires a value, in this case none (<span class="code">CAPABILITY none</span>) </li>
+</ul>
+<p>Failure to include the above keywords can cause a self-signed APP/DLL process to fail to launch.</p>
+<p>After you have a valid .sis file, it will need to be uploaded to the target device. The sis file is uploaded and installed automatically once you run a Debug launch configuration.</p>
+<h5>Related tasks</h5>
+<ul>
+ <li><a href="../start/carbide_deploying.htm">Manually Deploying Programs to Devices</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_debug_config.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_debug_config.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,101 +1,100 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
- <meta http-equiv="Content-Type"
- content="text/html; charset=ISO-8859-1" />
- <meta http-equiv="Content-Style-Type" content="text/css" />
- <meta name="LASTUPDATED" content="06/17/05 11:09:43" />
- <title>Creating a Launch Configuration</title>
- <link rel="StyleSheet" href="../../../book.css" type="text/css" />
-</head>
-<body bgcolor="#ffffff">
-<h2>Creating a Launch Configuration</h2>
-<p>To run or debug a project you need a <a href="../../projects/launch/launch_configs_overview.htm">launch configuration</a>. A project must have at least one launch configuration, and can have as many as necessary. When run on an emulator project the wizard simply creates an emulator launch configuration and launches the emulator. When running a device project for the first time the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> seeks additional information required to create the launch configuration, then downloads the executable to the device and launches it. Once the emulator or device are loaded with the executable, the debug session can commence. </p>
-<p>There are two methods for setting up a launch configuration, including:</p>
-<ul>
- <li><b>Default launch configuration</b>— automatically sets up a default launch configuration to run or debug the project on the first Run or Debug execution. This provides a quick and easy method to start running or debugging a new project without the hassle of setting a lot of options. The default launch configuration can always be edited later as the project launch requirements change.</li>
- <li><b>Custom launch configuration</b>— enables you to setup a custom launch configuration to debug the project</li>
-</ul>
-<div class="step">
-<h4>Creating a Default Launch Configuration</h4>
-<p class="note"><b>NOTE</b> Carbide.c++ only creates a new default launch configuration when it cannot find one in the project. If the project already contains a launch configuration, Carbide.c++ launches that instead. </p>
-<ul>
- <li>Click the <b>Run</b> (<img src="../../images/icons/btn_run.png" alt="Run icon" width="16" height="16" align="middle" />) or <b>Debug</b> (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="middle" alt="Debug icon"/>) icon in the tool bar
- <p>or</p>
- </li>
- <li>Choose Select <b>Run > Run</b> menu option to launch the project or <b>Run > Debug</b> menu option to debug the project</li>
- <p>Carbide.c++ creates a default launch configuration for the project and begins running or debugging the project. If the project already has a defined launch configuration, clicking Run or Debug uses it instead of creating a new one. There are two possible scenarios when creating a default launch configuration: </p>
- <ul>
- <li><b>for emulator targets </b> - an emulator launch configuration is created based on the project settings </li>
- <li><b>for target devices</b> - the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> appears asking for additional information</li>
- </ul>
-</ul>
-</div>
- <p class="note"><b>NOTE</b> To see if a project already has a launch configuration, open a Run or Debug window using the <b>Run > Open Run Dialog...</b> or <b>Run > Open Debug Dialog...</b> menu items.
- </blockquote>
- </p>
- <p>In the event that the default launch configuration settings need to be changed, it is possible to edit them in the <a href="../../reference/wnd_debug_configuration.htm">Debug</a> window, or create a new launch configuration for the project that deviates from the default settings.</p>
-<div class="step">
-<h4>Creating a Custom Launch Configuration </h4>
-<ol>
- <li>Open the Run or Debug launch configuration window
- <ul>
- <li>Select the Run> <b>Open Run Dialog</b>... or <b>Run > Open Debug Dialog... </b> menu item
- <p>The appropriate Run or <a href="../../reference/wnd_debug_configuration.htm">Debug</a> launch configuration window appears (Figure 1).</p>
- </li>
- </ul>
- <p align="center"><img src="images/wnd_launch_configuration_blank.png" width="709" height="455" alt="Undefined launch configuration"/> </p>
- <p class="figure">Figure 1 - Initial blank Debug launch configuration window</p>
- </li>
- <li>Select a type of launch configuration (for example, Symbian OS Emulation), then click the New launch configuration icon to create a new
- configuration of that type.
- <p>A new configuration appears in the Configuration list under the
- appropriate section using the project name and target to create the configuration name.</p>
- <p class="note"><b>NOTE</b> By default, when you click New, the project information is used to fill in the Project and Process to launch text boxes. You normally should not have to edit these for a run/debug a project. If a bld.inf has multiple MMPS then the first executable named in the list of MMP files is used to fill in the executable field. Therefore, for projects with multiple MMPs you may need to change the executable field. </p>
- </li>
- <p align="center"><img src="images/run_config_new.png" width="787" height="489" alt="New launch configuration" /> </p>
- <p class="figure">Figure 2 - New launch configuration with name and settings filled in (emulator)</p>
- </li>
- <li>View the information to define the project and executable
- <p>Modify or fill in the following fields in the Main tab so the IDE
- can setup the configuration properly each time. Typically when creating
- a new executable from a project that has successfully linked, the
- fields will be auto-populated and do not need to be modified. The important fields here are:</p>
- <ul>
- <li>Name - <span style="font-weight: normal;">This is a unique name to identify this debug launch configuration. It can be any name.</span> </li>
- <li>Project - <span style="font-weight: normal;">The project to associate with this debug launch configuration. Click Browse to select a different project.</span></li>
- <li>Process to launch - <span style="font-weight: normal;">This is the name of the executable that is linked to the project.</span></li>
- </ul>
- </li>
-
- <li>Modify settings in the other Carbide tabs to customize the launch configuration
- for the project
- <ul>
- <li>Environment (<i>Eclipse</i>) </li>
- <li><a href="../../reference/launch_configs/emulator_debugger.htm">Debugger</a></li>
- <li><a href="../../reference/launch_configs/page_executables.htm">Executables</a></li>
- <li><a href="../../reference/wnd_carbide_pref_x86.htm">x86 Exceptions</a> </li>
- <li>Arguments (<i>Eclipse</i>) </li>
- <li>Source (<i>Eclipse</i>) </li>
- <li>Common (<i>Eclipse</i>) </li>
- </ul>
- <p>To debug something outside of the workspace, be sure to import the binary into the <a href="../../reference/view_executables.htm">Executables</a> view. </p>
- </li>
- <li>Click Debug
- <p>The IDE launches the executable. If the launch configuration is set to change perspective, it switches to the specified perspective. </p>
- </li>
-</ol>
-</div>
-<h5>Other references</h5>
- <ul>
- <li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configurations</a> </li>
- <li><a href="../../concepts/Projects.html">Projects</a></li>
- <li><a href="../CreatingNewProjects.html">Creating Projects</a></li>
- <li><a href="prj_build.htm">Building Projects</a></li>
- <li><a href="prj_debug_dlls.htm">Debugging DLLs</a></li>
- <li><a href="../../reference/view_executables.htm">Executables</a> view </li>
-</ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+ <meta http-equiv="Content-Type"
+ content="text/html; charset=ISO-8859-1" />
+ <meta http-equiv="Content-Style-Type" content="text/css" />
+ <meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+ <title>Creating a Launch Configuration</title>
+ <link rel="StyleSheet" href="../../../book.css" type="text/css" />
+</head>
+<body bgcolor="#ffffff">
+<h2>Creating a Launch Configuration</h2>
+<p>To run or debug a project you need a <a href="../../projects/launch/launch_configs_overview.htm">launch configuration</a>. A project must have at least one launch configuration, and can have as many as necessary. When run on an emulator project the wizard simply creates an emulator launch configuration and launches the emulator. When running a device project for the first time the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> seeks additional information required to create the launch configuration, then downloads the executable to the device and launches it. Once the emulator or device are loaded with the executable, the debug session can commence. </p>
+<p>There are two methods for setting up a launch configuration, including:</p>
+<ul>
+ <li><b>Default launch configuration</b>— automatically sets up a default launch configuration to run or debug the project on the first Run or Debug execution. This provides a quick and easy method to start running or debugging a new project without the hassle of setting a lot of options. The default launch configuration can always be edited later as the project launch requirements change.</li>
+ <li><b>Custom launch configuration</b>— enables you to setup a custom launch configuration to debug the project</li>
+</ul>
+<div class="step">
+<h4>Creating a Default Launch Configuration</h4>
+<p class="note"><b>NOTE</b> Carbide.c++ only creates a new default launch configuration when it cannot find one in the project. If the project already contains a launch configuration, Carbide.c++ launches that instead. </p>
+<ul>
+ <li>Click the <b>Run</b> (<img src="../../images/icons/btn_run.png" alt="Run icon" width="16" height="16" align="middle" />) or <b>Debug</b> (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="middle" alt="Debug icon"/>) icon in the tool bar
+ <p>or</p>
+ </li>
+ <li>Choose Select <b>Run > Run</b> menu option to launch the project or <b>Run > Debug</b> menu option to debug the project</li>
+ <p>Carbide.c++ creates a default launch configuration for the project and begins running or debugging the project. If the project already has a defined launch configuration, clicking Run or Debug uses it instead of creating a new one. There are two possible scenarios when creating a default launch configuration: </p>
+ <ul>
+ <li><b>for emulator targets </b> - an emulator launch configuration is created based on the project settings </li>
+ <li><b>for target devices</b> - the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> appears asking for additional information</li>
+ </ul>
+</ul>
+</div>
+ <p class="note"><b>NOTE</b> To see if a project already has a launch configuration, open a Run or Debug window using the <b>Run > Open Run Dialog...</b> or <b>Run > Open Debug Dialog...</b> menu items.
+
+ </p>
+ <p>In the event that the default launch configuration settings need to be changed, it is possible to edit them in the <a href="../../reference/wnd_debug_configuration.htm">Debug</a> window, or create a new launch configuration for the project that deviates from the default settings.</p>
+<div class="step">
+<h4>Creating a Custom Launch Configuration </h4>
+<ol>
+ <li>Open the Run or Debug launch configuration window
+ <ul>
+ <li>Select the Run> <b>Open Run Dialog</b>... or <b>Run > Open Debug Dialog... </b> menu item
+ <p>The appropriate Run or <a href="../../reference/wnd_debug_configuration.htm">Debug</a> launch configuration window appears (Figure 1).</p>
+ </li>
+ </ul>
+ <p align="center"><img src="images/wnd_launch_configuration_blank.png" width="709" height="455" alt="Undefined launch configuration"/> </p>
+ <p class="figure">Figure 1 - Initial blank Debug launch configuration window</p>
+ </li>
+ <li>Select a type of launch configuration (for example, Symbian OS Emulation), then click the New launch configuration icon to create a new
+ configuration of that type.
+ <p>A new configuration appears in the Configuration list under the
+ appropriate section using the project name and target to create the configuration name.</p>
+ <p class="note"><b>NOTE</b> By default, when you click New, the project information is used to fill in the Project and Process to launch text boxes. You normally should not have to edit these for a run/debug a project. If a bld.inf has multiple MMPS then the first executable named in the list of MMP files is used to fill in the executable field. Therefore, for projects with multiple MMPs you may need to change the executable field. </p>
+ </li>
+ <p align="center"><img src="images/run_config_new.png" width="787" height="489" alt="New launch configuration" /> </p>
+ <p class="figure">Figure 2 - New launch configuration with name and settings filled in (emulator)</p>
+
+ <li>View the information to define the project and executable
+ <p>Modify or fill in the following fields in the Main tab so the IDE
+ can setup the configuration properly each time. Typically when creating
+ a new executable from a project that has successfully linked, the
+ fields will be auto-populated and do not need to be modified. The important fields here are:</p>
+ <ul>
+ <li>Name - <span style="font-weight: normal;">This is a unique name to identify this debug launch configuration. It can be any name.</span> </li>
+ <li>Project - <span style="font-weight: normal;">The project to associate with this debug launch configuration. Click Browse to select a different project.</span></li>
+ <li>Process to launch - <span style="font-weight: normal;">This is the name of the executable that is linked to the project.</span></li>
+ </ul>
+ </li>
+
+ <li>Modify settings in the other Carbide tabs to customize the launch configuration
+ for the project
+ <ul>
+ <li>Environment (<i>Eclipse</i>) </li>
+ <li><a href="../../projects/launch/page_debugger.htm">Debugger</a></li>
+ <li><a href="../../projects/launch/page_executables.htm">Executables</a></li>
+ <li><a href="../../projects/launch/page_exceptions.htm">x86 Exceptions</a> </li>
+ <li>Arguments (<i>Eclipse</i>) </li>
+ <li>Source (<i>Eclipse</i>) </li>
+ <li>Common (<i>Eclipse</i>) </li>
+ </ul>
+ <p>To debug something outside of the workspace, be sure to import the binary into the <a href="../../reference/view_executables.htm">Executables</a> view. </p>
+ </li>
+ <li>Click Debug
+ <p>The IDE launches the executable. If the launch configuration is set to change perspective, it switches to the specified perspective. </p>
+ </li>
+</ol>
+</div>
+<h5>Other references</h5>
+ <ul>
+ <li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configurations</a> </li>
+ <li><a href="../../concepts/Projects.html">Projects</a></li>
+ <li><a href="../CreatingNewProjects.html">Creating Projects</a></li>
+ <li><a href="prj_build.htm">Building Projects</a></li>
+ <li><a href="prj_debug_dlls.htm">Debugging DLLs</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_debug_rom.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/prj_debug_rom.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,32 +1,32 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debugging in ROM</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debugging in ROM</h2>
-<p>You will see symbolic information for other components when you are debugging in ROM using System TRK if those components were built with symbolic information and the ROM Log file is specified. If a function in the stack crawl is in a ROM module and the IDE is able to find a file containing symbolic information for that module, the IDE will load it automatically and display function names. The IDE will also allow source level debugging and let you set breakpoints in this module. </p>
-<p>Some issues to pay attention to when debugging include: </p>
-<ul>
- <li>In System TRK you must specify the ROM log file in the <a href="../../reference/launch_configs/sys_trk_rom_log.htm">ROM Log</a> tab of the TRK or Attach to Process launch configurations</li>
-</ul>
-<blockquote>
- <p class="note"><b>NOTE</b> You cannot debug ROM DLLs using Application TRK. </p>
-</blockquote>
-<ul>
- <li>In Sophia or Trace32 you must specify the ROM log file in the ROM Image tab of the <a href="../../reference/wnd_Trace32_config.htm#ROM">Trace32</a> or <a href="../../reference/wnd_sophia_config.htm#ROM">Sophia</a> launch configuration</li>
-</ul>
-<h5>Other references </h5>
-<ul>
- <li><a href="prj_import_exe.htm">Importing Executables for Debugging</a></li>
- <li><a href="../../reference/wnd_Trace32_config.htm">Symbian OS Trace32 Support</a></li>
- <li><a href="../../reference/wnd_sophia_config.htm">Symbian OS Sophia Target Interface Support</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Debugging in ROM</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debugging in ROM</h2>
+<p>You will see symbolic information for other components when you are debugging in ROM using System TRK if those components were built with symbolic information and the ROM Log file is specified. If a function in the stack crawl is in a ROM module and the IDE is able to find a file containing symbolic information for that module, the IDE will load it automatically and display function names. The IDE will also allow source level debugging and let you set breakpoints in this module. </p>
+<p>Some issues to pay attention to when debugging include: </p>
+<ul>
+ <li>In System TRK you must specify the ROM log file in the <a href="../../projects/launch/page_rom_log.htm">ROM Log</a> tab of the TRK or Attach to Process launch configurations</li>
+</ul>
+<blockquote>
+ <p class="note"><b>NOTE</b> You cannot debug ROM DLLs using Application TRK. </p>
+</blockquote>
+<ul>
+ <li>In Sophia or Trace32 you must specify the ROM log file in the ROM Image tab of the <a href="../../projects/launch/trace32.htm">Trace32</a> or <a href="../../projects/launch/sophia.htm">Sophia</a> launch configuration</li>
+</ul>
+<h5>Other references </h5>
+<ul>
+ <li><a href="prj_import_exe.htm">Importing Executables for Debugging</a></li>
+ <li><a href="../../projects/launch/trace32.htm">Symbian OS Trace32 Support</a></li>
+ <li><a href="../../projects/launch/sophia.htm">Symbian OS Sophia Target Interface Support</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/wiz_new_launch_config.htm Mon Aug 10 14:45:48 2009 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,95 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
- <meta http-equiv="Content-Type"
- content="text/html; charset=ISO-8859-1" />
- <meta http-equiv="Content-Style-Type" content="text/css" />
- <meta name="LASTUPDATED" content="06/17/05 11:09:43" />
- <title>New Launch Configuration Wizard</title>
- <link rel="StyleSheet" href="../../../book.css" type="text/css" />
-</head>
-<body bgcolor="#ffffff">
-<h2>New Launch Configuration Wizard </h2>
-<p>The <b>New Launch Configuration Wizard</b> launches when no launch configuration exists for a project. Wherever possible the <b>New Launch Configuration </b> wizard gathers the information from the project and asks additional questions based on the type of launch configuration chosen. For example, a launch configuration using Application TRK requires different information than one targeted for System TRK. </p>
-<p>For Application TRK and System TRK the following pages appear: </p>
-<ul>
- <li><a href="#LAUNCH">Launch Type</a></li>
- <li><a href="#EXE_SEL">Executable Selection </a></li>
- <li><a href="#TRK_CONN">TRK Connection Settings</a></li>
- <li><a href="#TRK_SIS">TRK SIS Selection</a> (<i>Application TRK only</i>) </li>
- <li><a href="#FINISH">New Launch Configuration</a></li>
-</ul>
-<p>For Trace32 launch configurations the following wizard pages appear:</p>
-<ul>
- <li><a href="#LAUNCH">Launch Type</a></li>
- <li><a href="#EXE_SEL">Executable Selection </a></li>
- <li><a href="#TRACE32">Trace32 Initialization Settings</a></li>
- <li><a href="#ROM_IMG">Symbian ROM Image Settings</a></li>
- <li><a href="#FINISH">New Launch Configuration</a></li>
-</ul>
-<p>For Sophia STI launch configurations the following wizard pages appear:</p>
-<ul>
- <li><a href="#LAUNCH">Launch Type</a></li>
- <li><a href="#EXE_SEL">Executable Selection </a></li>
- <li><a href="#SOPHIA">Sophia Initialization Settings</a></li>
- <li><a href="#ROM_IMG">Symbian ROM Image Settings</a></li>
- <li><a href="#FINISH">New Launch Configuration</a></li>
-</ul>
-<p>For Attach to Process launch configurations the following wizard pages appear:</p>
-<ul>
- <li><a href="#TRK_CONN">TRK Connection Settings</a></li>
- <li><a href="#FINISH">New Launch Configuration</a></li>
-</ul>
-<p>To access the <b>New Launch Configurtion Wizard</b>, set the Build Target to a Phone Debug target (Figure 1), then click the <b>Debug</b> icon (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">). If no launch configuration exists for the build target the wizard is launched. If a launch configuration already exists, then that launch configuration is launched and not the wizard.</p>
-<p>For emulator targets, the New Launch Configuration Wizard can gather all the information it needs from the project, so clicking <b>Debug</b> just launches the debug session.</p>
-<p align="center"><img src="../../images/icons/menu_build_target.png" width="270" height="120"></p>
-<p class="figure">Figure 1 - Build Target selection list </p>
-<h3><a name="LAUNCH" id="LAUNCH"></a>Launch Types</h3>
-<p>Use the<b> Launch Types</b> page to select the type of launch configuration for the build target. This page does not appear when using an Emulator target. Available types are listed from the most frequently chosen (Application TRK) to the least likely type (Attach to Process). Select a type and click <b>Next</b>. </p>
-<p align="center"><img src="../../images/icons/wiz_launch_config_launch_types.png" width="438" height="533"></p>
-<p class="figure">Figure 2 - Launch Type page </p>
-<p> </p>
-<h3><a name="EXE_SEL" id="EXE_SEL"></a>Executable Selection </h3>
-<p>Use the <b>Application Selection </b> page to choose a binary created by the project to launch and debug and verify its location. If only a single binary is available the <b>Process to launch</b> option is disabled. </p>
-<p><b>EMULATOR ONLY</b> Use the <b>Location</b> field for emulator targets to verify that the correct executable on the host is selected. This field is not used with on-device launch configurations. </p>
-<p>Use the <b>Specify device path of remote process to launch</b> option to specify alternate paths for launching the executable from RAM (c:\sys\bin\), ROM (z:\sys\bin\) or memory cards (e:\sys\bin\) . </p>
-<p>Select the Executable to launch, verify it is the correct binary, then click <b>Next</b>. </p>
-<p align="center"><img src="../../images/icons/wiz_launch_config_app_selection.png" width="438" height="533"> </p>
-<p class="figure">Figure 3 - Executable Selection page (when project has multiple EXEs)</p>
-<h3><a name="TRK_CONN" id="TRK_CONN"></a>TRK Connection Settings </h3>
-<p>Use the <b>TRK Connection Settings</b> page to specify the connection used to communicate with the target device. If the device is already connected, the drop down list will include both the COM port and the name of the device using that port. Use the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Conection</a> dialog to verify and update all Carbide software services on the device. Choose the serial port used to communicate with the target device and click <b>Next</b>. </p>
-<p align="center"><img src="../../images/icons/wiz_launch_config_trk_conn.png" width="463" height="533"> </p>
-<p class="figure">Figure 4 - TRK Connection Settings page </p>
-<p> </p>
-<h3><a name="TRK_SIS" id="TRK_SIS"></a>TRK SIS Selection</h3>
-<p>Use the <b>TRK SIS Selection</b> page to select the SIS file to install on the target device. Click the <b>Modify SIS builder settings for build configuration</b> link to open the <a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> properties pane to add, edit, or review the SIS files to build. Once the correct SIS File to Install is selected, click <b>Next</b>. </p>
-<p align="center"><img src="../../images/icons/wiz_launch_config_trk_sis.png" width="463" height="533"></p>
-<p class="figure">Figure 5 - TRK SIS Selection page </p>
-<h3><a name="FINISH" id="FINISH"></a>New Launch Configuration</h3>
-<p>Use the <b>New Launch Configuration</b> page to note the name of the configuration, confirm the launch configuration settings, and then launch the debug session. If something doesn't look right, click <b>Back</b> to return to a page and change its setting. If all the settings are correct, click <b>Finish</b> to start the debug session using this launch configuration. </p>
-<p>If you checkmark <b> Advanced settings</b>, the <a href="../../reference/wnd_debug_configuration.htm">Debug</a> dialog appears instead of launching the project. This enables you to make additional changes to the new launch configuration before starting the debug session. By design and intent, this should seldom be required for the initial launch. </p>
-<p align="center"><img src="../../images/icons/wiz_launch_config_finish.png" width="438" height="533"></p>
-<p class="figure">Figure 6 - New Launch Configuration page </p>
-<h3><a name="TRACE32" id="TRACE32"></a>Trace32 Initialization Settings</h3>
-<p>Use the <b>Trace32 Initialization Settings</b> page to specify the <a href="../../reference/wnd_Trace32_config.htm">initialization</a> script and target processor of the target device.Enter the Trace32 Initialization Script and choose the Target Processor, then click <b>Next</b>. </p>
-<p> This page only appears when creating a Trace32 launch configuration. </p>
-<p align="center"><img src="../../images/icons/wiz_launch_config_trace32.png" width="438" height="533"></p>
-<p class="figure">Figure 7 - <b>Trace32 Initialization Settings</b> page </p>
-<h3><a name="SOPHIA" id="SOPHIA"></a>Sophia STI Initialization Settings</h3>
-<p>Use the <b>Sophia STI Initialization Settings</b> page to specify the target interface, <a href="../../reference/wnd_sophia_config.htm">initialization</a> file, and target processor of the target device. Enter the Sophia Target Interface and Target Initialization File paths, choose a Target Processor, then click <b>Next</b>. </p>
-<p>This page only appears when creating a Sophia STI launch configuration. </p>
-<p align="center"><img src="../../images/icons/wiz_launch_config_sophia.png" width="438" height="533"></p>
-<p class="figure">Figure 8 - Sophia STI Initialization Settings page </p>
-<h3><a name="ROM_IMG" id="ROM_IMG"></a>Symbian ROM Image Settings</h3>
-<p>Use the <b>Symbian ROM Image Settings</b> page to specify the method of <a href="../../reference/launch_configs/page_trk_debugger.htm">debugging</a>, the start address, and the <a href="../../reference/launch_configs/stop_mode_rom_image.htm">ROM Image</a> and Log File locations. </p>
-<p>This page appears when creating a Trace32 or Sophia STI launch configuration. </p>
-<p align="center"><img src="../../images/icons/wiz_launch_config_rom_image.png" width="438" height="533"></p>
-<p class="figure">Figure 9 - Symbian ROM Image Settings page</p>
-<h5>Other references</h5>
-<ul>
- <li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configuration</a> </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/working_with_sis_pkg_files.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/projects/working_with_sis_pkg_files.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,54 +1,53 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Working with PKG and SIS Files</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Creating a PKG File</h2>
-<p>After creating a project for the application you are developing for a device, you will need to create a .pkg file if you are using Application TRK. A .pkg file contains all the files that will need to be downloaded to the device. Once a .pkg file is available, you can add it to a project, and the IDE will use it and additional information entered in the <a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> pane to create an application's .sis installation file. By default, when creating a project, the .pkg file is located in the project's <b>sis</b> folder.</p>
-<p>A minimal .pkg file consists of the following lines:</p>
-<ul>
- <li>Header — provides the following information on a single line:
- <ul>
- <li>application name — name of the application displayed on the target device</li>
- <li>UID — (0x10004299) unique application ID value</li>
- <li>major and minor version numbers — values that represent the application's major and minor version numbers</li>
- <li>current build number — value that represents the current .sis build number</li>
- </ul>
- </li>
- <li>Filenames and install location — the name of the file to include in the .sis file and its install location within the target device. Each line describes a single file.</li>
- <li>Comments — .pkg file comment lines are preceeded by a semi-colon</li>
-</ul>
-<h3>PKG File Symbols </h3>
-<p>Carbide.c++ attempts to build SIS files for the current build configuration when a PKG file exists in a given build project. However, there can be one or more SIS file per project but only one can be selected in the <a href="../../reference/launch_configs/app_trk_installation.htm">Installation</a> pane for downloading and debugging. We have introduced symbols you can use within your PKG file for Carbide so that you can use one PKG file in a project to produce several different SIS files, if required.</p>
-<p>The following symbols are available for PKG files in order to make reuse of PKG files more efficient across build targets. These symbols are only supported within Carbide.c++. They are:</p>
-<ul>
- <li><span class="code">$(EPOCROOT)</span> — the location of the epoc32 folder but not including the epoc32 folder</li>
- <li><span class="code">$(PLATFORM)</span> — platform designator, for example: ARMI, WINSC (Emulator) , GCCE, THUMB, etc.</li>
- <li><span class="code">$(TARGET)</span> — target designator UDEB (Debug) or UREL (Release)</li>
-</ul>
-<p>These symbols are used to specify the input location of file resources on your host PC to be packaged in the SIS file. </p>
-<h4>Sample PKG file</h4>
-<p>A sample .pkg file might look like this:</p>
-<p class="listing">;Header<br />
- #{"HelloWorld"},(0xA0004299),1,0,0<br>
- <br />
-"$(EPOCROOT)epoc32\release\$(PLATFORM)\$(TARGET)\HelloWorld.exe" -"!:\sys\bin\HelloWorld.exe"<br />
-"$(EPOCROOT)epoc32\data\z\resource\apps\HelloWorld.rsc" -"!:\resource\apps\HelloWorld.rsc"<br />
-"$(EPOCROOT)epoc32\data\z\private\10003af\import\apps\HelloWorld_reg.rsc" - "!:\private\10003a3f\import\apps\HelloWorld_reg.rsc"<br />
-"$(EPOCROOT)epoc32\data\z\resource\apps\HelloWorld.mbm" -"!:\resource\apps\HelloWorld.mbm"</p>
-<p>In addition you will need to add the PKG file to the project before building the final application. Add the pkg file in the SIS builder tab of the <a href="../../reference/build_properties/pane_build_config.htm">Carbide Build Configurations</a> in the project properties window.</p>
-<h5>Related references </h5>
-<ul>
- <li><a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> pane</li>
- <li><a href="../../reference/build_properties/wnd_sis_properties.htm">SIS Properties</a> </li>
- <li><a href="../../reference/launch_configs/app_trk_installation.htm">Installation</a> pane </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Working with PKG and SIS Files</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Creating a PKG File</h2>
+<p>After creating a project for the application you are developing for a device, you will need to create a .pkg file if you are using Application TRK. A .pkg file contains all the files that will need to be downloaded to the device. Once a .pkg file is available, you can add it to a project, and the IDE will use it and additional information entered in the <a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> pane to create an application's .sis installation file. By default, when creating a project, the .pkg file is located in the project's <b>sis</b> folder.</p>
+<p>A minimal .pkg file consists of the following lines:</p>
+<ul>
+ <li>Header — provides the following information on a single line:
+ <ul>
+ <li>application name — name of the application displayed on the target device</li>
+ <li>UID — (0x10004299) unique application ID value</li>
+ <li>major and minor version numbers — values that represent the application's major and minor version numbers</li>
+ <li>current build number — value that represents the current .sis build number</li>
+ </ul>
+ </li>
+ <li>Filenames and install location — the name of the file to include in the .sis file and its install location within the target device. Each line describes a single file.</li>
+ <li>Comments — .pkg file comment lines are preceeded by a semi-colon</li>
+</ul>
+<h3>PKG File Symbols </h3>
+<p>Carbide.c++ attempts to build SIS files for the current build configuration when a PKG file exists in a given build project. However, there can be one or more SIS file per project but only one can be selected in the <a href="../../projects/launch/page_installation.htm">Installation</a> pane for downloading and debugging. We have introduced symbols you can use within your PKG file for Carbide so that you can use one PKG file in a project to produce several different SIS files, if required.</p>
+<p>The following symbols are available for PKG files in order to make reuse of PKG files more efficient across build targets. These symbols are only supported within Carbide.c++. They are:</p>
+<ul>
+ <li><span class="code">$(EPOCROOT)</span> — the location of the epoc32 folder but not including the epoc32 folder</li>
+ <li><span class="code">$(PLATFORM)</span> — platform designator, for example: ARMI, WINSC (Emulator) , GCCE, THUMB, etc.</li>
+ <li><span class="code">$(TARGET)</span> — target designator UDEB (Debug) or UREL (Release)</li>
+</ul>
+<p>These symbols are used to specify the input location of file resources on your host PC to be packaged in the SIS file. </p>
+<h4>Sample PKG file</h4>
+<p>A sample .pkg file might look like this:</p>
+<p class="listing">;Header<br />
+ #{"HelloWorld"},(0xA0004299),1,0,0<br>
+ <br />
+"$(EPOCROOT)epoc32\release\$(PLATFORM)\$(TARGET)\HelloWorld.exe" -"!:\sys\bin\HelloWorld.exe"<br />
+"$(EPOCROOT)epoc32\data\z\resource\apps\HelloWorld.rsc" -"!:\resource\apps\HelloWorld.rsc"<br />
+"$(EPOCROOT)epoc32\data\z\private\10003af\import\apps\HelloWorld_reg.rsc" - "!:\private\10003a3f\import\apps\HelloWorld_reg.rsc"<br />
+"$(EPOCROOT)epoc32\data\z\resource\apps\HelloWorld.mbm" -"!:\resource\apps\HelloWorld.mbm"</p>
+<p>In addition you will need to add the PKG file to the project before building the final application. Add the pkg file in the SIS builder tab of the <a href="../../reference/build_properties/pane_build_config.htm">Carbide Build Configurations</a> in the project properties window.</p>
+<h5>Related references </h5>
+<ul>
+ <li><a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> pane</li>
+ <li><a href="../../reference/build_properties/wnd_sis_properties.htm">SIS Properties</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/start/carbide_debugging.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/start/carbide_debugging.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,61 +1,61 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Debugging a Symbian OS Program on the S60 Emulator</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Debugging a Symbian OS Program</h2>
-<p>Use the Carbide.c++ debugger to debug a compiled Symbian OS program in an emulator or on-device. The same process works for other emulators and target devices as well.</p>
-<p class="note"><b>NOTE</b> This example uses an emulator. The steps are identical for on-device debugging, although a .sym file is not needed for emulator builds.</p>
-<div class="step">
- <h4>Debugging a Symbian OS program</h4>
-<p class="note"><b>NOTE</b> You can only debug compiled programs. Use the <a href="../projects/prj_build.htm">Build Project</a> command to compile project sources into a binary file if you do not already have an executable in the project. You will also need a symbolics ( .sym) file for debugging on a target device. Ensure that a .sym file has been created. If you are importing an existing application, you may have to rebuild the application and create a related .sym file. Make sure a .sym file has been created in the output directory.</p>
- <ol>
- <li>Set a breakpoint in the HelloCarbide program</li>
- <p>Open the \src\<span class="code">CHelloCarbideAppUI.cpp</span> file and <a href="../breakpoints/pgm_bp_setting.htm">set a breakpoint</a> in the <span class="code">HandleCommandL</span> routine.</p>
- <p align="center"><img src="images/debug_set_breakpoint.png" width="602" height="238" /></p>
- <p class="figure">Figure 1 - Breakpoint set in <span class="code">CHelloCarbideAppUI</span>::HandleCommandL routine. </p>
- <li>Launch the Carbide.c++ debugger and S60 EPOC Emulator</li>
- <p><a href="../debugger/work_debug_act_start.htm">Start</a> the Carbide debugger which launches the S60 EPOC Emulator and installs the HelloCarbide application. For on-device debugging, your application will be installed on your target device.</p>
- <p align="center"><img src="images/debug_s60_emulator_launch.png" width="293" height="391" /></p>
- <p class="figure"><span class="figure">Figure 2 - S60 Emulator launches</span></p>
- <li>Open the Installed directory within the S60 Emulator or your target device </li>
- Use the S60 Emulator controls to locate and open the Installation directory. Select Open from the Options menu (Figure 3).
- <p align="center"><img src="images/debug_s60_emulator_02.png" width="352" height="168" /></p>
- <p class="figure">Figure 3 - Open the Installed directory </p>
- <li>Launch the HelloCarbide application</li>
- <p>Use the S60 Emulator or target device controls to launch the HelloCarbide application (Figure 4).
- </p>
- <p align="center"><img src="images/debug_s60_emulator_03.png" width="122" height="106" /></p>
- <p class="figure">Figure 4 - Launch the HelloCarbide application </p>
- <p>The HelloCarbide application launches (Figure 5). </p>
- <p align="center"><img src="images/debug_s60_emulator_04.png" width="293" height="391" /></p>
- <p class="figure">Figure 5 - HelloCarbide application running on S60 Emulator </p>
- <li>Click the Options soft-key on the S60 Emulator to display the Select menu.</li>
- <li>Choose the Message menu item and press the Select soft-key to send a message (Figure 6).</li>
- <p></p><p align="center"><img src="images/debug_s60_emulator_05.png" width="384" height="254" /></p>
- <p class="figure">Figure 6 - Send Message to HelloCarbide application </p>
- <p>The <span class="code">HandleCommandL</span> breakpoint is hit in the program and control returns to the Carbide.c++ debugger (Figure 7). You can now set additional breakpoints, examine variables, or use the<a href="../../reference/view_debug.htm"> Debug view</a> buttons to control the program. </p>
- <p align="center"><img src="images/debug_s60_emulator_06.png" width="602" height="238" /></p>
- <p class="figure">Figure 7 - Back in the CHelloCarbideAppUI::HandleCommandL routine</p>
- </ol>
- <p>That's it for this basic introduction to debugging with Carbide.c++.</p>
-</div>
-<h5>Concepts</h5>
- <ul>
- <li><a href="../../concepts/Projects.html">Projects</a></li>
-</ul>
- <h5>Tasks</h5>
- <ul>
- <li><a href="../CreatingNewProjects.html">Creating Projects</a></li>
- <li><a href="../projects/prj_build.htm">Building Projects</a></li>
- <li><a href="../projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
- </ul>
- <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Debugging a Symbian OS Program on the S60 Emulator</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Debugging a Symbian OS Program</h2>
+<p>Use the Carbide.c++ debugger to debug a compiled Symbian OS program in an emulator or on-device. The same process works for other emulators and target devices as well.</p>
+<p class="note"><b>NOTE</b> This example uses an emulator. The steps are identical for on-device debugging, although a .sym file is not needed for emulator builds.</p>
+<div class="step">
+ <h4>Debugging a Symbian OS program</h4>
+<p class="note"><b>NOTE</b> You can only debug compiled programs. Use the <a href="../projects/prj_build.htm">Build Project</a> command to compile project sources into a binary file if you do not already have an executable in the project. You will also need a symbolics ( .sym) file for debugging on a target device. Ensure that a .sym file has been created. If you are importing an existing application, you may have to rebuild the application and create a related .sym file. Make sure a .sym file has been created in the output directory.</p>
+ <ol>
+ <li>Set a breakpoint in the HelloCarbide program</li>
+ <p>Open the \src\<span class="code">CHelloCarbideAppUI.cpp</span> file and <a href="../breakpoints/pgm_bp_setting.htm">set a breakpoint</a> in the <span class="code">HandleCommandL</span> routine.</p>
+ <p align="center"><img src="images/debug_set_breakpoint.png" width="602" height="238" /></p>
+ <p class="figure">Figure 1 - Breakpoint set in <span class="code">CHelloCarbideAppUI</span>::HandleCommandL routine. </p>
+ <li>Launch the Carbide.c++ debugger and S60 EPOC Emulator</li>
+ <p><a href="../../debugger/debug/cmds_starting.htm">Start</a> the Carbide debugger which launches the S60 EPOC Emulator and installs the HelloCarbide application. For on-device debugging, your application will be installed on your target device.</p>
+ <p align="center"><img src="images/debug_s60_emulator_launch.png" width="293" height="391" /></p>
+ <p class="figure"><span class="figure">Figure 2 - S60 Emulator launches</span></p>
+ <li>Open the Installed directory within the S60 Emulator or your target device </li>
+ Use the S60 Emulator controls to locate and open the Installation directory. Select Open from the Options menu (Figure 3).
+ <p align="center"><img src="images/debug_s60_emulator_02.png" width="352" height="168" /></p>
+ <p class="figure">Figure 3 - Open the Installed directory </p>
+ <li>Launch the HelloCarbide application</li>
+ <p>Use the S60 Emulator or target device controls to launch the HelloCarbide application (Figure 4).
+ </p>
+ <p align="center"><img src="images/debug_s60_emulator_03.png" width="122" height="106" /></p>
+ <p class="figure">Figure 4 - Launch the HelloCarbide application </p>
+ <p>The HelloCarbide application launches (Figure 5). </p>
+ <p align="center"><img src="images/debug_s60_emulator_04.png" width="293" height="391" /></p>
+ <p class="figure">Figure 5 - HelloCarbide application running on S60 Emulator </p>
+ <li>Click the Options soft-key on the S60 Emulator to display the Select menu.</li>
+ <li>Choose the Message menu item and press the Select soft-key to send a message (Figure 6).</li>
+ <p></p><p align="center"><img src="images/debug_s60_emulator_05.png" width="384" height="254" /></p>
+ <p class="figure">Figure 6 - Send Message to HelloCarbide application </p>
+ <p>The <span class="code">HandleCommandL</span> breakpoint is hit in the program and control returns to the Carbide.c++ debugger (Figure 7). You can now set additional breakpoints, examine variables, or use the<a href="../../debugger/debug/viewing_debug.htm"> Debug view</a> buttons to control the program. </p>
+ <p align="center"><img src="images/debug_s60_emulator_06.png" width="602" height="238" /></p>
+ <p class="figure">Figure 7 - Back in the CHelloCarbideAppUI::HandleCommandL routine</p>
+ </ol>
+ <p>That's it for this basic introduction to debugging with Carbide.c++.</p>
+</div>
+<h5>Concepts</h5>
+ <ul>
+ <li><a href="../../concepts/Projects.html">Projects</a></li>
+</ul>
+ <h5>Tasks</h5>
+ <ul>
+ <li><a href="../CreatingNewProjects.html">Creating Projects</a></li>
+ <li><a href="../projects/prj_build.htm">Building Projects</a></li>
+ <li><a href="../projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
+ </ul>
+ <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/start/carbide_example_trk.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/start/carbide_example_trk.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,72 +1,72 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Run Mode Debug Example</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Run Mode Debug Example (Application TRK) </h2>
-<p>This example shows how to create and build an application and debug it on a device using the Application TRK on-device debug agent. The majority of steps are identical to the ones used to create a program and debug in an emulator, with some minor variations.</p>
-<div class="step">
- <h4>Debugging a Run-mode Project using Application TRK </h4>
- <ol>
- <li>Import the Bld.inf to create a project using the Import wizard </li>
- <p>In this example we are importing a project called Music, a complex project that includes several EXEs (MusicPlayer, MusicShop, MusicVisualizer). When we import, we select an ARM target.</p>
- <li>Go to the project Properties page and in the Carbide Build Configuration panel specify the PKG file in the <a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> tab </li>
- <li>Build the project (Ctrl+B) </li>
- <li>Verify that all the binaries built by the project appear in the <a href="../../reference/view_executables.htm">Executables</a> view. </li>
- <p class="note"><b>NOTE</b> The symbolics are automatically loaded for the binaries that appear in the Executables view.</p>
- <li>Set <a href="../breakpoints/pgm_bp_setting.htm">breakpoints</a> in the project source files </li>
- <p>In this example we will set one breakpoint in two different EXEs. The first is set in the file called <span class="code">MCEngine.cpp</span> (MCServer.exe) and the second is set in <span class="code">MPlayerAppUI.cpp</span> (MusicPlayer.exe). </p>
- <li>Click the Debug icon (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">) to launch the <a href="../projects/wiz_new_launch_config.htm">New Launch Configuration</a> wizard
- <ol type="a">
- <li>Select the Application TRK Launch Configuration from the Launch Types page, then click Next</li>
- <p align="center"><img src="../trk/images/trk_launch_types.png" width="438" height="533"></p>
- <p class="figure">Figure 1 - Launch Types page showing selection </p>
- <li>If you have more than one executable, select the Main Executable in the Executable Selection page of the wizard, then click Next</li>
- <p>For this example we select the musicplayer.exe as the main executable.</p>
- <p align="center"><img src="../trk/images/trk_exe_selection.png" width="438" height="533"></p>
- <p class="figure">Figure 2 - Executable Selection page showing selection </p>
- <li>Select the remote connection to use in the TRK Connection Settings page, then click Next</li>
- <p align="center"><img src="../trk/images/trk_conn_settings.png" width="438" height="533"></p>
- <p class="figure">Figure 3 - TRK Connection Settings page showing selection </p>
- <li>Select the SIS file to install in the TRK SIS Selection page if not already populated</li>
- </ol>
- <blockquote>
- <p class="figure"><img src="../trk/images/trk_sis_selection.png" width="438" height="533"></p>
- <p class="figure">Figure 4 - TRK Connection Settings page showing selection </p>
- </blockquote>
- <ol type="a">
- <li>Click Finish </li>
- <br>
- <p>The SISX file is downloaded and authenticated, then the binaries are installed automatically on the phone. </p>
- </ol>
- <li>Once the debug session launches, control returns to the Debugger when one of the breakpoints set earlier is hit. </li>
- <p>At this point you can debug the program in the Debug perspective. Look at the <a href="../../reference/view_breakpoints.htm">Breakpoints</a> view to verify that the breakpoints set earlier are resolved. In this case, the breakpoint in the MCServer.exe.</p>
- <p align="center"><img src="../trk/images/trk_debug_perspective_dll.png" width="902" height="629"></p>
- <p class="figure">Figure 5 - Debug perspective showing the resolved breakpoint </p>
- <li>Click Resume in the Debug view to hit the breakpoint set in the second EXE</li>
- <p align="center"><img src="../trk/images/trk_debug_perspective_exe.png" width="902" height="629"></p>
- <p class="figure">Figure 6 - Debug perspective showing the resolved EXE breakpoint </p>
- <li>In the Debug view
- <ol type="a">
- <li>Click <a href="../debugger/work_debug_act_disconnect.htm">Disconnect</a> to leave the application running on the device, OR </li>
- <li>Click <a href="../debugger/work_debug_act_stop.htm">Terminate</a> to stop the application running on the device</li>
- </ol>
- </li>
- </ol>
- <p>In addition, you can click the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data View</a> to examine the processes running on the devise during the debug session. </p>
-</div>
-<h5>Related references</h5>
-<ul>
- <li><a href="../trk/trk_troubleshooting.htm">On-device Debugging Troubleshooting</a></li>
- <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS View</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Run Mode Debug Example</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Run Mode Debug Example (Application TRK) </h2>
+<p>This example shows how to create and build an application and debug it on a device using the Application TRK on-device debug agent. The majority of steps are identical to the ones used to create a program and debug in an emulator, with some minor variations.</p>
+<div class="step">
+ <h4>Debugging a Run-mode Project using Application TRK </h4>
+ <ol>
+ <li>Import the Bld.inf to create a project using the Import wizard </li>
+ <p>In this example we are importing a project called Music, a complex project that includes several EXEs (MusicPlayer, MusicShop, MusicVisualizer). When we import, we select an ARM target.</p>
+ <li>Go to the project Properties page and in the Carbide Build Configuration panel specify the PKG file in the <a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> tab </li>
+ <li>Build the project (Ctrl+B) </li>
+ <li>Verify that all the binaries built by the project appear in the <a href="../../reference/view_executables.htm">Executables</a> view. </li>
+ <p class="note"><b>NOTE</b> The symbolics are automatically loaded for the binaries that appear in the Executables view.</p>
+ <li>Set <a href="../breakpoints/pgm_bp_setting.htm">breakpoints</a> in the project source files </li>
+ <p>In this example we will set one breakpoint in two different EXEs. The first is set in the file called <span class="code">MCEngine.cpp</span> (MCServer.exe) and the second is set in <span class="code">MPlayerAppUI.cpp</span> (MusicPlayer.exe). </p>
+ <li>Click the Debug icon (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">) to launch the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration</a> wizard
+ <ol type="a">
+ <li>Select the Application TRK Launch Configuration from the Launch Types page, then click Next</li>
+ <p align="center"><img src="../trk/images/trk_launch_types.png" width="438" height="533"></p>
+ <p class="figure">Figure 1 - Launch Types page showing selection </p>
+ <li>If you have more than one executable, select the Main Executable in the Executable Selection page of the wizard, then click Next</li>
+ <p>For this example we select the musicplayer.exe as the main executable.</p>
+ <p align="center"><img src="../trk/images/trk_exe_selection.png" width="438" height="533"></p>
+ <p class="figure">Figure 2 - Executable Selection page showing selection </p>
+ <li>Select the remote connection to use in the TRK Connection Settings page, then click Next</li>
+ <p align="center"><img src="../trk/images/trk_conn_settings.png" width="438" height="533"></p>
+ <p class="figure">Figure 3 - TRK Connection Settings page showing selection </p>
+ <li>Select the SIS file to install in the TRK SIS Selection page if not already populated</li>
+ </ol>
+ <blockquote>
+ <p class="figure"><img src="../trk/images/trk_sis_selection.png" width="438" height="533"></p>
+ <p class="figure">Figure 4 - TRK Connection Settings page showing selection </p>
+ </blockquote>
+ <ol type="a">
+ <li>Click Finish </li>
+ <br>
+ <p>The SISX file is downloaded and authenticated, then the binaries are installed automatically on the phone. </p>
+ </ol>
+ <li>Once the debug session launches, control returns to the Debugger when one of the breakpoints set earlier is hit. </li>
+ <p>At this point you can debug the program in the Debug perspective. Look at the <a href="../../reference/view_breakpoints.htm">Breakpoints</a> view to verify that the breakpoints set earlier are resolved. In this case, the breakpoint in the MCServer.exe.</p>
+ <p align="center"><img src="../trk/images/trk_debug_perspective_dll.png" width="902" height="629"></p>
+ <p class="figure">Figure 5 - Debug perspective showing the resolved breakpoint </p>
+ <li>Click Resume in the Debug view to hit the breakpoint set in the second EXE</li>
+ <p align="center"><img src="../trk/images/trk_debug_perspective_exe.png" width="902" height="629"></p>
+ <p class="figure">Figure 6 - Debug perspective showing the resolved EXE breakpoint </p>
+ <li>In the Debug view
+ <ol type="a">
+ <li>Click <a href="../../debugger/debug/cmds_other.htm">Disconnect</a> to leave the application running on the device, OR </li>
+ <li>Click <a href="../../debugger/debug/cmds_starting.htm">Terminate</a> to stop the application running on the device</li>
+ </ol>
+ </li>
+ </ol>
+ <p>In addition, you can click the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data View</a> to examine the processes running on the devise during the debug session. </p>
+</div>
+<h5>Related references</h5>
+<ul>
+ <li><a href="../trk/trk_troubleshooting.htm">On-device Debugging Troubleshooting</a></li>
+ <li><a href="../../reference/view_symbian_kernel.htm">Symbian OS View</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/start/images/window_updater.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/trk_copy_to_memory_card.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/trk_select_device.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/trk_stop_usb_device.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/wnd_usb_file_transfer.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/wnd_usb_mass_storage.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/images/wnd_usb_remove_hardware.png has changed
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_carbide_setup.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_carbide_setup.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,52 +1,52 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Launch Configuration Setup</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Launch Configuration Setup</h2>
-<p>To communicate between the Carbide.c++ debugger and the <a href="../../concepts/trk.htm">on-device debug agent</a>, using either Application TRK or System TRK, you must <a href="../projects/prj_debug_config.htm">define</a> a debug <a href="../../projects/launch/launch_configs_overview.htm">launch configuration</a> that matches the installed debug agent. The two configurations available include:</p>
-<ul>
- <li><b>Symbian OS Appication TRK</b>— used to run or debug applications on a target device using the Application TRK on-device debug agent. Application TRK is an application that runs on released phones and allows you to debug your executables. The debugger will download a Symbian OS installation file to the phone and install it prior to launching.</li>
- <li><b>Symbian OS System TRK</b> (<i>not available in the Developer Edition</i>) —used to run or debug applications or ROM code on a target device using the System TRK on-device debug agent. System TRK is an application that runs on reference boards and prototype phones and allows you to debug your executables. The debugger will download files to the phone prior to launching.</li>
-</ul>
-<p>By default, you can click the <b>Debug</b> icon (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">) in the toolbar to launch the <a href="../projects/wiz_new_launch_config.htm">New Launch Configuration Wizard</a>. This creates a launch configuration for the project based on project information and any additional input required, like COM port selection. It is the recommended method for creating new launch configurations. Or, use the <a href="../../reference/launch_configs/page_trk_main.htm">Debug</a> window to create a customized launch configuration. </p>
-<p align="center"><img src="../../reference/images/wnd_trk_debug_config.png" width="859" height="629" /></p>
-<p class="figure">Figure 1. Debug launch configuration for on-device debugging (<i>Application TRK shown</i>)</p>
-<div class="step">
- <h4>Defining a Customized Launch Configuration </h4>
- <ol>
- <li>Choose the Run > Open Debug Dialog... menu item </li>
- <p>The <a href="../../reference/wnd_debug_configuration.htm">Debug</a> window appears.</p>
- <li>Select a Configuration type for on-device debugging and click New</li>
- <p>Choose the <b>Symbian OS Application TRK </b> or <b>System TRK</b> configuration based on which debug agent is installed on the device, then click <b>New</b>. A new debug launch configuration appears in the Configuration list and the Main tab appears. </p>
- <li>Enter the required information</li>
- <p>For debug launch configurations using the TRK debug agent, the following pages require review and possible option settings:</p>
- <ul>
- <li><a href="../../reference/launch_configs/page_trk_main.htm">Main</a>— defines the project to be launched on the target device</li>
- <li>Arguments — enter command line build system arguments </li>
- <li><a href="../../reference/launch_configs/page_trk_debugger.htm">Debugger</a>— provides control over entry points, message handling, and instruction set default settings</li>
- <li><a href="../../reference/launch_configs/page_connection.htm">Connection</a>— specifies the method used to transfer files to the target device</li>
- <li><a href="../../reference/launch_configs/page_file_transfer.htm">File Transfer</a> — the files transfered to the target device at the start of each launch</li>
- <li><a href="../../reference/launch_configs/app_trk_installation.htm">Installation</a> (<i>Application TRK onl</i>y)— specifies the .sis or .pkg file to install on the target device</li>
- <li><a href="../../reference/launch_configs/page_executables.htm">Executables</a> — specifies the executables to be debugged</li>
- <li><a href="../../reference/launch_configs/sys_trk_rom_log.htm">ROM Log</a> (<i>System TRK only</i>) — specifies the executables to be debugged</li>
- </ul>
- <li>Click Debug </li>
- <p>The Debug window closes and the Carbide.c++ debugger begins a debugging session using the new configuration. The next time you click the <b>Debug</b> icon, this debug launch configuration is used to start a debug session.</p>
- </ol>
-</div>
-<h5>Related references</h5>
-<ul>
- <li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configurations</a></li>
- <li><a href="../../concepts/trk.htm">On-device Debugging</a></li>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
- <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Launch Configuration Setup</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Launch Configuration Setup</h2>
+<p>To communicate between the Carbide.c++ debugger and the <a href="../../concepts/trk.htm">on-device debug agent</a>, using either Application TRK or System TRK, you must <a href="../projects/prj_debug_config.htm">define</a> a debug <a href="../../projects/launch/launch_configs_overview.htm">launch configuration</a> that matches the installed debug agent. The two configurations available include:</p>
+<ul>
+ <li><b>Symbian OS Appication TRK</b>— used to run or debug applications on a target device using the Application TRK on-device debug agent. Application TRK is an application that runs on released phones and allows you to debug your executables. The debugger will download a Symbian OS installation file to the phone and install it prior to launching.</li>
+ <li><b>Symbian OS System TRK</b> (<i>not available in the Developer Edition</i>) —used to run or debug applications or ROM code on a target device using the System TRK on-device debug agent. System TRK is an application that runs on reference boards and prototype phones and allows you to debug your executables. The debugger will download files to the phone prior to launching.</li>
+</ul>
+<p>By default, you can click the <b>Debug</b> icon (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">) in the toolbar to launch the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a>. This creates a launch configuration for the project based on project information and any additional input required, like COM port selection. It is the recommended method for creating new launch configurations. Or, use the <a href="../../projects/launch/page_main.htm">Debug</a> window to create a customized launch configuration. </p>
+<p align="center"><img src="../../reference/images/wnd_trk_debug_config.png" width="859" height="629" /></p>
+<p class="figure">Figure 1. Debug launch configuration for on-device debugging (<i>Application TRK shown</i>)</p>
+<div class="step">
+ <h4>Defining a Customized Launch Configuration </h4>
+ <ol>
+ <li>Choose the Run > Open Debug Dialog... menu item </li>
+ <p>The <a href="../../reference/wnd_debug_configuration.htm">Debug</a> window appears.</p>
+ <li>Select a Configuration type for on-device debugging and click New</li>
+ <p>Choose the <b>Symbian OS Application TRK </b> or <b>System TRK</b> configuration based on which debug agent is installed on the device, then click <b>New</b>. A new debug launch configuration appears in the Configuration list and the Main tab appears. </p>
+ <li>Enter the required information</li>
+ <p>For debug launch configurations using the TRK debug agent, the following pages require review and possible option settings:</p>
+ <ul>
+ <li><a href="../../projects/launch/page_main.htm">Main</a>— defines the project to be launched on the target device</li>
+ <li>Arguments — enter command line build system arguments </li>
+ <li><a href="../../projects/launch/page_debugger.htm">Debugger</a>— provides control over entry points, message handling, and instruction set default settings</li>
+ <li><a href="../../projects/launch/page_connection.htm">Connection</a>— specifies the method used to transfer files to the target device</li>
+ <li><a href="../../projects/launch/page_file_transfer.htm">File Transfer</a> — the files transfered to the target device at the start of each launch</li>
+ <li><a href="../../projects/launch/page_installation.htm">Installation</a> (<i>Application TRK onl</i>y)— specifies the .sis or .pkg file to install on the target device</li>
+ <li><a href="../../projects/launch/page_executables.htm">Executables</a> — specifies the executables to be debugged</li>
+ <li><a href="../../projects/launch/page_rom_log.htm">ROM Log</a> (<i>System TRK only</i>) — specifies the executables to be debugged</li>
+ </ul>
+ <li>Click Debug </li>
+ <p>The Debug window closes and the Carbide.c++ debugger begins a debugging session using the new configuration. The next time you click the <b>Debug</b> icon, this debug launch configuration is used to start a debug session.</p>
+ </ol>
+</div>
+<h5>Related references</h5>
+<ul>
+ <li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configurations</a></li>
+ <li><a href="../../concepts/trk.htm">On-device Debugging</a></li>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
+ <li><a href="../../tasks/projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_connection_bluetooth.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_connection_bluetooth.htm Mon Aug 10 15:50:55 2009 -0500
@@ -27,7 +27,7 @@
<p class="figure">Figure 1. Bluetooth Configuration windows Accessibility panel </p>
<li>Write down the Bluetooth COM Port number from the Local Services tab (Figure 2) for later use</li>
<p>The Bluetooth COM Port number in the Local Services tab
- should match the COM port used in the <a href="../../reference/launch_configs/page_connection.htm">Connections</a> tab of the TRK <a href="../../reference/launch_configs/run_mode_overview.htm">launch<br />
+ should match the COM port used in the <a href="../../projects/launch/page_connection.htm">Connections</a> tab of the TRK <a href="../../projects/launch/page_main.htm">launch<br />
configuration</a>.</p>
<p align="center"><img src="images/wnd_bluetooth_config_services.png" width="460" height="437" /></p>
<p class="figure">Figure 2. Bluetooth Configuration windows Local Services panel </p>
@@ -41,7 +41,7 @@
</ul>
<h5>Related references</h5>
<ul>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
</ul>
<h5>Related tasks</h5>
<ul>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_connection_usb.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_connection_usb.htm Mon Aug 10 15:50:55 2009 -0500
@@ -31,7 +31,7 @@
<li>Locate the S60 Phone USB (COMx) item in the list (Figure 2) </li>
<p align="center"><img src="../../reference/images/wnd_win_device_mgr.png" width="502" height="339" /></p>
<p class="figure">Figure 2. Device Manager showing Ports (COM & LPT) section</p>
- <li>The USB COM Port number should match the COM port used in the <a href="../../reference/launch_configs/page_connection.htm">Connections</a> tab of the TRK launch
+ <li>The USB COM Port number should match the COM port used in the <a href="../../projects/launch/page_connection.htm">Connections</a> tab of the TRK launch
configuration.</li>
<li>Close the Device Manager window</li>
</ol>
@@ -43,7 +43,7 @@
</ul>
<h5>Related references</h5>
<ul>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
</ul>
<h5>Related tasks</h5>
<ul>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_bluetooth.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_bluetooth.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,57 +1,57 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Installing On-device Debug Agents using Bluetooth</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-<style type="text/css">
-<!--
-.style1 {color: #FF0000}
--->
-</style>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Installing On-device Debug Agents using Bluetooth </h2>
-<p>Use Bluetooth to install the on-device debug agent, either Application TRK or System TRK, as a SISX file, to enable on-target debugging. The installation location of the on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored. </p>
-<p class="note"><b>NOTE</b> The following example shows how to install the SISX file from a PC running Windows XP SP2 using an internal Bluetooth device. The actions to install the SISX file may be different on your version of Windows. Refer to the OS documentation for information on transferring a file via a Bluetooth connection.</p>
-<div class="step">
- <h4>Installing an On-device Debug Agent using Bluetooth </h4>
- <ol>
- <li>On the device ensure that the Bluetooth communications is turned on</li>
- <li>On the PC ensure that the Bluetooth device is turned on</li>
- <li>From your PC, search for available Bluetooth devices and make sure your device is listed</li>
- <li>On the PC, right-click the SISX file, then choose the Send To > Bluetooth > <i>device</i> menu item (Figure 1) </li>
- <p align="center"><img src="images/trk_menu_send_to.png" width="700" height="452" /></p>
- <p class="figure">Figure 1. Right-click SISX file</p>
-
- <li> Follow the on-screen instructions to transfer the SISX file to the target device</li>
- <p>The SISX file is transfered to the target device as a message. On the target device you may need to set a PIN code for the file transfer, accept the message, then wait for the "You have 1 new message" alert to appear.</p>
- <li>Locate the new message on the target device</li>
- <p>Start the Messaging application on the target device and locate the new message. </p>
- <li>Select the SISx file and open the file to install it</li>
- <li>Click OK when prompted to install TRK</li>
- <li>Follow the instructions on the screen to finish installing the TRK debug agent</li>
- </ol>
-</div>
- <h5>Related concepts</h5>
- <ul>
- <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
- </ul>
- <h5>Related references</h5>
- <ul>
-
- <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup </a></li>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
- </ul>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="trk_install_usb.htm">Installing On-device Debug Agents using USB</a></li>
- <li><a href="trk_connection_bluetooth.htm">Connecting via Bluetooth</a></li>
- <li><a href="trk_connection_usb.htm">Connecting via USB </a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Installing On-device Debug Agents using Bluetooth</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+<style type="text/css">
+<!--
+.style1 {color: #FF0000}
+-->
+</style>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Installing On-device Debug Agents using Bluetooth </h2>
+<p>Use Bluetooth to install the on-device debug agent, either Application TRK or System TRK, as a SISX file, to enable on-target debugging. The installation location of the on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored. </p>
+<p class="note"><b>NOTE</b> The following example shows how to install the SISX file from a PC running Windows XP SP2 using an internal Bluetooth device. The actions to install the SISX file may be different on your version of Windows. Refer to the OS documentation for information on transferring a file via a Bluetooth connection.</p>
+<div class="step">
+ <h4>Installing an On-device Debug Agent using Bluetooth </h4>
+ <ol>
+ <li>On the device ensure that the Bluetooth communications is turned on</li>
+ <li>On the PC ensure that the Bluetooth device is turned on</li>
+ <li>From your PC, search for available Bluetooth devices and make sure your device is listed</li>
+ <li>On the PC, right-click the SISX file, then choose the Send To > Bluetooth > <i>device</i> menu item (Figure 1) </li>
+ <p align="center"><img src="images/trk_menu_send_to.png" width="700" height="452" /></p>
+ <p class="figure">Figure 1. Right-click SISX file</p>
+
+ <li> Follow the on-screen instructions to transfer the SISX file to the target device</li>
+ <p>The SISX file is transfered to the target device as a message. On the target device you may need to set a PIN code for the file transfer, accept the message, then wait for the "You have 1 new message" alert to appear.</p>
+ <li>Locate the new message on the target device</li>
+ <p>Start the Messaging application on the target device and locate the new message. </p>
+ <li>Select the SISx file and open the file to install it</li>
+ <li>Click OK when prompted to install TRK</li>
+ <li>Follow the instructions on the screen to finish installing the TRK debug agent</li>
+ </ol>
+</div>
+ <h5>Related concepts</h5>
+ <ul>
+ <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
+ </ul>
+ <h5>Related references</h5>
+ <ul>
+
+ <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup </a></li>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
+ </ul>
+<h5>Related tasks</h5>
+<ul>
+ <li><a href="trk_install_usb.htm">Installing On-device Debug Agents using USB</a></li>
+ <li><a href="trk_connection_bluetooth.htm">Connecting via Bluetooth</a></li>
+ <li><a href="trk_connection_usb.htm">Connecting via USB </a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_pcsuite.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_pcsuite.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,56 +1,56 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Installing On-device Debug Agents using USB</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Installing On-device Debug Agents using PC Suite</h2>
-<p>Use the PC Suite software that came with your device (<a href="http://europe.nokia.com/A4144905">Nokia PC Suite</a> is one example) to install the on-device debug agent, either Application TRK or System TRK, as a SISX file, to enable on-device debugging. The installation location of the on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored. </p>
-<p>Using PC Suite you can install any TRK debug agent on the device using a Bluetooth or USB connection. </p>
-<p class="note"><b>NOTE</b> You can use the connection software that came with your device to install the on-device debug agent SISX file. See your phone's operating manual for assistance on using it's software.</p>
-<div class="step">
- <h4>Installing an On-device Debug Agent using PC Suite (USB example) </h4>
- <ol>
- <li>Store the TRK SISX file on the PC connected to the device </li>
- <p>The Application TRK debug agents are stored online and can be downloaded and installed using the <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</p>
- <li>Connect the USB cable to the PC, then to the device</li>
- <p>A status indicator should appear on the device indicating a serial connection has been established.</p>
- <li>Connect to the device using the latest PC Suite software
- <ol type="a">
- <li>Install PC Suite if not available </li>
- <p class="note"><b>NOTE</b> If you have both Sony Ericcson Mobile Communications (SEMC) and Nokia PC Suites installed, conflicts may occur.</p>
- <li>Launch the PC Suite software </li>
- <li>Click the "Click here to connect to a phone" and follow the Get Connected wizard instructions</li>
- <p>Once the device has been found and authenticated by the PC its possible to install the TRK SISX file.</p>
- </ol>
- </li>
- <li>Double-click the TRK SISX file to install it on the device </li>
- </ol>
- <blockquote>
- <p>The <b>PC Suite</b> application installer launches and asks where to install the SISX file. Select the recommended destination for installed applications on the device and click <b>Yes</b>. The SISX file is installed. </p>
- Then exit out of PC Suite. </blockquote>
-</div>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
-</ul>
-<h5>Related reference</h5>
-<ul>
-
- <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup </a></li>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
-</ul>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth</a></li>
- <li><a href="trk_connection_bluetooth.htm">Connecting via Bluetooth</a></li>
- <li><a href="trk_connection_usb.htm">Connecting via USB </a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Installing On-device Debug Agents using USB</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Installing On-device Debug Agents using PC Suite</h2>
+<p>Use the PC Suite software that came with your device (<a href="http://europe.nokia.com/A4144905">Nokia PC Suite</a> is one example) to install the on-device debug agent, either Application TRK or System TRK, as a SISX file, to enable on-device debugging. The installation location of the on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored. </p>
+<p>Using PC Suite you can install any TRK debug agent on the device using a Bluetooth or USB connection. </p>
+<p class="note"><b>NOTE</b> You can use the connection software that came with your device to install the on-device debug agent SISX file. See your phone's operating manual for assistance on using it's software.</p>
+<div class="step">
+ <h4>Installing an On-device Debug Agent using PC Suite (USB example) </h4>
+ <ol>
+ <li>Store the TRK SISX file on the PC connected to the device </li>
+ <p>The Application TRK debug agents are stored online and can be downloaded and installed using the <a href="../../projects/launch/wiz_new_launch_config.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</p>
+ <li>Connect the USB cable to the PC, then to the device</li>
+ <p>A status indicator should appear on the device indicating a serial connection has been established.</p>
+ <li>Connect to the device using the latest PC Suite software
+ <ol type="a">
+ <li>Install PC Suite if not available </li>
+ <p class="note"><b>NOTE</b> If you have both Sony Ericcson Mobile Communications (SEMC) and Nokia PC Suites installed, conflicts may occur.</p>
+ <li>Launch the PC Suite software </li>
+ <li>Click the "Click here to connect to a phone" and follow the Get Connected wizard instructions</li>
+ <p>Once the device has been found and authenticated by the PC its possible to install the TRK SISX file.</p>
+ </ol>
+ </li>
+ <li>Double-click the TRK SISX file to install it on the device </li>
+ </ol>
+ <blockquote>
+ <p>The <b>PC Suite</b> application installer launches and asks where to install the SISX file. Select the recommended destination for installed applications on the device and click <b>Yes</b>. The SISX file is installed. </p>
+ Then exit out of PC Suite. </blockquote>
+</div>
+<h5>Related concepts</h5>
+<ul>
+ <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
+</ul>
+<h5>Related reference</h5>
+<ul>
+
+ <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup </a></li>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
+</ul>
+<h5>Related tasks</h5>
+<ul>
+ <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth</a></li>
+ <li><a href="trk_connection_bluetooth.htm">Connecting via Bluetooth</a></li>
+ <li><a href="trk_connection_usb.htm">Connecting via USB </a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_usb.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_install_usb.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,55 +1,55 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Installing On-device Debug Agents using USB</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Installing On-device Debug Agents using USB</h2>
-<p> An USB connection can be used to install the on-device debug agent, either Application TRK or System TRK, (SISX file), to enable on-target debugging. The installation location of the on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored.</p>
-<p class="note"><b>NOTE</b> You can use the connection software that came with your device to install the on-device debug agent SISX file. For example, all Nokia phones ship with the PC Suite software for installing programs. See your phone's operating manual for assistance on using it's software. </p>
-<div class="step">
- <h4>Installing an On-device Debug Agent using USB</h4>
- <ol>
- <li>Connect the PC and the target device using a USB connectivity cable</li>
- <p>Physically connect the USB cable to the PC, then to the target device.</p>
- <li>Setup the target device to accept file transfers from the PC</li>
- <p>The target device recognizes the USB cable connection.</p>
- <ol type="a">
- <li>Select USB Mode > File Transfer, then press OK soft key </li>
- <p>A notification message appears warning you the phone will be offline. </p>
- <li>Press OK soft key to accept notification</li>
- <p>The message "USB file transfer connection active" appears on the phone. On the PC, a folder appears showing the memory cards folders and files.</p>
- </ol>
- <li>Copy the SISX file to phone memory or MMC card</li>
- <p>Locate the SISX file on the PC, then select and copy it into the target device's memory card. </p>
- <li>Install the SISX file </li>
- <p>The final step is to install the SISX program on the target device. </p>
- <ol type="a">
- <li>Locate and launch the SISX file to install </li>
- <li>Follow the instructions on the screen to finish installing the TRK debug agent</li>
- </ol>
- </ol>
-</div>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
-</ul>
-<h5>Related reference</h5>
-<ul>
- <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup </a></li>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
-</ul>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth</a></li>
- <li><a href="trk_connection_bluetooth.htm">Connecting via Bluetooth</a></li>
- <li><a href="trk_connection_usb.htm">Connecting via USB </a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Installing On-device Debug Agents using USB</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Installing On-device Debug Agents using USB</h2>
+<p> An USB connection can be used to install the on-device debug agent, either Application TRK or System TRK, (SISX file), to enable on-target debugging. The installation location of the on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored.</p>
+<p class="note"><b>NOTE</b> You can use the connection software that came with your device to install the on-device debug agent SISX file. For example, all Nokia phones ship with the PC Suite software for installing programs. See your phone's operating manual for assistance on using it's software. </p>
+<div class="step">
+ <h4>Installing an On-device Debug Agent using USB</h4>
+ <ol>
+ <li>Connect the PC and the target device using a USB connectivity cable</li>
+ <p>Physically connect the USB cable to the PC, then to the target device.</p>
+ <li>Setup the target device to accept file transfers from the PC</li>
+ <p>The target device recognizes the USB cable connection.</p>
+ <ol type="a">
+ <li>Select USB Mode > File Transfer, then press OK soft key </li>
+ <p>A notification message appears warning you the phone will be offline. </p>
+ <li>Press OK soft key to accept notification</li>
+ <p>The message "USB file transfer connection active" appears on the phone. On the PC, a folder appears showing the memory cards folders and files.</p>
+ </ol>
+ <li>Copy the SISX file to phone memory or MMC card</li>
+ <p>Locate the SISX file on the PC, then select and copy it into the target device's memory card. </p>
+ <li>Install the SISX file </li>
+ <p>The final step is to install the SISX program on the target device. </p>
+ <ol type="a">
+ <li>Locate and launch the SISX file to install </li>
+ <li>Follow the instructions on the screen to finish installing the TRK debug agent</li>
+ </ol>
+ </ol>
+</div>
+<h5>Related concepts</h5>
+<ul>
+ <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
+</ul>
+<h5>Related reference</h5>
+<ul>
+ <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup </a></li>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
+</ul>
+<h5>Related tasks</h5>
+<ul>
+ <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth</a></li>
+ <li><a href="trk_connection_bluetooth.htm">Connecting via Bluetooth</a></li>
+ <li><a href="trk_connection_usb.htm">Connecting via USB </a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_installation_instr.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_installation_instr.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,21 +1,21 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Installing an On-device Debug Agent</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Installing an On-device Debug Agent </h2>
-<p>To use any version of the on-device debug agent on a target device it must be installed. We highly recommend using the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Connections</a> dialog to help connect and verify that the latest version of TRK is installed on the device. Or, to manage this manually, follow the instructions to install the TRK debug agent software using <a href="trk_install_bluetooth.htm">Bluetooth</a> or <a href="trk_install_usb.htm">USB</a>.</p>
-<h5>Related references </h5>
-<ul>
- <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Connections</a></li>
- <li><a href="../../concepts/trk.htm">On-Device Debugging </a></li>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Installing an On-device Debug Agent</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Installing an On-device Debug Agent </h2>
+<p>To use any version of the on-device debug agent on a target device it must be installed. We highly recommend using the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Connections</a> dialog to help connect and verify that the latest version of TRK is installed on the device. Or, to manage this manually, follow the instructions to install the TRK debug agent software using <a href="trk_install_bluetooth.htm">Bluetooth</a> or <a href="trk_install_usb.htm">USB</a>.</p>
+<h5>Related references </h5>
+<ul>
+ <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Connections</a></li>
+ <li><a href="../../concepts/trk.htm">On-Device Debugging </a></li>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_overview.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_overview.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,27 +1,27 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>TRK Overview</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>TRK Overview</h2>
-<p>This section describes how to setup and use the on-device debug agent software to debug programs on S60 v3.x and UIQ 3rd edition devices. Topics include: </p>
-<ul>
- <li><a href="trk_preconditions.htm">Preconditions for Using On-device Debugging </a></li>
- <li><a href="trk_installation_instr.htm">Installing the </a><a href="trk_preconditions.htm">On-device Debug Agent </a><a href="trk_installation_instr.htm">on a Device</a></li>
- <li>Connecting a PC to a Device using <a href="trk_install_pcsuite.htm">PC Suite</a>, <a href="trk_connection_bluetooth.htm">Bluetooth</a> or <a href="trk_connection_usb.htm">USB</a></li>
- <li><a href="trk_carbide_setup.htm">Setting up Carbide.c++ Connectivity</a></li>
-</ul>
-<h5>Related references </h5>
-<ul>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
- <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup </a></li>
- <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>TRK Overview</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>TRK Overview</h2>
+<p>This section describes how to setup and use the on-device debug agent software to debug programs on S60 v3.x and UIQ 3rd edition devices. Topics include: </p>
+<ul>
+ <li><a href="trk_preconditions.htm">Preconditions for Using On-device Debugging </a></li>
+ <li><a href="trk_installation_instr.htm">Installing the </a><a href="trk_preconditions.htm">On-device Debug Agent </a><a href="trk_installation_instr.htm">on a Device</a></li>
+ <li>Connecting a PC to a Device using <a href="trk_install_pcsuite.htm">PC Suite</a>, <a href="trk_connection_bluetooth.htm">Bluetooth</a> or <a href="trk_connection_usb.htm">USB</a></li>
+ <li><a href="trk_carbide_setup.htm">Setting up Carbide.c++ Connectivity</a></li>
+</ul>
+<h5>Related references </h5>
+<ul>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
+ <li><a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup </a></li>
+ <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_preconditions.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_preconditions.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,51 +1,51 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>ODD Preconditions</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Preconditions to On-Device Debugging</h2>
-<p>Before you can use on-device debugging to debug 3rd edition and UIQ devices, the following preconditions must be met.</p>
-<div class="step">
- <h4>Verifying On-device Debugging Preconditions </h4>
- <ol>
- <li>Verify that your system has the following:
- <ul>
- <li>S60 v3.x, UIQ 2.X or UIQ 3.X kit installed</li>
- <li>ActivePerl installed</li>
- <li>RVCT or GCCE compiler</li>
- <li>USB or Bluetooth capable S60 3rd Edition or UIQ 3rd Edition device</li>
- <li>USB or Bluetooth support on your PC </li>
- <li>Nokia PC Suite (or equivilent software) for connecting and installing applications to the device </li>
- </ul>
- </li>
- <li>Download and install the current TRK SISX file using the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup</a> dialog for debugging S60 5th edition and UIQ devices</li>
- <p>The Application TRK debug agents are stored If not, install it now using the <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</p>
- <p class="note"><b>NOTE</b> The Application TRK versions included with Carbide is for CE versions of devices only. They are not intended for use with RnD devices. </p>
- <li>Specify the communication method with the on-target device during the debug session</li>
- <p>Start the Application TRK or System TRK on the device. During startup of TRK on the device you must specify the communication method the on-device agent uses to debug the device. Currently, those methods include <a href="trk_connection_bluetooth.htm">Bluetooth</a> and <a href="trk_connection_usb.htm">USB</a> or a null serial cable. For Bluetooth, you must pair the device with the PC and a valid serial port assigned. For USB, A USB cable must connect the PC to the device and a valid serial port assigned. Use <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup</a> dialog to make the identification and connection setup quick and easy. </p>
- </ol>
-</div>
-<h5>Related concepts</h5>
-<ul>
- <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
- <li><a href="../../concepts/build_configurations.htm">Build Configuration</a></li>
- <li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configuration </a> </li>
-</ul>
-<h5>Related reference</h5>
-<ul>
- <li><a href="trk_start_sisx.htm">Starting the On-Device TRK Debug Agent</a></li>
-</ul>
-<h5>Related tasks</h5>
-<ul>
- <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth</a></li>
- <li><a href="trk_install_usb.htm">Installing On-device Debug Agents using USB </a></li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>ODD Preconditions</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Preconditions to On-Device Debugging</h2>
+<p>Before you can use on-device debugging to debug 3rd edition and UIQ devices, the following preconditions must be met.</p>
+<div class="step">
+ <h4>Verifying On-device Debugging Preconditions </h4>
+ <ol>
+ <li>Verify that your system has the following:
+ <ul>
+ <li>S60 v3.x, UIQ 2.X or UIQ 3.X kit installed</li>
+ <li>ActivePerl installed</li>
+ <li>RVCT or GCCE compiler</li>
+ <li>USB or Bluetooth capable S60 3rd Edition or UIQ 3rd Edition device</li>
+ <li>USB or Bluetooth support on your PC </li>
+ <li>Nokia PC Suite (or equivilent software) for connecting and installing applications to the device </li>
+ </ul>
+ </li>
+ <li>Download and install the current TRK SISX file using the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup</a> dialog for debugging S60 5th edition and UIQ devices</li>
+ <p>The Application TRK debug agents are stored If not, install it now using the <a href="../../projects/launch/wiz_new_launch_config.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</p>
+ <p class="note"><b>NOTE</b> The Application TRK versions included with Carbide is for CE versions of devices only. They are not intended for use with RnD devices. </p>
+ <li>Specify the communication method with the on-target device during the debug session</li>
+ <p>Start the Application TRK or System TRK on the device. During startup of TRK on the device you must specify the communication method the on-device agent uses to debug the device. Currently, those methods include <a href="trk_connection_bluetooth.htm">Bluetooth</a> and <a href="trk_connection_usb.htm">USB</a> or a null serial cable. For Bluetooth, you must pair the device with the PC and a valid serial port assigned. For USB, A USB cable must connect the PC to the device and a valid serial port assigned. Use <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup</a> dialog to make the identification and connection setup quick and easy. </p>
+ </ol>
+</div>
+<h5>Related concepts</h5>
+<ul>
+ <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
+ <li><a href="../../concepts/build_configurations.htm">Build Configuration</a></li>
+ <li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configuration </a> </li>
+</ul>
+<h5>Related reference</h5>
+<ul>
+ <li><a href="trk_start_sisx.htm">Starting the On-Device TRK Debug Agent</a></li>
+</ul>
+<h5>Related tasks</h5>
+<ul>
+ <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth</a></li>
+ <li><a href="trk_install_usb.htm">Installing On-device Debug Agents using USB </a></li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,49 +1,49 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Bluetooth Connectivity Setup</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Starting the On-Device TRK Debug Agent</h2>
-<div class="step">
- <p>The location of the TRK on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored.</p>
- <ol>
- <li>Launch the Application TRK or System TRK program on the device</li>
- <li>When requested, select your computer from the available Bluetooth devices list</li>
- <p align="center"><img src="images/trk_bt_device_search_dialog.png" width="211" height="250" /></p>
- <p class="figure">Figure 1. Example device list on a S60 3rd Edition or UIQ device</p>
- <li>Verify the Bluetooth connection is working
-(Figure 2)
- <p align="center"><img src="images/trk_bt_connected.png" width="211" height="250" /></p>
- <p class="figure">Figure 2. COM port verification in TRK on a device</p>
- </li>
- <li>If Application TRK reports "Not Connected"
- <ol type="a">
- <li>Click Options > Settings soft key </li>
- <li>If Connection is not set to BlueTooth, choose BlueTooth </li>
- <li>Click Ok soft key</li>
- <li>Restart Application TRK </li>
- </ol>
- </li>
- </ol>
-</div>
- <h5>Related concepts</h5>
- <ul>
- <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
- </ul>
- <h5>Related references</h5>
- <ul>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
- </ul>
- <h5>Related tasks</h5>
- <ul>
- <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth </a></li>
- </ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Bluetooth Connectivity Setup</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Starting the On-Device TRK Debug Agent</h2>
+<div class="step">
+ <p>The location of the TRK on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored.</p>
+ <ol>
+ <li>Launch the Application TRK or System TRK program on the device</li>
+ <li>When requested, select your computer from the available Bluetooth devices list</li>
+ <p align="center"><img src="images/trk_bt_device_search_dialog.png" width="211" height="250" /></p>
+ <p class="figure">Figure 1. Example device list on a S60 3rd Edition or UIQ device</p>
+ <li>Verify the Bluetooth connection is working
+(Figure 2)
+ <p align="center"><img src="images/trk_bt_connected.png" width="211" height="250" /></p>
+ <p class="figure">Figure 2. COM port verification in TRK on a device</p>
+ </li>
+ <li>If Application TRK reports "Not Connected"
+ <ol type="a">
+ <li>Click Options > Settings soft key </li>
+ <li>If Connection is not set to BlueTooth, choose BlueTooth </li>
+ <li>Click Ok soft key</li>
+ <li>Restart Application TRK </li>
+ </ol>
+ </li>
+ </ol>
+</div>
+ <h5>Related concepts</h5>
+ <ul>
+ <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
+ </ul>
+ <h5>Related references</h5>
+ <ul>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
+ </ul>
+ <h5>Related tasks</h5>
+ <ul>
+ <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth </a></li>
+ </ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx_usb.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_start_sisx_usb.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,48 +1,48 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Bluetooth Connectivity Setup</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>Starting the On-Device Debug Agent Using USB </h2>
-<div class="step">
- <p>The location of the TRK on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored.</p>
- <ol>
- <li>On the device
- <ol>
- <li>Launch Application TRK or System TRK program on the device</li>
- <li></li>
- </ol>
- </li>
- <li>Select PC-Suite from the USB Mode list</li>
- <li>Launch the Application TRK program</li>
- <li>Halt the Bluetooth device search by pressing the Cancel soft key</li>
- <li>Click Options > Settings > Connection</li>
- <li>Change Connection type to USB and set connection options</li>
- <blockquote>
- <p align="center"><img src="images/trk_connection_options.png" width="211" height="250" /> <img src="images/trk_usb_settings.png" width="211" height="250" /></p>
- <p class="figure">Figure 1 - Change connection type to USB and set connection options</p>
- </blockquote>
- <li>Select Back and start the TRK again and you should be connected</li>
- </ol>
-</div>
- <h5>Related concepts</h5>
- <ul>
- <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
- </ul>
- <h5>Related references</h5>
- <ul>
- <li><a href="../../reference/launch_configs/run_mode_overview.htm">Debug Window (On-device Debugging) Overview</a></li>
- </ul>
- <h5>Related tasks</h5>
- <ul>
- <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth </a></li>
- </ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Bluetooth Connectivity Setup</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>Starting the On-Device Debug Agent Using USB </h2>
+<div class="step">
+ <p>The location of the TRK on-device debug agent will vary based on the phone. On some phones it will be the Installed folder, on others it may be in My Own folder. Refer to the documentation that came with the phone to learn where installed programs are stored.</p>
+ <ol>
+ <li>On the device
+ <ol>
+ <li>Launch Application TRK or System TRK program on the device</li>
+ <li></li>
+ </ol>
+ </li>
+ <li>Select PC-Suite from the USB Mode list</li>
+ <li>Launch the Application TRK program</li>
+ <li>Halt the Bluetooth device search by pressing the Cancel soft key</li>
+ <li>Click Options > Settings > Connection</li>
+ <li>Change Connection type to USB and set connection options</li>
+ <blockquote>
+ <p align="center"><img src="images/trk_connection_options.png" width="211" height="250" /> <img src="images/trk_usb_settings.png" width="211" height="250" /></p>
+ <p class="figure">Figure 1 - Change connection type to USB and set connection options</p>
+ </blockquote>
+ <li>Select Back and start the TRK again and you should be connected</li>
+ </ol>
+</div>
+ <h5>Related concepts</h5>
+ <ul>
+ <li><a href="../../concepts/trk.htm">On-device Debugging </a></li>
+ </ul>
+ <h5>Related references</h5>
+ <ul>
+ <li><a href="../../projects/launch/page_main.htm">Debug Window (On-device Debugging) Overview</a></li>
+ </ul>
+ <h5>Related tasks</h5>
+ <ul>
+ <li><a href="trk_install_bluetooth.htm">Installing On-device Debug Agents using Bluetooth </a></li>
+ </ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_troubleshooting.htm Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/trk/trk_troubleshooting.htm Mon Aug 10 15:50:55 2009 -0500
@@ -1,125 +1,125 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<meta http-equiv="Content-Style-Type" content="text/css" />
-<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>On-device Debugging Troubleshooting</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-<h2>On-device Debugging Troubleshooting </h2>
-<p>If you are having problems with on-device debugging, see if the following solutions can solve the problem.</p>
-<h3><a name="deploy" id="deploy"></a>Deploying SIS Files using Carbide (Application TRK) </h3>
-<h4>Am unable to create my SIS file, what can cause this ?</h4>
-<blockquote>
- <p>Ensure that you are using symbols in your PKG file to generate the SIS file. See <a href="../projects/working_with_sis_pkg_files.htm">Working with PKG and SIS Files</a> for more details. </p>
-</blockquote>
-<h4>How do I know my SIS file got installed correctly?</h4>
-<blockquote>
- <p>If you did not receive an error message that Carbide.c++ could not install the SIS file, then go to the Application Manager on the phone and look for the SIS file. If the SIS file is there it tells you that Carbide.c++ successfully deployed the application to the device. </p>
- <p>Next, check the target directory on the device for the executable. If the executable is present, attempt to launch the executable. If the executable launches this lets you know the binaries were built correctly for the device. If the executable does not launch, try to build the application again using the command-line version of the tool.</p>
- <p>To verify the install process, go to the <a href="../../reference/launch_configs/app_trk_installation.htm">Installation</a> tab of your <a href="../../reference/launch_configs/run_mode_overview.htm">launch configuration</a> and disable the <b>Do not show installer UI on the phone</b> option. The next time Carbide.c++ attempts to deploy the application, prompts will appear on the phone verifying that it is okay to install the application. You can then watch the SIS file being installed on the phone. </p>
-</blockquote>
-<h4>How do I force the install of a SIS file to a device?</h4>
-<blockquote>
- <p>In Carbide.c++, go to the <a href="../../reference/launch_configs/app_trk_installation.htm">Installation</a> tab of your <a href="../../reference/launch_configs/run_mode_overview.htm">launch configuration</a> and enable the<b> Install each launch even if installer file has not changed</b> option. Once set, just click the <b>Debug</b> control again to deploy the new application binaries to the device. </p>
-</blockquote>
-<h4>Am getting the an error when attempting to install my SIS file, what can I do?</h4>
-<blockquote>
- <p>To get better error messages about possible install failures, go to the <a href="../../reference/launch_configs/app_trk_installation.htm">Installation</a> tab of your <a href="../../reference/launch_configs/run_mode_overview.htm">launch configuration</a> and disable the <b>Do not show installer UI on the phone</b> option. The next time Carbide.c++ attempts to deploy the application, prompts will appear on the phone verifying that it is okay to install the application. You can then watch the SIS file being installed on the phone. When the SIS file fails to install again, TRK will provide more specific errors on why the installation failed.</p>
-</blockquote>
-<h4>Am getting the error "process fails to launch", what can I do to correct this?</h4>
-<blockquote>
- <p>There are several things that can cause this error including:</p>
-</blockquote>
-<ul>
- <li>Verify deployment of the SIS file, see <b>How do I know my SIS file got installed correctly?</b> above. </li>
- <li>Verify that the MMP or PKG files does not contain any errors.</li>
- <li>If the application uses a self-signed SIS, a UID3 is required that is set within the proper address range. See <a href="https://www.symbiansigned.com/app/page/uidfaq">https://www.symbiansigned.com/app/page/uidfaq</a> for more info.</li>
- <li> Verify that the UID3 address matches between the MMP and PKG file if using Application TRK. If using Sys TRK, verify the File Transfer tab on the System TRK launch configuration is correct. </li>
- <li>Verify that your binaries are built correctly by attempting to launch the executable on the phone from the target directory. If this fails, rebuild the application using the command-line tools, then see <b>How do I force the install of a SIS file to a device</b>? above to redeploys and debug again. </li>
- <li>If debugging a DLL from an application and using System TRK, ensure that the DLL is included in the <a href="../../reference/launch_configs/page_file_transfer.htm">File Transfer</a> tab of the <a href="../../reference/launch_configs/run_mode_overview.htm">launch configuration</a> so that it is deployed to the device with the application. It is not added by default. </li>
-</ul>
-<h4>Am getting an exception when trying to debug with Application TRK </h4>
-<blockquote>
- <p>The main reason for this is that you have entered ROM code or another prohibited address space. You can confirm this by checking the Disassembler view. When in a prohibited memory address the view may be blank. To correct, click Step Over or Resume to move to the next breakpoint in your code.</p>
-</blockquote>
-<h4>I'm running out of memory on the device, what can I do?</h4>
-<blockquote>
- <p>On platforms that include Platform Security there are several directories like <span class="code">c:\sys\bin</span> where you cannot easily delete files that are no longer required. Over time the device's memory becomes full, making it difficult or impossible to install and debug additional programs.</p>
- <p>If using Application TRK to install and debug programs, use the Application Manager on the device to remove all the files specified in the program's PKG file, but not the SIS file itself. </p>
- <p>If you are using System TRK to install and debug programs and additional files, you will need to create a SIS that includes the files listed in the File Transfer pane, <a href="../start/carbide_deploying.htm">deploy</a> it manually to the device, then run the Application Manager on the device to remove the files.</p>
-</blockquote>
-<h3><a name="connect" id="connect"></a>Connectivity</h3>
-<h4>How can I use USB instead of Bluetooth to debug my application?</h4>
-<blockquote>
- <p>For USB support in TRK 2.5 or greater, while the TRK application is running on the phone, choose Options > Settings, then set Connection to USB.</p>
- <p>For USB support in TRK v2.1, include the metrotrk_usb.ini file instead of the metrotrk_bt.ini file in your ROM image. You do this by modifying the metrotrk.iby file like this:</p>
- <p>Replace the line:</p>
- <p class="code">data=ZSYSTEM\..\metrotrk\metrotrk_bt.ini \metrotrk.ini</p>
- <p>With:</p>
- <p class="code">data=ZSYSTEM\..\metrotrk\metrotrk_usb.ini \metrotrk.ini</p>
- <p>Then rebuild the ROM image.</p>
- <p class="note"><b>NOTE</b> With the S60 wk46 release onwards, the port number needs to be set to 1 instead of 0.</p>
- <h5>Installing Latest USB Drivers </h5>
- <p>On the host PC, you need to update the USB drivers to work with the latest S60
- devices. The latest drivers create a virtual com port on the host which you can
- specify in Carbide. Download and install the latest Nokia Connectivity Cable
- Drivers from PC Suite Vivaldi web site.</p>
- <p>When you first connect the USB cable to the phone you'll get a prompt to choose
- the "PC Suite" or "File Transfer" mode. Choose "PC Suite" mode to use TRK with
- USB. Also you will get several “New Hardware found” wizards. You need to go
- through the installation each time to successfully use the USB connection to
- access the device.</p>
- <h5>Connecting to Device using USB </h5>
- <p>If the current Connection setting on the phone is Bluetooth, when you start
- the TRK application on the phone you should see a list of Bluetooth devices.
- Press Cancel. In the TRK Welcome Screen press Options, then
- the Settings control. You should see the connection set to Bluetooth. Select
- the Options > Change option and change the
- connection option to USB. Your connection should now show as USB. Press
- Back to go to the TRK Welcome screen. In the TRK Welcome screen press Select >
- Connect. The status in the TRK welcome screen should show as connected. </p>
- <p>The next time you connect the USB cable to the phone you’ll get a prompt to
- choose the "PC Suite" or "File Transfer" mode. Choose "PC Suite" mode to use
- TRK with USB. Then start the TRK application.</p>
-</blockquote>
-<h4>What is the virtual COM port number for my S60 phone on the host PC if I am using USB?</h4>
-<blockquote>
- <p>Normally, you can determine the COM port ID using the Device Manager if TRK is already connected via USB.
- </p>
- <p>To check, choose Start > Settings > Control panel > System > Hardware > Device Manager. In the Device Manager, choose "Ports" to view the active ports (Figure 1).</p>
- <p align="center"><img src="images/trk_device_manager.gif" width="323" height="210" /></p>
- <p class="figure">Figure 1. Ports displayed in Ports section of Device Manager.</p>
- <p>In some situations all USB virtual COM ports are installed under "Modems" in the Device Manager. In the Device Manager dialog, choose "Modems" and see if there are two COM ports listed. One of them will work for debugging. Most of the time, the higher port number works for debugging with TRK.</p>
-</blockquote>
-<h4>I am having difficulty getting a Bluetooth connection to work with AppTRK, any suggestions?</h4>
-<blockquote>
- <p>The following are known issues when trying to use Bluetooth serial port on the host:</p>
-</blockquote>
-<ul>
- <li>XP Microsoft Bluetooth stack does not work correctly with bt serial port emulation (on the PC side). For using TRK, you need BT serial port emulation. Some of the BT dongle manufacturers recommend changing to their own drivers to enable Bt stack serial port emulation.
- <ul>
- <li> Resolution at the moment: Change the XP drivers to bt dongle manufacturers (IBM, TDK, MSI) own drivers by uninstalling the XP drivers and installing the dongle drivers. After the installation the Microsoft Bluetooth Enumerator and Microsoft Bluetooth Services must be shut down.</li>
- <li>From Computer Management -> Device Manager uninstall the Microsoft BT Enumerator</li>
- <li>From Computer Management -> Services and Applications -> Services shutdown the Microsoft Bluetooth Services</li>
- <li>On the desktops, the Belkin Bluetooth dongle is known to properly provide BT Serial port emulation. Other Bluetooth dongles should work as long as the serial port service is provided by the Bluetooth driver</li>
- </ul>
- </li>
-</ul>
-<h4>TRK is launched on the device, but I am getting “Can’t connect to TRK” error message in the Carbide.c++ tools, any suggestions?</h4>
-<blockquote>
- <p>Check that Carbide.c++ and your USB Virtual COM port or BT Serial Port agree on the port settings.</p>
-</blockquote>
-<ul>
- <li>Use the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup</a> dialog to quickly determine if you can communicate with the device in the <strong>Check TRK version</strong> pane </li>
- <li>Open your Bluetooth or USB cable's connection settings: Start -> Settings -> Control panel -> System -> Hardware -> Device Manager. In the Device Manager dialog, click open the Ports directory, then you will see all the com ports available on the machine. Here you will be able to see the COM port for Bluetooth or USB. Sometimes you will have two COM ports for Bluetooth, so you might have to try specifying either of them. </li>
- <li>In the Carbide tools, <a href="../projects/prj_debug_config.htm">open</a> the launch configuration associated with the target device and verify that you have specified the correct launch configuration for TRK. For example, the launch configuration should be either Symbian OS Application TRK or Symbian OS System TRK configuration. </li>
- <li>In the Carbide tools, <a href="../projects/prj_debug_config.htm">open</a> the launch configuration associated with the target device. In the Connections tab make sure you specify the same COM port number as in the device manager. For Bluetooth, if two ports are listed in the device manager, then you need to try to both, to see which one works. For USB, don't select the COM port assigned to the serial port. Always select the COM port assigned to the virtual COM port ID for the phone that is specified in the Device Manager. </li>
- <li>Make sure the settings in these two dialogs are the same and that the launch configuration settings refer to the right COM port. You shouldn't have to touch the other settings, but they're Data Bits: 8; Parity: None; Stop Bits: 1; Flow Control: None. </li>
-</ul>
-<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
-
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>On-device Debugging Troubleshooting</title>
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2>On-device Debugging Troubleshooting </h2>
+<p>If you are having problems with on-device debugging, see if the following solutions can solve the problem.</p>
+<h3><a name="deploy" id="deploy"></a>Deploying SIS Files using Carbide (Application TRK) </h3>
+<h4>Am unable to create my SIS file, what can cause this ?</h4>
+<blockquote>
+ <p>Ensure that you are using symbols in your PKG file to generate the SIS file. See <a href="../projects/working_with_sis_pkg_files.htm">Working with PKG and SIS Files</a> for more details. </p>
+</blockquote>
+<h4>How do I know my SIS file got installed correctly?</h4>
+<blockquote>
+ <p>If you did not receive an error message that Carbide.c++ could not install the SIS file, then go to the Application Manager on the phone and look for the SIS file. If the SIS file is there it tells you that Carbide.c++ successfully deployed the application to the device. </p>
+ <p>Next, check the target directory on the device for the executable. If the executable is present, attempt to launch the executable. If the executable launches this lets you know the binaries were built correctly for the device. If the executable does not launch, try to build the application again using the command-line version of the tool.</p>
+ <p>To verify the install process, go to the <a href="../../projects/launch/page_main.htm">Installation</a> tab of your <a href="../../projects/launch/page_main.htm">launch configuration</a> and disable the <b>Do not show installer UI on the phone</b> option. The next time Carbide.c++ attempts to deploy the application, prompts will appear on the phone verifying that it is okay to install the application. You can then watch the SIS file being installed on the phone. </p>
+</blockquote>
+<h4>How do I force the install of a SIS file to a device?</h4>
+<blockquote>
+ <p>In Carbide.c++, go to the <a href="../../projects/launch/page_main.htm">Installation</a> tab of your <a href="../../projects/launch/page_main.htm">launch configuration</a> and enable the<b> Install each launch even if installer file has not changed</b> option. Once set, just click the <b>Debug</b> control again to deploy the new application binaries to the device. </p>
+</blockquote>
+<h4>Am getting the an error when attempting to install my SIS file, what can I do?</h4>
+<blockquote>
+ <p>To get better error messages about possible install failures, go to the <a href="../../projects/launch/page_main.htm">Installation</a> tab of your <a href="../../projects/launch/page_main.htm">launch configuration</a> and disable the <b>Do not show installer UI on the phone</b> option. The next time Carbide.c++ attempts to deploy the application, prompts will appear on the phone verifying that it is okay to install the application. You can then watch the SIS file being installed on the phone. When the SIS file fails to install again, TRK will provide more specific errors on why the installation failed.</p>
+</blockquote>
+<h4>Am getting the error "process fails to launch", what can I do to correct this?</h4>
+<blockquote>
+ <p>There are several things that can cause this error including:</p>
+</blockquote>
+<ul>
+ <li>Verify deployment of the SIS file, see <b>How do I know my SIS file got installed correctly?</b> above. </li>
+ <li>Verify that the MMP or PKG files does not contain any errors.</li>
+ <li>If the application uses a self-signed SIS, a UID3 is required that is set within the proper address range. See <a href="https://www.symbiansigned.com/app/page/uidfaq">https://www.symbiansigned.com/app/page/uidfaq</a> for more info.</li>
+ <li> Verify that the UID3 address matches between the MMP and PKG file if using Application TRK. If using Sys TRK, verify the File Transfer tab on the System TRK launch configuration is correct. </li>
+ <li>Verify that your binaries are built correctly by attempting to launch the executable on the phone from the target directory. If this fails, rebuild the application using the command-line tools, then see <b>How do I force the install of a SIS file to a device</b>? above to redeploys and debug again. </li>
+ <li>If debugging a DLL from an application and using System TRK, ensure that the DLL is included in the <a href="../../projects/launch/page_file_transfer.htm">File Transfer</a> tab of the <a href="../../projects/launch/page_main.htm">launch configuration</a> so that it is deployed to the device with the application. It is not added by default. </li>
+</ul>
+<h4>Am getting an exception when trying to debug with Application TRK </h4>
+<blockquote>
+ <p>The main reason for this is that you have entered ROM code or another prohibited address space. You can confirm this by checking the Disassembler view. When in a prohibited memory address the view may be blank. To correct, click Step Over or Resume to move to the next breakpoint in your code.</p>
+</blockquote>
+<h4>I'm running out of memory on the device, what can I do?</h4>
+<blockquote>
+ <p>On platforms that include Platform Security there are several directories like <span class="code">c:\sys\bin</span> where you cannot easily delete files that are no longer required. Over time the device's memory becomes full, making it difficult or impossible to install and debug additional programs.</p>
+ <p>If using Application TRK to install and debug programs, use the Application Manager on the device to remove all the files specified in the program's PKG file, but not the SIS file itself. </p>
+ <p>If you are using System TRK to install and debug programs and additional files, you will need to create a SIS that includes the files listed in the File Transfer pane, <a href="../start/carbide_deploying.htm">deploy</a> it manually to the device, then run the Application Manager on the device to remove the files.</p>
+</blockquote>
+<h3><a name="connect" id="connect"></a>Connectivity</h3>
+<h4>How can I use USB instead of Bluetooth to debug my application?</h4>
+<blockquote>
+ <p>For USB support in TRK 2.5 or greater, while the TRK application is running on the phone, choose Options > Settings, then set Connection to USB.</p>
+ <p>For USB support in TRK v2.1, include the metrotrk_usb.ini file instead of the metrotrk_bt.ini file in your ROM image. You do this by modifying the metrotrk.iby file like this:</p>
+ <p>Replace the line:</p>
+ <p class="code">data=ZSYSTEM\..\metrotrk\metrotrk_bt.ini \metrotrk.ini</p>
+ <p>With:</p>
+ <p class="code">data=ZSYSTEM\..\metrotrk\metrotrk_usb.ini \metrotrk.ini</p>
+ <p>Then rebuild the ROM image.</p>
+ <p class="note"><b>NOTE</b> With the S60 wk46 release onwards, the port number needs to be set to 1 instead of 0.</p>
+ <h5>Installing Latest USB Drivers </h5>
+ <p>On the host PC, you need to update the USB drivers to work with the latest S60
+ devices. The latest drivers create a virtual com port on the host which you can
+ specify in Carbide. Download and install the latest Nokia Connectivity Cable
+ Drivers from PC Suite Vivaldi web site.</p>
+ <p>When you first connect the USB cable to the phone you'll get a prompt to choose
+ the "PC Suite" or "File Transfer" mode. Choose "PC Suite" mode to use TRK with
+ USB. Also you will get several “New Hardware found” wizards. You need to go
+ through the installation each time to successfully use the USB connection to
+ access the device.</p>
+ <h5>Connecting to Device using USB </h5>
+ <p>If the current Connection setting on the phone is Bluetooth, when you start
+ the TRK application on the phone you should see a list of Bluetooth devices.
+ Press Cancel. In the TRK Welcome Screen press Options, then
+ the Settings control. You should see the connection set to Bluetooth. Select
+ the Options > Change option and change the
+ connection option to USB. Your connection should now show as USB. Press
+ Back to go to the TRK Welcome screen. In the TRK Welcome screen press Select >
+ Connect. The status in the TRK welcome screen should show as connected. </p>
+ <p>The next time you connect the USB cable to the phone you’ll get a prompt to
+ choose the "PC Suite" or "File Transfer" mode. Choose "PC Suite" mode to use
+ TRK with USB. Then start the TRK application.</p>
+</blockquote>
+<h4>What is the virtual COM port number for my S60 phone on the host PC if I am using USB?</h4>
+<blockquote>
+ <p>Normally, you can determine the COM port ID using the Device Manager if TRK is already connected via USB.
+ </p>
+ <p>To check, choose Start > Settings > Control panel > System > Hardware > Device Manager. In the Device Manager, choose "Ports" to view the active ports (Figure 1).</p>
+ <p align="center"><img src="images/trk_device_manager.gif" width="323" height="210" /></p>
+ <p class="figure">Figure 1. Ports displayed in Ports section of Device Manager.</p>
+ <p>In some situations all USB virtual COM ports are installed under "Modems" in the Device Manager. In the Device Manager dialog, choose "Modems" and see if there are two COM ports listed. One of them will work for debugging. Most of the time, the higher port number works for debugging with TRK.</p>
+</blockquote>
+<h4>I am having difficulty getting a Bluetooth connection to work with AppTRK, any suggestions?</h4>
+<blockquote>
+ <p>The following are known issues when trying to use Bluetooth serial port on the host:</p>
+</blockquote>
+<ul>
+ <li>XP Microsoft Bluetooth stack does not work correctly with bt serial port emulation (on the PC side). For using TRK, you need BT serial port emulation. Some of the BT dongle manufacturers recommend changing to their own drivers to enable Bt stack serial port emulation.
+ <ul>
+ <li> Resolution at the moment: Change the XP drivers to bt dongle manufacturers (IBM, TDK, MSI) own drivers by uninstalling the XP drivers and installing the dongle drivers. After the installation the Microsoft Bluetooth Enumerator and Microsoft Bluetooth Services must be shut down.</li>
+ <li>From Computer Management -> Device Manager uninstall the Microsoft BT Enumerator</li>
+ <li>From Computer Management -> Services and Applications -> Services shutdown the Microsoft Bluetooth Services</li>
+ <li>On the desktops, the Belkin Bluetooth dongle is known to properly provide BT Serial port emulation. Other Bluetooth dongles should work as long as the serial port service is provided by the Bluetooth driver</li>
+ </ul>
+ </li>
+</ul>
+<h4>TRK is launched on the device, but I am getting “Can’t connect to TRK” error message in the Carbide.c++ tools, any suggestions?</h4>
+<blockquote>
+ <p>Check that Carbide.c++ and your USB Virtual COM port or BT Serial Port agree on the port settings.</p>
+</blockquote>
+<ul>
+ <li>Use the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Setup</a> dialog to quickly determine if you can communicate with the device in the <strong>Check TRK version</strong> pane </li>
+ <li>Open your Bluetooth or USB cable's connection settings: Start -> Settings -> Control panel -> System -> Hardware -> Device Manager. In the Device Manager dialog, click open the Ports directory, then you will see all the com ports available on the machine. Here you will be able to see the COM port for Bluetooth or USB. Sometimes you will have two COM ports for Bluetooth, so you might have to try specifying either of them. </li>
+ <li>In the Carbide tools, <a href="../projects/prj_debug_config.htm">open</a> the launch configuration associated with the target device and verify that you have specified the correct launch configuration for TRK. For example, the launch configuration should be either Symbian OS Application TRK or Symbian OS System TRK configuration. </li>
+ <li>In the Carbide tools, <a href="../projects/prj_debug_config.htm">open</a> the launch configuration associated with the target device. In the Connections tab make sure you specify the same COM port number as in the device manager. For Bluetooth, if two ports are listed in the device manager, then you need to try to both, to see which one works. For USB, don't select the COM port assigned to the serial port. Always select the COM port assigned to the virtual COM port ID for the phone that is specified in the Device Manager. </li>
+ <li>Make sure the settings in these two dialogs are the same and that the launch configuration settings refer to the right COM port. You shouldn't have to touch the other settings, but they're Data Bits: 8; Parity: None; Stop Bits: 1; Flow Control: None. </li>
+</ul>
+<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
+
+</body>
+</html>
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_both_resolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_both_unresolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_read_resolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_read_unresolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_write_resolved.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/watchpoints/images/icon_watchpoint_write_unresolved.png has changed
--- a/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Mon Aug 10 14:45:48 2009 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Mon Aug 10 15:50:55 2009 -0500
@@ -15,6 +15,7 @@
</topic>
<topic label="Tour of the UI" href="html/concepts/tour.html" />
+ <topic label="Concepts" href="html/concepts/concepts.htm" />
<topic label="Application Emulator Debug Example" href="html/tasks/start/carbide_example.htm" >
<topic label="1. Creating New Projects" href="html/tasks/CreatingNewProjects.html" />