-
-
-
-
Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
- License: http://www.eclipse.org/legal/epl-v10.html
Carbide.c++ User Guide
-Version 2.0.3, Feb, 2009
-
|
-
- - - - Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. |
-
Carbide.c++ User Guide-Version 2.0.3, Feb, 2009 |
- |
- + + + + + +
+
|
+
+ + + + Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. |
+
Carbide.c++ User Guide+Version 2.1.0, May, 2009 |
+ |
+ \ No newline at end of file diff -r 87b78ba99140 -r b672c2dae840 core/com.nokia.carbide.cpp.doc.user/html/hints_tips.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/hints_tips.htm Wed Apr 29 15:42:22 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/hints_tips.htm Wed Apr 29 15:43:35 2009 -0500 @@ -1,112 +1,111 @@ - - - - - -
Hints and tips are sorted by these categories:
---Yes there is. In dialogs that support regular expression syntax, like the Find/Replace dialog, simply enable the Regular Expressions option, click in any text box that accepts a regular expression, then press CTRL+Space. A pop-up appears showing you the syntax available for using regular expressions. Holding the pointer over a item in the pop-up opens an additional info dialog of helpful information.
-Also, note the presence of the lightbulb icon next to the active text box. This indicates specific assistance is available for the text box by pressing CTRL+Space. Note that in non-English versions of Microsoft Windows®, the CTRL+Space key binding may be intercepted to open the input method dialog, so try using ALT+/ instead.
-
--Use the System Search feature in Carbide. Click Search > System..., enter the search data, press Search.
-
--The CDT editor supports quick opening of associated .h files. To view the .h file, select the name of the .h file in the source you are currently editing and press F3 (Open Declaration). A new editor view will appear and display the .h file.
-
--The eclipse.ini file was renamed the carbide.c++.1.x.ini file to keep the .exe and .ini files in sync.
-
--By default, the heap space set aside for Carbide is 1024MB. You can see this setting in the carbide.c++.1.x.ini file as the line "-Xmx1024m". Some system may have limited VM space available so we suggest you try lowering the default amount to "-Xmx512m" and relaunching Carbide.
-
--Carbide.c++ hides some CDT UI elements using capabilities. We do this to avoid confusion as there are several things labeled C/C++ that don't really apply to Symbian development. To show these items, you need to add the Eclipse SDK to your Carbide.c++ installation (download link: www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.2.1-200609210945/eclipse-SDK-3.2.1-win32.zip), and then enable it from the preferences (Window > Preferences > General > Capabilities > Nokia Debug).
-
--If the Help pane does not display information specific to the page content, it may be because the page in the dialog doesn't have focus. This often occurs in a wizard page when nothing has been selected on the page. The help system has not been told which help content to display in the About section of the help pane.
-NOTE The Dynamic help section usually displays the proper helpful links, just not as specific as the About section should display.
-To get the proper content to appear, close the help pane, go to the previous page in the wizard by clicking Previous. Now, click Next to advance, select a field in the page to set the focus, then press F1. The correct help content links should now appear.
-
--Project files are created in the "Root directory" chosen during bld.inf import on the Project Properties wizard page. If a project has already been created at the same project root you cannot create another project in the same location, you will need to choose another project root.
-When projects are deleted, the project files are not always deleted. If you want to delete these project files they are:
-.project
-
- .cprojectYou can delete the .settings folder which contains:
-\.settings\.carbide_build_settings
-
- \.settings\org.eclipse.cdt.core
- \.settings\com.nokia.carbide.cpp.project.core.prefs
--To put a project under CVS control, the project configuration files that reside under the project directory need to be checked into CVS. These include .cproject, .project, application.uidesign (for UI designer applications) and the .settings folder and files (.carbide_build_settings and org.eclipse.cdt.core.prefs). The workspace .metadata folder does not need to be stored in CVS. The necessary metadata will be reconstructed when you check out projects from version control.
-
--The devices.xml file contains a list of all installed SDKs. There are three things Carbide.c++ requires to successfully build a program. They include:
--
-- Perl 5.6.1 must be installed
-- One of the SDKs is set as the "default" SDK
-- The SDK must have a valid EPOCROOT setting
-In any of the above are missing or incorrect, Carbide.c++ can not build a Symbian OS program.
-
--For resources that are included after creating a project, the user should ensure that the output location is set correctly by viewing the file properties. The output location is set to "{EPOCROOT}\epoc32\include" by default, so if an alternate location is required the user can set this in the file properties.
-
--You cannot import projects that are part of a BLD.INF file seperately. Carbide projects are the equivilent of a BLD.INF file within the workspace, not an MMP file. To work with two or more MMP projects inside a BLD.INF file, simply import the BLD.INF file as a single project, then build it all or select any of its MMP files to build only that subset of the project.
-
--If the file you are trying to debug is outside the project then you should import the binary into the project you are currently trying to debug.
-
--See "Debug icon not visible on executable in C/C++ Projects view" to correct this issue. Once completed, try to create a debug launch configuration again. Click the New button in the Configuration window to create a new configuration with the correct project information.
-
--This is commonly caused when the binary parser is not set correctly in the project. To correct, open the project properties window (right-click project name in C/C++ Projects view and select Properties), expand the C/C++ Build section and click the Binary Parser tab in the C/C++ Build page. Now look for the PE Windows Parser option. If it's not checkmarked, checkmark it and click Apply. If it is already set then uncheck it and click Apply, then reapply a checkmark and click Apply. The debug icon should now appear.
-
--When using Bluetooth to connect to a device there are several things that require correction, including:
--
-- If using built-in Bluetooth under WinXP SP2, ensure the manufacturer’s device drivers are installed and active. The default Microsoft drivers do not work correctly for debugging devices using TRK. For example, if using IBM Integrated Bluetooth on your computer, make sure you have the IBM drivers for the device.
-- Ensure the COM port used by Bluetooth is not commandeered by another process or device
-
- - - - + + + + + +
Hints and tips are sorted by these categories:
+++Yes there is. In dialogs that support regular expression syntax, like the Find/Replace dialog, simply enable the Regular Expressions option, click in any text box that accepts a regular expression, then press CTRL+Space. A pop-up appears showing you the syntax available for using regular expressions. Holding the pointer over a item in the pop-up opens an additional info dialog of helpful information.
+Also, note the presence of the lightbulb icon next to the active text box. This indicates specific assistance is available for the text box by pressing CTRL+Space. Note that in non-English versions of Microsoft Windows®, the CTRL+Space key binding may be intercepted to open the input method dialog, so try using ALT+/ instead.
+
++Use the System Search feature in Carbide. Click Search > System..., enter the search data, press Search.
+
++The CDT editor supports quick opening of associated .h files. To view the .h file, select the name of the .h file in the source you are currently editing and press F3 (Open Declaration). A new editor view will appear and display the .h file.
+
++The eclipse.ini file was renamed the carbide.c++.1.x.ini file to keep the .exe and .ini files in sync.
+
++By default, the heap space set aside for Carbide is 1024MB. You can see this setting in the carbide.c++.1.x.ini file as the line "-Xmx1024m". Some system may have limited VM space available so we suggest you try lowering the default amount to "-Xmx512m" and relaunching Carbide.
+
++Carbide.c++ hides some CDT UI elements using capabilities. We do this to avoid confusion as there are several things labeled C/C++ that don't really apply to Symbian development. To show these items, you need to add the Eclipse SDK to your Carbide.c++ installation (download link: www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.2.1-200609210945/eclipse-SDK-3.2.1-win32.zip), and then enable it from the preferences (Window > Preferences > General > Capabilities > Nokia Debug).
+
++If the Help pane does not display information specific to the page content, it may be because the page in the dialog doesn't have focus. This often occurs in a wizard page when nothing has been selected on the page. The help system has not been told which help content to display in the About section of the help pane.
+NOTE The Dynamic help section usually displays the proper helpful links, just not as specific as the About section should display.
+To get the proper content to appear, close the help pane, go to the previous page in the wizard by clicking Previous. Now, click Next to advance, select a field in the page to set the focus, then press F1. The correct help content links should now appear.
+
++Project files are created in the "Root directory" chosen during bld.inf import on the Project Properties wizard page. If a project has already been created at the same project root you cannot create another project in the same location, you will need to choose another project root.
+When projects are deleted, the project files are not always deleted. If you want to delete these project files they are:
+.project
+
+ .cprojectYou can delete the .settings folder which contains:
+\.settings\.carbide_build_settings
+
+ \.settings\org.eclipse.cdt.core
+ \.settings\com.nokia.carbide.cpp.project.core.prefs
++To put a project under CVS control, the project configuration files that reside under the project directory need to be checked into CVS. These include .cproject, .project, application.uidesign (for UI designer applications) and the .settings folder and files (.carbide_build_settings and org.eclipse.cdt.core.prefs). The workspace .metadata folder does not need to be stored in CVS. The necessary metadata will be reconstructed when you check out projects from version control.
+
++The devices.xml file contains a list of all installed SDKs. There are three things Carbide.c++ requires to successfully build a program. They include:
++
+- Perl 5.6.1 must be installed
+- One of the SDKs is set as the "default" SDK
+- The SDK must have a valid EPOCROOT setting
+In any of the above are missing or incorrect, Carbide.c++ can not build a Symbian OS program.
+
++For resources that are included after creating a project, the user should ensure that the output location is set correctly by viewing the file properties. The output location is set to "{EPOCROOT}\epoc32\include" by default, so if an alternate location is required the user can set this in the file properties.
+
++You cannot import projects that are part of a BLD.INF file seperately. Carbide projects are the equivilent of a BLD.INF file within the workspace, not an MMP file. To work with two or more MMP projects inside a BLD.INF file, simply import the BLD.INF file as a single project, then build it all or select any of its MMP files to build only that subset of the project.
+
++If the file you are trying to debug is outside the project then you should import the binary into the project you are currently trying to debug.
+
++See "Debug icon not visible on executable in C/C++ Projects view" to correct this issue. Once completed, try to create a debug launch configuration again. Click the New button in the Configuration window to create a new configuration with the correct project information.
+
++This is commonly caused when the binary parser is not set correctly in the project. To correct, open the project properties window (right-click project name in C/C++ Projects view and select Properties), expand the C/C++ Build section and click the Binary Parser tab in the C/C++ Build page. Now look for the PE Windows Parser option. If it's not checkmarked, checkmark it and click Apply. If it is already set then uncheck it and click Apply, then reapply a checkmark and click Apply. The debug icon should now appear.
+
++ + + + \ No newline at end of file diff -r 87b78ba99140 -r b672c2dae840 core/com.nokia.carbide.cpp.doc.user/html/reference/olderproject_updater.html --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/olderproject_updater.html Wed Apr 29 15:42:22 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/olderproject_updater.html Wed Apr 29 15:43:35 2009 -0500 @@ -1,27 +1,28 @@ - - -When using Bluetooth to connect to a device there are several things that require correction, including:
++
+- If using built-in Bluetooth under WinXP SP2, ensure the manufacturer’s device drivers are installed and active. The default Microsoft drivers do not work correctly for debugging devices using TRK. For example, if using IBM Integrated Bluetooth on your computer, make sure you have the IBM drivers for the device.
+- Ensure the COM port used by Bluetooth is not commandeered by another process or device
+
- The Carbide.c++ File Updater window appears when you open Carbide.c++ 1.1 projects in Carbide.c++ 1.2. The example in figure 1 shows the Carbide.c++ File Updater window with an older project that needs updated. If your projects have up-to-date bld.inf and MMP files, it is recommended to delete the existing Carbide.c++ projects and re-import your projects from the bld.inf file. New bld.inf and MMP files will be created from the existing projects. The updater will update the template - projects from Carbide.c++ 1.1.
-You can also select projects in the C/C++ Projects or Symbian Project Navigator view and choose Project > Update Projects command to display the Carbide.c++ File Updater dialog.
-
Figure 1 - Carbide.c++ File Updater
-If you are opening older projects that include UI Designer components, an error message will appear similar to the one shown in figure 2. Click Ok to open the Carbide.c++ Files Updater window shown in figure 3.
-
Figure 2 - UI Designer Update Error
--
Figure 3 - Carbide.c++ Files Updater window
-Changes to be performed by the updater are shown in the Text Compare area. You can use the yellow up and down arrows to move to the next or previous change to be performed. Click cancel if you do not want the change to be made. Click Finish to accept the changes.
- - - - + + ++ The Carbide.c++ File Updater window appears when you open older Carbide.c++ projects that require updating. This most often occurs when new features are added to the project file format. The example in figure 1 shows the Carbide.c++ File Updater window with a v1.1 project that needs updating. In this case the updater updates the template + projects from Carbide.c++ 1.1 to the latest template version. Projects that are already up-to-date are not affected by the updater process. New projects automatically use the most current project format.
+If your projects have up-to-date bld.inf and MMP files, it is recommended that you delete the existing Carbide.c++ projects and simply re-import them from the bld.inf file. This ensures that the project file format is up-to-date.
+You can also select projects in the Project Explorer or Symbian Project Navigator views and choose Project > Update Projects command to display the Carbide.c++ File Updater window.
+
Figure 1 - Carbide.c++ File Updater
+If you are opening older projects that include UI Designer components, an error message will appear similar to the one shown in figure 2. Click OK to open the Carbide.c++ Files Updater window shown in figure 3.
+
Figure 2 - UI Designer Update Error
++
Figure 3 - Carbide.c++ Files Updater window
+Changes to be performed by the updater are shown in the Text Compare area. You can use the yellow up and down arrows to move to the next or previous change to be performed. Click cancel if you do not want the change to be made. Click Finish to accept the changes.
+ + + + \ No newline at end of file