core/com.nokia.carbide.cpp.doc.user/html/release_notes.htm
author fturovic <frank.turovich@nokia.com>
Fri, 28 Aug 2009 14:08:53 -0500
changeset 466 c4dbcabf03e8
parent 411 35486de5be1b
child 470 6eee0076d222
permissions -rw-r--r--
BUG 9748 - revised version number and link

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  <title>Carbide.c++ Release Notes</title>
  <link href="../book.css" rel="stylesheet" type="text/css" />
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  <link href="../book.css" rel="stylesheet" type="text/css" />
  <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
  <style type="text/css">
.style1 {font-family: "Courier New", Courier, mono}
.style5 {color: #FF0000}
.style6 {font-weight: bold}
  .style8 {color: #000000; font-weight: bold; }
  </style>
</head>
<body bgcolor="#ffffff">
<h2>Carbide.c++ Release Notes 2.2.0</h2>
<p>The Carbide.c++  is a comprehensive development tool suite for Symbian OS that is based on the Eclipse framework. The C++ Development Toolkit (CDT), provides the foundation for project and build tools management, as well as the primary interface for the debugger to communicate with the IDE. </p>
<p>This is a collection of important information concerning last-minute
  changes and other topics that deserve special attention.&nbsp;Please
  read these notes carefully before using the Carbide tools so you
  understand the current limitations and workarounds for known
  issues. </p>
<ul>
  <li><a href="#whatsNew">What's new </a></li>
  <li><a href="#beta">User notes</a></li>
  <li><a href="bugs_fixed.htm">Fixed bugs</a> and <a href="#issues">workarounds</a></li>
  <li><a href="#support">Technical support</a> </li>
</ul>
<p>Once you have read the release notes, we recommend you follow the <img src="images/command_link.png" width="16" height="12" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.cheatsheets.openCheatSheet(cheatSheetId=com.nokia.carbide.cpp.doc.user.getStarted)")'>HelloWorld tutorial</a> for
a quick introduction to Carbide.c++.</p>
<p class="note" style="color: rgb(255, 0, 0);"><span style="font-weight: bold;">WARNING</span>:
Updating the CDT feature in Carbide.c++/Eclipse will wipe out our
changes making the tools unusable!</p>
<p> See the <a href="hints_tips.htm">Tips &amp; tricks</a> page for more helpful information.</p>
<h3><a name="whatsNew" id="whatsNew2"></a>What's New in 2.2.0 </h3>
<p>The following features for Symbian  development are provided within Carbide.c++:</p>
<ul>
  <li><b>Eclipse 3.5 </b>&#8212; The Eclipse 3.5 project (Galileo) provides the foundation, or integration platform, on which  Carbide.c++  is built. See <a href="PLUGINS_ROOT/org.eclipse.platform.doc.user/whatsNew/platform_whatsnew.html">What's New in 3.5</a> for more information.</li>
</ul>
<ul>
  <li><b>CDT 6.0 </b>&#8212; The final version of CDT included as part of the Galileo release. See the <a href="http://wiki.eclipse.org/CDT/User/NewIn60">CDT 6.0 News and Noteworthy</a> page for more information.</li>
  <li><b>Java 6.0 </b>&#8212; Due to the above changes Carbide has also updated to use the Java Runtime Environment (JRE) 6.0. See <a href="http://java.sun.com/javase/6/webnotes/features.html">Java SE 6 Release Notes</a> page for more information.</li>
</ul>
<h4><a name="210" id="210"></a>2.1.0</h4>
<ul>
  <li><b>Performance inprovements</b> - the following areas of Carbide have been optimized to improve performance:
    <ul>
      <li><b>Importing large projects</b>   - Importing large projects is one of our primary points of performance improvements. When too many project roots were used the more source and include paths were brought into the project, up to an including entire SDKs. Generally, we found that once a project root contains over 15-20K files Carbide became extremely sluggish. We have improved some edge cases where project roots were calculated incorrectly and now include only what's really needed. </li>
      <li><b>Modifying Project Settings and Build Configuration Data</b>-    This is quite a significant improvement as modifying MMP files and switching build configurations are a couple of the most common operations done by end-users and because the time spent processing project and configuration data is done on the main thread, locking the UI. With optimization in one CDT function we were able to bring most project-related and configuration switch changes from 20 seconds to less than 3 seconds. You should also see improvements when saving MMP and INF files (the &quot;Refreshing Configuration Job&quot;). </li>
      <li><b>Executables View Refreshing</b> - The Executables view refresh was impacting everything from IDE start-up to import and project creation as well refreshes during rebuilds. Some of our wall clock tests on large projects (such as contacts the browser) show the executables job running from 15-25 seconds down to about 5 seconds.</li>
      <li><b>Indexing Options</b>  - Use the <b>Indexing Options</b> section in the <a href="reference/wnd_carbide_pref.htm">Carbide.c++</a> preference panel to control how  project MMP files are indexed.</li>
    </ul>
  </li>
  <li><b>New Launch Configuration improvements</b> - The <b>New Launch Configuration</b> wizard now starts with a new <a href="projects/launch/wiz_new_launch_config.htm#CATEGORY">Category Selection</a> page which helps guide developers in choosing the correct launch configuration  for a project, whether it be for Phones, Boards, or other target devices. In addition, the <a href="projects/launch/wiz_new_launch_config.htm#BLD_OPT">Build Options Selection</a> page enables developers to define if a project is automatically built or not at the launch configuration level.</li>
  <li><b>Customization (.bsf) and Symbian Variant Binary (.var) platform</b> discovery is now supported. See the Platform Filtering Preference panel for details.</li>
  <li><b>TRK improvements</b> - TRK continues to evolve and now includes these improvements:
    <ul>
      <li>TRK now automatically reconnects if you disconnect the USB cable and then reconnect.</li>
      <li>Added support for targeting nested static libraries of a polymorphic dll. </li>
      <li>TRK now checks for  duplicates before adding a library to the target list to avoid sending duplicate library loading commands (bug 9035).</li>
      <li>Users no longer need to specify a port number for Bluetooth connections as TRK now automatically locates BT serial port and uses that for the connections setup (bug 2502).</li>
    </ul>
  </li>
  <li><b>Keywords in preference panels and property pages</b> - All Carbide related preference panels and project property pages now include keywords to make searching for options a bit easier.</li>
  <li><b>New Carbide Extensions section</b> - Project Property dialogs now include a <b>Carbide Extensions</b> section which allows Carbide plug-in and utilities a place to add their own project  settings pages.</li>
</ul>
<h4>2.0.4</h4>
<ul>
  <li><b>Hover Help</b> - hover your pointer over a recognized Symbian symbol in an editor and see the Symbian API Reference information appear to assist you.</li>
</ul>
<h4>2.0.3</h4>
<ul>
  <li><b>Carbide.c++ News Reader</b> - introducing the <a href="reference/view_carbide_news.htm">Carbide.c++ News</a> view which provides the latest Carbide, Symbian, and S60 news as well as news on tools updates and screencasts for Carbide development.</li>
</ul>
<h4>2.0.0</h4>
<ul><li><b>Eclipse 3.4.1 </b>&#8212; The Eclipse 3.4 project (Ganymede) provides the foundation, or integration platform, on which  Carbide.c++  is built. See <a href="PLUGINS_ROOT/org.eclipse.platform.doc.user/whatsNew/platform_whatsnew.html">What's New in 3.4</a> for more information.</li>
</ul>
<ul><li><b>CDT 5.0.1</b> &#8212; The final version of CDT included as part of the Ganymede release. See the <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/concepts/cdt_c_whatsnew.htm">CDT 5.0 News and Noteworthy</a> page for more information. </li>
  <li><b>SDK Migration support in CodeScanner</b> &#8212; CodeScanner now includes support for S60 SDK rules that provide helpful migration information on S60 functions within any C/C++ editor view and provide links to additional information within the SDK documentation or web. Very helpful during development to keep you code up-to-date with the latest SDK revisions.</li>
  <li><b>Qt SDK for S60  support </b>&#8212; Carbide now <a href="qt_help/qt_overview.htm">supports</a> the <a href="qt_help/qt_importing_projs_01.htm">importing</a> and <a href="qt_help/qt_creating_projs_01.htm">creation</a> of Qt projects using the  <a href="http://trolltech.com/developer/technical-preview-qt-for-s60">Qt SDK for S60</a>.</li>
  <li><b>Executables view improvements</b> &#8212; The <a href="reference/view_executables.htm">Executables</a> view now supports the loading of some additional DLL cases to ensure that the DLLs you want to debug are available during a debug session. In addition,  a Remove button has been added to the view's toolbar that makes it easier for you to remove any executables from the list.</li>
  <li><b>More indexer improvements </b>&#8212; Speed improvements for code completion, syntax coloring, and much more.</li>
  <li><b>Remote Connections view</b> &#8212; A visual list of <a href="reference/trk/view_remote_connection.htm">remote connections</a> and their state for managing multiple and diverse device connections.</li>
  <li><b>Partial upgrade SIS file support</b> &#8212; Carbide now supports the generation of partial upgrade  SIS/SISX files. This increases debugger turnaround by only generating new files for changes and uploading these smaller executables to the device.</li>
  <li><b>More Program Counter support </b>&#8212; Added a Move to Line command for the debugger that enables you to move the PC to a new line while debugging without executing any intermediate lines or resuming execution.</li>
  <li>Multiple<b> TRK</b> improvements including:
    <ul>
      <li>Both App and System TRK try to disable mobile crash debugging</li>
      <li>TRK now looks for the new mobile crash agent (ms_useragent)</li>
      <li>Added additional error checking when communicating over USB to improve stability</li>
      <li>Fixed some random TRK deadlocks when reading registers or when thread panics occur</li>
      <li>Option &gt; Exit has been replaced by Option &gt; Back to reflect the change made to exiting TRK</li>
      <li>Changes made to use UIDs in place of component names to identify executables for improved identification</li>
      <li>Reset TRK priority to high to avoid problems debugging complex process intensive applications</li>
      <li>Improved breakpoint location in DLLs when debugging multiple processes</li>
      <li>TRK no longer targets processes with UID 0 automatically. Users can still attach to the process or use a launch configuration.</li>
      <li>TRK application name and UID changed to blocking of TRK SIS files assigned with the old UID.</li>
      <li>TRK now always uses the kernel APIs to read/write memory to improve security, no more direct reads/writes.</li>
      <li>Application TRK  no longer allows write operations to the following registers: CPSR, SP, and LR</li>
    </ul>
  </li>
</ul>
<h4>1.3.1</h4>
<ul>
  <li><b><a href="reference/trk/wnd_on_device_setup.htm">On-Device Setup</a> </b> dialog &#8212; connects, verifies and updates Carbide software services like the TRK debug agent on a device to ensure you are always using the latest version in your development efforts. Having trouble connecting with  TRK, give this a try. </li>
  <li><b>New Bug Report wizard  </b> &#8212; directly submit bugs and enhancement requests  to  Carbide Bugzilla from within Carbide using the <strong>Help &gt; New Bug Report</strong> menu option. Enter the name and password into the Bug Reporter preference panel and quick bug reports are easy to submit. </li>
  <li><strong>Launch configuration panels UI unification and improvements</strong>&#8212; a host of minor UI improvements are being made in the launch configuration panes to provide a more coherent and reproducible experience across all launch configuration dialogs. </li>
</ul>
<blockquote>
  <p>For example, the concept of a &quot;main executable&quot; had been replaced with the Executables tab where a list of executables targeted for debugging were shown. This UI change brings the launch configurations into sync with that change by removing the Main Executable from the Main tab. The Main tab will only show a process to launch and not executables targeted for debugging. </p>
  <p>Another example, the Arguments field used by the run-mode TRK configurations has been moved to the Arguments tab to match the Emulator configuration.</p>
</blockquote>
<ul>
  <li>Many other bug fixes to improve stability and usability on Carbide </li>
</ul>
<h4>1.3.0</h4>
<ul>
  <li><b>Eclipse 3.3.1.1</b> &#8212; The Eclipse 3.3 project provides the foundation, or integration platform, for which the product is built upon. See <a href="PLUGINS_ROOT/org.eclipse.platform.doc.user/whatsNew/platform_whatsnew.html">What's New in 3.3</a> for more information.</li>
  <li><b>CDT 4.0.1</b> &#8212; This drop is based on a final version of CDT that was part of the Europa release. See the <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/concepts/cdt_c_whatsnew.htm">CDT 4.0 News and Noteworthy</a> page for more information. </li>
  <li><b>Build system improvements</b> &#8212; large project support has been enhanced for builds and indexing, but performance trade offs have been made so the latter improvements are possible. This is most noticeable when importing projects and making changes to <span class="code">bld.inf</span> and <span class="code">mmp</span> files.</li>
  <li><b>System search</b> &#8212; search any directory outside the workspace. </li>
  <li><b>Debugging improvements include:</b>
    <ul>
      <li><b>Executables view</b> &#8212; provides a dynamic list of executables and their related source files </li>
      <li><b>Executables tab</b> &#8212; uses a rule based approach in launch configurations  to include/exclude executables in the project </li>
      <li><b>On-device debugging</b> &#8212; lots of TRK  (v2.8.6) fixes here to make on-device debugging easier and more stable </li>
    </ul>
  </li>
  <li><b>Carbide tool plug-ins include</b>:
    <ul>
      <li>CodeScanner - a static source code analysis tool for Symbian OS programs written in C++</li>
      <li>Capability Scanner and Epocwind.out Scanner - performs static and runtime capability checks on your project </li>
      <li>Dependency Explorer - analyses static dependencies between  components</li>
    </ul>
  </li>
  <li><b>Indexing improvements</b></li>
  <li>The creation of EKA1-based projects has been deprecated with this release. Carbide still supports its use but all development going forward will concentrate on EKA2-based projects. </li>
  <li><b>Lots of bug fixes</b>... </li>
</ul>
<h3><a name="beta" id="beta"></a>User Notes</h3>
<ul><li><b>New extension makefiles</b> - if your project is using the new extension makefile support in OS9.3+ (<span class="code">prj_extensions</span>), you will get a build error with the default builder settings.  We plan to fix this issue, but for now you can work around it by disabling the manage dependencies and concurrent compilation builder options found in the <b>Carbide.c++ &gt; Build</b> preference panel.</li>
  <li><b>Qt for Symbian support</b> - The Qt views require registered COM plugins in order to work correctly.  These plugins are registered by our installer.  If you did not use our installer or have uninstalled an existing Qt Eclipse integration after installing Carbide, you'll need to register the plugins by running a batch file.  You'll find the batch file here: \configuration\qt\register_plugins.bat.  You'll know that you need to run the batch file if you get exceptions when opening one of the Qt views.</li>
</ul>
<h3><a name="issues" id="issues"></a>Fixed bugs and workarounds</h3>
<ul>
  <li>Complete list of Carbide.c++ <a href="bugs_fixed.htm">bugs fixed</a></li>
  <li>Workarounds for known issues: </li>
</ul>
<table cellpadding="0" cellspacing="0" border="0" style="text-align: left; width: 100%;">
  <tbody>
    <tr>
      <th 
 style="vertical-align: top; text-align: center; font-weight: bold; ">Summary<br />      </th>
      <th 
 style="vertical-align: top; text-align: center; font-weight: bold; ">Workaround</th>
    </tr>
    <tr align="center">
      <td colspan="2" bgcolor="#FFFFCC"><a name="CRITICAL_ITEMS"></a><span class="style8">CRITICAL ITEMS</span></td>
    </tr>
    <tr>
      <td class="style5" style="vertical-align: top;"><b>WARNING:</b> The C/C++ Files view is a view of the actual FILE SYSTEM, so anything deleted in this view is also deleted from the file system. </td>
      <td style="vertical-align: top;"><p>When deleting projects from the workspace please be sure you read the dialog that describes the  files that will be deleted. Select the &quot;Do not delete files&quot; option to keep them in the file system.</p>      </td>
    </tr>
    <tr>
      <td style="vertical-align: top;"><span class="style5">Carbide.c++ terminates on startup on low memory machines</span></td>
      <td style="vertical-align: top;"> <p>Machines with less than 1GB of memory (or machines running in a virtual machine) may experience start-up problems. Error dialog typically contains: </p>
        <p><span class="code">JVM terminated, Return code = -1 </span></p>
        <p>or when running from eclipse.exe: </p>
        <p><span class="code">Error occurred during initialization of VM  Could not reserve enough space for object heap</span> </p>
<p>The <a href="hints_tips.htm">solution</a> is to edit your <span class="code">Carbide.c++.1.x.ini</span> (or <span class="code">eclipse.ini</span> if launching Eclipsec.exe) and use a smaller value for the <span class="code">-Xmx </span>parameter to the JVM. </p>
<p class="note"><b>NOTE</b> In this scenario, Carbide.c++ performance may degrade.</p></td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[4587] Unable to build  GCCE targets on Vista because of makefile error.</td>
      <td style="vertical-align: top;">There are known tooling issues when building for the GCCE platform under Windows Vista that can prevent a GCCE build from occurring.  If you want to build for GCCE under S60 and UIQ you will need to manually update some files under<span class="style1"> \epoc32\tools\</span>. See the article <a href="http://wiki.forum.nokia.com/index.php/Windows_Vista">Windows Vista</a> for up-to-date workaround information.</td>
    </tr>
    <tr bgcolor="#0071ff">
      <td colspan="2" bgcolor="#FFFFCC" style="vertical-align: top;">
      <div align="center" class="style6"><a name="bug_ide"></a><span class="style8">IDE</span></div>      </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Debugging a project on a machine running Vista via &quot;Remote Desktop Connection&quot; does not work. </td>
      <td style="vertical-align: top;">Workaround: Switch the project to a machine running Windows XP in order to use &quot;Remote Desktop Connection&quot;. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[6414] Using Mylyn causes MMP files to be spell checked and common terms like EXE, CPP, and EUSER.LIB flagged as misspellings in editor views </td>
      <td style="vertical-align: top;"><p>Workaround: Remove Mylyn from the Carbide installation. </p>      </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">The C/C++ Editor will only work properly with files inside project source folders or on include paths. Source folders are configured in the project settings on the C/C++ Project Paths &gt; Source tab. </td>
      <td style="vertical-align: top;">When creating new folders, use File &gt; New &gt; Source Folder. This will add a folder and mark it a source folder. If you need to import copies of existing files (File &gt; Import &gt; File System) or link to existing sources (File &gt; New &gt; Folder with &quot;Link to folder in file system&quot;), then a normal folder will be created, not a source folder. If the folder is not underneath an existing source folder in the project, you will need to manually mark it as a source folder using the C/C++ Project Paths &gt; Source tab. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[3803] Occasionally a module is not expandable immediately after it's been imported in a project. </td>
      <td style="vertical-align: top;">Workaround: Simply close and reopen the project using the context menu in the Project view.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[3010] Bad synchronization in MMP editor for Linker definition file.</td>
      <td style="vertical-align: top;">  The templates for Symbian DLL projects do not define a <span class="code">DEFFILE</span> statement, for the case where a <span class="code">DEF</span> file is not needed or imports are not frozen. If you edit the <span class="code">DEF</span> filename through the MMP editor, it is not automatically conditioned for the current target. If you wish to define target-specific <span class="code">DEF</span> file names in the MMP editor, manually insert <span class="code">#ifdef...#endif</span> blocks, or first uncomment the <span class="code">#ifdef...#endif</span> block from the template, so that target-specific filenames will be properly updated.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[2784] Changes to contents of <span class="code">#includes</span> of bld.inf and MMP files are not performed -- instead, changes involving reordering or deleting go to the main file. </td>
      <td style="vertical-align: top;">Workaround: if making changes to nests of included files, either manually edit the <span class="code">#included</span> files, or if using MMP or bld.inf editors, look for changes in the main bld.inf or MMP file and manually fix them up.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Indexer coloring for problems</td>
      <td style="vertical-align: top;">The problems marker for the indexer occasionally reports both false negative and false positive results (see indexer bugs below). The problems color by default is set to a dark gray to suggest a possible ambiguous state of the browser. You can change this color under the global preferences page: Syntax Coloring. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[4932] Indexer: Problems with templates </td>
      <td style="vertical-align: top;">C++ template navigation is not fully supported yet. Problem areas are notable when templates are declared outside the file they are used and when functions or macros use template declarations. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[4937, 4941] Indexer: Problems with macro navigation </td>
      <td style="vertical-align: top;">Browsing to macro declarations is problematic when macros are used within function call parameters as well as multi-line macro declarations.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[4931] Indexer does not track files outside the workspace. </td>
      <td style="vertical-align: top;">If you make changes to files outside the workspace the indexer will not re-index these files (e.g. .rsg files under the SDK). When in doubt, re-index your project. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[4906] Indexer: const parameters get lost in function prototypes occasionally</td>
      <td style="vertical-align: top;">The indexer sometimes loses the parameter of function types for const objects. In these cases code navigation will not work. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Target type macros (__EXE__, __DLL__, etc) are not always defined for the CDT indexer.</td>
      <td style="vertical-align: top;">The CDT indexer macros are build configuration specific.  There could be multiple mmp's for a build configuration, each with a different target type macro.  Therefore the target type macro is only added if there is only one mmp file, or if all of the mmp's have the same target type macro.  You can manually add the macro if you wish using the C/C++ Include Paths and Symbols project property page.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">The C/C++ Projects  and Symbian Project Navigator views do not always refresh with changes in the file system.</td>
      <td style="vertical-align: top;"> If you are in doubt about the contents select the folder in question, then hit F5 to refresh the directory from the file system.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Synergy 6.3 Installations will
always crash Eclipse file navigation dialogs - The solution for this is
to un-register cmexplorer.dll then reboot your machine. Un-registering
this feature will only effect users that use Synergy integration to
Windows Explorer. This issue is known to be fixed with Synergy 6.4.</td>
      <td style="vertical-align: top;">The un-register command is:<br />
      <br />
      <font size="-1"><span class="code"
 style="font-family: courier new,courier,monospace;"> regsvr32 /u
&lt;path to dll&gt;cmexplorer.dll</span> &nbsp; <br />
      <br />
      </font>To re-register, the command is:<br />
      <br />
      <font size="-1" class="code">regsvr32 &lt;path to
dll&gt;cmexplorer.dll</font></td>
    </tr>
    <tr bgcolor="#0071ff">
      <td colspan="2" bgcolor="#FFFFCC" style="vertical-align: top;">
      <div align="center" class="style6"><a name="bug_build"></a><span
 class="style8">BUILD/IMPORTER</span></div>      </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[3804] My application fails to start the first time I try to debug it using TRK. </td>
      <td style="vertical-align: top;">Workaround: Launch the debug session again. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[3809]<b> IMPORTANT</b>: You cannot import two projects into Carbide that have the same &quot;Root Directory&quot;.</td>
      <td style="vertical-align: top;"> If a .project file already exists in this location you either need to shorten or lengthen the &quot;Root Directory&quot; or delete the other project in the same location and try to import again.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;"><p>Emulator (WINSCW) command line builds</p></td>
      <td style="vertical-align: top;"><p>If you want to build for the emulator from the command line, run the tool from the start menu shortcut: <strong>Configure environment for WINSCW command line builds</strong>. It will setup the necessary environment variables for the x86 compiler. You do not need to do this if you will only be building emulator targets  from the IDE.</p></td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Working with a workspace on one drive and a source base on another can build some items in the wrong location. </td>
      <td style="vertical-align: top;">Workaround:  keep your source base and Carbide workspace on the same drive. Because some scripts work off an implicit root (e.g. \epoc32\include\) and don't support drive specs on paths there can be outputs to unexpected locations. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">When creating/importing projects the sources and SDK must be on the same drive.</td>
      <td style="vertical-align: top;"> <p>For example, you cannot create a project on the C: drive and build with an SDK whose <span class="code">EPOCROOT</span> is <span class="code">M:\</span>.</p>
      <p>      This is due to many of the internal SDK tools using an implicit working drive to calculate paths (e.g. <span class="code">\epoc32\tools</span>).</p></td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Files that include non-ascii
character types will not compile correctly with GCCE if the file type
is not saved as UTF-8. </td>
      <td style="vertical-align: top;">The workaround is to change the
text file encoding in the global preferences at Windows &gt;
Preferences, then open the General &gt; Editors panel in the
Preferences window. Look for the Text file encoding option as shown
below.
      <p align="center"><img src="images/utf.png" width="212" height="68" alt="" /></p>      </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Build system does not detect static library dependencies</td>
    <td style="vertical-align: top;">The Symbian OS build system did not detect static library changes prior to 9.2.  They have release a patch for this <a href="http://www3.symbian.com/faq.nsf/0/E0F5C56AA68C305F8025731400051166?OpenDocument">here</a>.    </tr>
    <tr bgcolor="#0071ff">
      <td colspan="2" bgcolor="#FFFFCC" style="vertical-align: top;">
      <div align="center" class="style6"><a name="bug_debug"></a><span
 class="style8">DEBUGGER</span></div>      </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Unable to install TRK on flashed  devices</td>
      <td style="vertical-align: top;"> Workaround: Some  devices contain images that won't allow TRK to be installed, specifically the Lumiere PR 1.0 and PR 1.1 releases, especially if the C drive image was flashed. To install TRK on these devices you must format the C drive to remove the old flash image, then reflash using an image containing TRK.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[3778,4658] Some variables show &quot;Invalid format&quot; in the Variable view. </td>
      <td style="vertical-align: top;">No Workaround. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Symbian OS Data view caveats. </td>
      <td style="vertical-align: top;"><p>During crash debugger launch session, you can examine Symbian OS data (processes, threads, chunks etc) in Symbian OS Data view. But:</p>
        <p> (1) You must have Symbian kernel debugger (usually <span class="code">Kdebug.dll</span>) built in the image. </p>
      <p> (2) As getting the OS data from crash debugger is time consuming (takes more than one minute in our test), auto-refresh of the data in Symbian OS Data view is disabled for crash debugger. You need to click the &quot;Refresh&quot; button to do a manual refreshing.</p></td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[2616] If you cast a variable to another type the details pane will still show the original type</td>
      <td style="vertical-align: top;">No Workaround. </td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[2960] The thread run control icons (step over, step in, run) are sometimes disabled after stepping</td>
      <td style="vertical-align: top;"> Click on the top frame of the suspended thread in the Debug view</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">Debugging without restarting the emulator.</td>
      <td style="vertical-align: top;"> <p>If you modify any resource files resulting RSC files cannot be rebuilt, however CPP source files can. There are a couple of issues you should be aware of. </p>
        <p>1) When starting a build, the debugger releases all file handles to the debugged application. Sometimes the emulator is slow to release its own handles to files after quitting an application. If a file is still locked on a rebuild make sure the application is closed (not the emulator itself), wait a few seconds, and try again. </p>
      <p> 2) When setting breakpoints in source files that have been recompiled they do not always resolve correctly while the emulator is running. The best option is to clear the breakpoints in any modified file and set them again.</p></td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[2716] [Variable View] - Sometimes when
stepping through a loop
variables do not refresh.</td>
      <td style="vertical-align: top;">If you have refresh problems
with variables, put focus on the variables pane, then off the pane and
back onto the variable pane.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[1928] [Register View] Casting
Registers to any type does not work.</td>
      <td style="vertical-align: top;">Not currently supported.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">The value of some uninitialized
variables is shown as
"Unknown error ...."</td>
      <td style="vertical-align: top;">When
variables are in scope the proper value will be displayed.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[548] [Variable Scoping] - Multiple
variables with the same name
in subscopes are not displayed properly.</td>
      <td style="vertical-align: top;">Give variables unique names.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[971] Watchpoints cannot be set on
global variables declared in header files. </td>
      <td style="vertical-align: top;">No workaround.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[1959] Expressions cannot be disabled.</td>
      <td style="vertical-align: top;">No workaround.</td>
    </tr>
    <tr>
      <td style="vertical-align: top;">[Add Global Variables] Not all
global namespace variables are displayed or duplicate entries sometimes
appear. </td>
      <td style="vertical-align: top;">No workaround.</td>
    </tr>
  </tbody>
</table>
<h3><a name="support" id="support"></a>Technical support </h3>
<p>The following support services are available:</p>
<ul><li>Visit the <a href="http://discussion.forum.nokia.com/forum/forumdisplay.php?s=&amp;forumid=95">Forum Nokia Developer Discussion Board</a> for lively Carbide.c++ discussions </li>
  <li>Forum Nokia Wiki - visit <a href="http://wiki.forum.nokia.com/index.php/Carbide.c++">wiki.forum.nokia.com/index.php/Carbide.c++</a> for updated information, downloads and tips </li>
  <li>Customer feedback - send your comments and suggestions to <a href="mailto:feedback.carbide@nokia.com">feedback.carbide@nokia.com</a></li>
  <li>Read the <a href="http://sw.nokia.com/id/d11442a8-4eb1-4c01-97f2-fd8be139b93f/Carbide_cpp_On_Device_Debugging_v1_0_en.pdf">Carbide.c++ On-device Debugging</a> whitepaper or an introduction to on-device debugging for S60 3rd Edition devices<br />
  </li>
</ul>
<div id="footer">Copyright &copy; 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>