--- a/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/gettingStarted/import_examples.htm Mon Apr 27 15:07:35 2009 -0500
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/gettingStarted/import_examples.htm Tue Apr 28 11:04:43 2009 -0500
@@ -1,42 +1,42 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<title>Importing the SDK example and leavescan plug-ins</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-<style type="text/css">
-<!--
-.style1 {color: #000000}
--->
-</style>
-</head>
-<body bgcolor="#FFFFFF">
-
-<h2><a name="import" id="import"></a>Importing the SDK Example </h2>
-<p>You can import any of the plug-ins in Carbide.c++ and examine the source code. However, the SDK provides a plug-in you can import and examine as an example of Carbide.c++ API usage.</p>
-<ul>
-<li>The Examples plugin (<span class="code">com.nokia.carbide.cpp.sdk.examples</span>) is part of the Carbide.c++ Development Kit (CDK). It
-provides examples of installing items in the Carbide menu, creating new projects programatically, and accessing
-project and Symbian build information. See <a href="#showExamplesMenu">below</a> for instructions on how to enable the example menu
-commands inside carbide. </li>
-</ul>
-<p>You can import this and other plugins into your workspace and view/debug all the source to get a better understanding of the
-Carbide.c++ APIs in a functional plugin. Plesae see the page on <a href="env_setup.htm">setting up your development environment</a> for information on how to import a source project. </p>
-<p class="note"><strong>Note</strong> that the example plugins were built with JRE1.5, you will likely receive errors with JRE1.6. Select Window > Preferences > Java > Installed JREs to add currently installed JREs and select the JRE to use.</p>
-<p class="note">When you are done importing you should have new plugins in your workspace and be able to view the
- sources for both plugin projects. Your workspace should look something like this:<br />
- <br />
- <img src="../img/dev_ide_complete.JPG" width="1024" height="757"/></p>
-<h3>Adding a Carbide menu</h3>
- <p>The menu items contributed by the Examples plugin are not visible by default in the Carbide.c++ program. To show the missing menu, follow these steps:</p>
-<ol>
- <li>In Carbide.c++ (not in your Eclipse Java development SDK) choose <b>Window > Customize Perspective...</b></li>
- <li>Select the <b>Commands</b> tab</li>
- <li>Select the checkbox for <b>Carbide.c++ Examples Action Set</b><br/>
- <br/>
- <img src="../img/show_examples_menu.jpg" width="711" height="501"/></li>
-</ol>
- <p>Click OK, and you should now see the Carbide menu in the menu bar. You can now examine the source code and run it in the debugger. See <a href="launchconfig.htm">debugging a debugging a Carbide.c++ plug-in</a> for information on setting up a plug-in debug session. </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></div>
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<title>Importing the SDK example and leavescan plug-ins</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+<style type="text/css">
+<!--
+.style1 {color: #000000}
+-->
+</style>
+</head>
+<body bgcolor="#FFFFFF">
+
+<h2><a name="import" id="import"></a>Importing the SDK Example </h2>
+<p>You can import any of the plug-ins in Carbide.c++ and examine the source code. However, the SDK provides a plug-in you can import and examine as an example of Carbide.c++ API usage.</p>
+<ul>
+<li>The Examples plugin (<span class="code">com.nokia.carbide.cpp.sdk.examples</span>) is part of the Carbide.c++ Development Kit (CDK). It
+provides examples of installing items in the Carbide menu, creating new projects programatically, and accessing
+project and Symbian build information. See <a href="#showExamplesMenu">below</a> for instructions on how to enable the example menu
+commands inside Carbide. </li>
+</ul>
+<p>You can import this and other plugins into your workspace and view/debug all the source to get a better understanding of the
+Carbide.c++ APIs in a functional plugin. Plesae see the page on <a href="env_setup.htm">setting up your development environment</a> for information on how to import a source project. </p>
+<p class="note"><strong>Note</strong> that the example plugins were built with JRE1.5, you will likely receive errors with JRE1.6. Select Window > Preferences > Java > Installed JREs to add currently installed JREs and select the JRE to use.</p>
+When you are done importing you should have new plugins in your workspace and be able to view the
+ sources for both plugin projects. Your workspace should look something like this:<br />
+<br />
+<img src="../img/dev_ide_complete.JPG" width="1024" height="757"/>
+<h3>Adding a Carbide menu</h3>
+ <p>The menu items contributed by the Examples plugin are not visible by default in the Carbide.c++ program. To show the missing menu, follow these steps:</p>
+<ol>
+ <li>In Carbide.c++ (not in your Eclipse Java development SDK) choose <b>Window > Customize Perspective...</b></li>
+ <li>Select the <b>Commands</b> tab</li>
+ <li>Select the checkbox for <b>Carbide.c++ Examples Action Set</b><br/>
+ <br/>
+ <img src="../img/show_examples_menu.jpg" width="711" height="501"/></li>
+</ol>
+ <p>Click OK, and you should now see the Carbide menu in the menu bar. You can now examine the source code and run it in the debugger. See <a href="launchconfig.htm">debugging a debugging a Carbide.c++ plug-in</a> for information on setting up a plug-in debug session. </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/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/api_Change_Notes.htm Mon Apr 27 15:07:35 2009 -0500
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/api_Change_Notes.htm Tue Apr 28 11:04:43 2009 -0500
@@ -56,10 +56,10 @@
<p>Since Carbide 2.0.4</p>
<ul>
- <li>Added setter methods for SBSv1 (abld) arguments in <em> com.nokia.carbide.cdt.builder.project.IBuildArgumentsInfo</em>.</li>
+ <li>Added <em> com.nokia.carbide.cdt.builder.project.ICarbideBuildConfiguration#getBuildArgumentsInfoCopy( )</em>.</li>
</ul>
<ul>
- <li>Added <em> com.nokia.carbide.cdt.builder.project.ICarbideBuildConfiguration#setBuildArgumentsInfo(IBuildArgumentsInfo bldArgInfo)</em>.</li>
+ <li>Added <em> com.nokia.carbide.cdt.builder.project.ICarbideBuildConfiguration#setBuildArgumentsInfo(BuildArgumentsInfo bldArgInfo)</em>.</li>
</ul>
<h3>Deprecated APIs</h3>
@@ -92,11 +92,10 @@
<li>None </li>
</ul>
-<p>Since Carbide 2.1</p>
+<p>Since Carbide 2.0.4</p>
<ul>
- <li><i>com.nokia.carbide.cdt.builder.builder.CarbideCPPBuilder.generateAbldMakefileIfNecessary(ICarbideBuildConfiguration
-config, CarbideCommandLauncher launcher, IPath componentPath, boolean isTest)
- </i></li>
+ <li><i>com.nokia.carbide.cdt.builder.project.IBuildArgumentsInfo</i></li>
+ <li><i>com.nokia.carbide.cdt.builder.project.ICarbideBuildConfiguration#getBuildArgumentsInfo( )</i></li>
</ul>
<h3>Removed APIs</h3>
@@ -126,31 +125,3 @@
<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>
</div></body>
</html>
-
-<h3>Removed APIs</h3>
-<p>The following Carbide APIs have been removed and are no longer available to plug-ins.</p>
-<p>Since Carbide 1.2.0</p>
-<ul>
- <li><i>N/A</i></li>
-</ul>
-<p>Since Carbide 1.2.1</p>
-<ul>
- <li><i>N/A</i></li>
-</ul>
-<p>Since Carbide 1.2.2</p>
-<ul>
- <li><i>Some methods that were not intended to be made public were removed from the following classes and interfaces: </i></li>
- <ul>
- <li><i>com.nokia.carbide.cdt.builder.builder.CarbideCPPBuilder</i></li>
- <li><i>com.nokia.carbide.cdt.builder.ICarbideBuildManager</i></li>
- <li><i>com.nokia.carbide.cdt.builder.project.ICarbideProjectInfo</i></li>
- <li><i>com.nokia.carbide.cdt.builder.project.ICarbideBuildConfiguration</i></li>
- </ul>
-</ul>
-<p>Since Carbide 2.0</p>
-<ul>
- <li>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>
-</div></body>
-</html>
--- a/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/extension-points/com_nokia_carbide_templatewizard_wizardTemplate.html Mon Apr 27 15:07:35 2009 -0500
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/extension-points/com_nokia_carbide_templatewizard_wizardTemplate.html Tue Apr 28 11:04:43 2009 -0500
@@ -1,62 +1,65 @@
-<!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>Wizard Template</title>
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</HEAD>
-<BODY>
-<H1 style="text-align:center">Wizard Template</H1>
-<p></p>
-<h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>com.nokia.carbide.templatewizard.wizardTemplate<p></p>
-<h6 class="CaptionFigColumn SchemaHeader">Since: </h6>Carbide.c++ 1.2
-<p></p>
-
-<h6 class="CaptionFigColumn SchemaHeader">Description: </h6>The wizard template extension point registers a template with the Carbide.c++ template wizard. Templates may create projects or classes.
-
-See the the documentation under Tasks > Creating Wizard Templates for more information.<p></p>
-<h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6>
-<p></p>
-<p class="code SchemaDtd"><!ELEMENT <a name="e.extension">extension</a> (<a href="#e.template">template</a>+)></p>
-<p class="code SchemaDtd"><!ATTLIST extension</p>
-<p class="code SchemaDtdAttlist">point CDATA #REQUIRED<p class="code SchemaDtdAttlist">id CDATA #IMPLIED<p class="code SchemaDtdAttlist">name CDATA #IMPLIED></p>
-<p></p>
-<ul class="ConfigMarkupAttlistDesc">
-</ul>
-<br><p class="code SchemaDtd"><!ELEMENT <a name="e.template">template</a> EMPTY></p>
-<p class="code SchemaDtd"><!ATTLIST template</p>
-<p class="code SchemaDtdAttlist">templateId CDATA #REQUIRED<p class="code SchemaDtdAttlist">location CDATA #REQUIRED<p class="code SchemaDtdAttlist">wizardId CDATA #REQUIRED<p class="code SchemaDtdAttlist">groupLabel CDATA #REQUIRED<p class="code SchemaDtdAttlist">filterArguments CDATA #IMPLIED<p class="code SchemaDtdAttlist">image CDATA #IMPLIED<p class="code SchemaDtdAttlist">extraPagesProvider CDATA #IMPLIED></p>
-<p></p>
-<p class="ConfigMarkupElementDesc">
-The template element registers a single template with the template wizard.</p>
-<br>
-<ul class="ConfigMarkupAttlistDesc">
-<li><b>templateId</b> - The unique id for this template</li>
-<li><b>location</b> - The plugin-relative path to the template xml file</li>
-<li><b>wizardId</b> - The id of the wizard in which this template is used</li>
-<li><b>groupLabel</b> - The group label under which this template will appear in the template choice page of the appropriate template wizard</li>
-<li><b>filterArguments</b> - The optional wizard-specific data available for the IFilter implementing a filter checkbox, optionally shown in some template wizards</li>
-<li><b>image</b> - The optional plugin-relative location of a 16x16 pixel image file to use when showing this template in the choose template wizard page</li>
-<li><b>extraPagesProvider</b> - An optional provider of extra wizard pages</li>
-</ul>
-<br><h6 class="CaptionFigColumn SchemaHeader">Examples: </h6><pre class="Example"><span class="code SchemaTag">
-</span><span class="code"><extension point="com.nokia.carbide.templatewizard.wizardTemplate">
- <template
- templateId="com.nokia.cdt.templates.s60.controlapplication"
- location="templates/projecttemplates/S60-ControlApplication/template.xml"
- wizardId="com.nokia.carbide.cpp.project.ui.wizards.NewSymbianOSCppProjectWizard"
- groupLabel="S60"
- filterArguments="S60:1.2;2.0-2.9"
- image="icons/icon_S60.png"
- />
-</extension>
-</span></pre>
-<p></p>
-
-<h6 class="CaptionFigColumn SchemaHeader">Supplied Implementation: </h6>This extension point registers an XML template. Implementation is not required.
-<p></p>
-
-<br>
-<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">
+<title>Wizard Template</title>
+<style type="text/css">@import url("PLUGINS_ROOT/org.eclipse.cdt.doc.isv/book.css");</style>
+<style type="text/css">@import url("PLUGINS_ROOT/org.eclipse.cdt.doc.isv/schema.css");</style>
+</HEAD>
+<BODY>
+<H1 style="text-align:center">Wizard Template</H1>
+<p></p>
+<h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>com.nokia.carbide.templatewizard.wizardTemplate<p></p>
+<h6 class="CaptionFigColumn SchemaHeader">Since: </h6>Carbide.c++ 1.2
+<p></p>
+
+<h6 class="CaptionFigColumn SchemaHeader">Description: </h6>The wizard template extension point registers a template with the Carbide.c++ template wizard. Templates may create projects or classes.
+
+See the the documentation under Tasks > Creating Wizard Templates for more information.<p></p>
+<h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6>
+<p></p>
+<p class="code SchemaDtd"><!ELEMENT <a name="e.extension">extension</a> (<a href="#e.template">template</a>+)></p>
+<p class="code SchemaDtd"><!ATTLIST extension</p>
+<p class="code SchemaDtdAttlist">point CDATA #REQUIRED<p class="code SchemaDtdAttlist">id CDATA #IMPLIED<p class="code SchemaDtdAttlist">name CDATA #IMPLIED></p>
+<p></p>
+<ul class="ConfigMarkupAttlistDesc">
+</ul>
+<br><p class="code SchemaDtd"><!ELEMENT <a name="e.template">template</a> EMPTY></p>
+<p class="code SchemaDtd"><!ATTLIST template</p>
+<p class="code SchemaDtdAttlist">templateId CDATA #REQUIRED<p class="code SchemaDtdAttlist">location CDATA #REQUIRED<p class="code SchemaDtdAttlist">wizardId CDATA #REQUIRED<p class="code SchemaDtdAttlist">groupLabel CDATA #REQUIRED<p class="code SchemaDtdAttlist">filterArguments CDATA #IMPLIED<p class="code SchemaDtdAttlist">image CDATA #IMPLIED<p class="code SchemaDtdAttlist">extraPagesProvider CDATA #IMPLIED></p>
+<p></p>
+<p class="ConfigMarkupElementDesc">
+The template element registers a single template with the template wizard.</p>
+<br>
+<ul class="ConfigMarkupAttlistDesc">
+<li><b>templateId</b> - The unique id for this template</li>
+<li><b>location</b> - The plugin-relative path to the template xml file</li>
+<li><b>wizardId</b> - The id of the wizard in which this template is used</li>
+<li><b>groupLabel</b> - The group label under which this template will appear in the template choice page of the appropriate template wizard</li>
+<li><b>filterArguments</b> - The optional wizard-specific data available for the IFilter implementing a filter checkbox, optionally shown in some template wizards</li>
+<li><b>image</b> - The optional plugin-relative location of a 16x16 pixel image file to use when showing this template in the choose template wizard page</li>
+<li><b>extraPagesProvider</b> - An optional provider of extra wizard pages</li>
+</ul>
+<br><h6 class="CaptionFigColumn SchemaHeader">Examples: </h6><pre class="Example"><span class="code SchemaTag">
+<extension point=</span><span class="code SchemaCstring">"com.nokia.carbide.templatewizard.wizardTemplate"</span><span class="code SchemaTag">>
+ <template
+ templateId=</span><span class="code SchemaCstring">"com.nokia.cdt.templates.s60.controlapplication"</span><span class="code SchemaTag">
+ location=</span><span class="code SchemaCstring">"templates/projecttemplates/S60-ControlApplication/template.xml"</span><span class="code SchemaTag">
+ wizardId=</span><span class="code SchemaCstring">"com.nokia.carbide.cpp.project.ui.wizards.NewSymbianOSCppProjectWizard"</span><span class="code SchemaTag">
+ groupLabel=</span><span class="code SchemaCstring">"S60"</span><span class="code SchemaTag">
+ filterArguments=</span><span class="code SchemaCstring">"S60:1.2;2.0-2.9"</span><span class="code SchemaTag">
+ image=</span><span class="code SchemaCstring">"icons/icon_S60.png"</span><span class="code SchemaTag">
+ />
+</extension>
+</span></pre>
+<p></p>
+
+<h6 class="CaptionFigColumn SchemaHeader">Supplied Implementation: </h6>This extension point registers an XML template. Implementation is not required.
+<p></p>
+
+<br>
+<p class="note SchemaCopyright">
+(C) Copyright 2007 Nokia Corporation.
+
+</p>
+</BODY>
+</HTML>
--- a/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/extension-points/templatewizard_wizardTemplate.html Mon Apr 27 15:07:35 2009 -0500
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/extension-points/templatewizard_wizardTemplate.html Tue Apr 28 11:04:43 2009 -0500
@@ -1,66 +1,65 @@
-<!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>Wizard Template</title>
-<!-- <style>@import url("PLUGINS_ROOT/org.eclipse.cdt.doc.isv/book.css");</style>
-<style>@import url("PLUGINS_ROOT/org.eclipse.cdt.doc.isv/schema.css");</style> -->
-<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
-</HEAD>
-<BODY>
-<H1>Wizard Template</H1>
-<p></p>
-<h5 class=CaptionFigColumn id=header>Identifier:</h5>
-<p class="code">com.nokia.carbide.templatewizard.wizardTemplate</p>
-<h5 class=CaptionFigColumn id=header>Since: </h5>
-Carbide.c++ 1.2
-
-<h5 class=CaptionFigColumn id=header>Description: </h5>
-The wizard template extension point registers a template with the Carbide.c++ template wizard. Templates may create projects or classes.
-
-Refer to the documentation under Tasks > Creating Wizard Templates for more information.
-<h5 class=CaptionFigColumn id=header>Configuration Markup:</h5>
-<p class=code id=dtd><!ELEMENT extension (template+)></p>
-<p class=code id=dtd><!ATTLIST extension</p>
-<p class=code id=dtdAttlist>point CDATA #REQUIRED<p class=code id=dtdAttlist>id CDATA #IMPLIED<p class=code id=dtdAttlist>name CDATA #IMPLIED></p>
-<br>
-<p class=code id=dtd><!ELEMENT template EMPTY></p>
-<p class=code id=dtd><!ATTLIST template</p>
-<p class=code id=dtdAttlist>templateId CDATA #REQUIRED<p class=code id=dtdAttlist>location CDATA #REQUIRED<p class=code id=dtdAttlist>wizardId CDATA #REQUIRED<p class=code id=dtdAttlist>groupLabel CDATA #REQUIRED<p class=code id=dtdAttlist>filterArguments CDATA #IMPLIED<p class=code id=dtdAttlist>image CDATA #IMPLIED<p class=code id=dtdAttlist>extraPagesProvider CDATA #IMPLIED></p>
-<p></p>
-<p class=ConfigMarkup id=elementDesc>
-The template element registers a single template with the template wizard.</p>
-<br>
-<ul class=ConfigMarkup id=attlistDesc>
-<li><b>templateId</b> - The unique id for this template</li>
-<li><b>location</b> - The plugin-relative path to the template xml file</li>
-<li><b>wizardId</b> - The id of the wizard in which this template is used</li>
-<li><b>groupLabel</b> - The group label under which this template will appear in the template choice page of the appropriate template wizard</li>
-<li><b>filterArguments</b> - The optional wizard-specific data available for the IFilter implementing a filter checkbox, optionally shown in some template wizards</li>
-<li><b>image</b> - The optional plugin-relative location of a 16x16 pixel image file to use when showing this template in the choose template wizard page</li>
-<li><b>extraPagesProvider</b> - An optional provider of extra wizard pages</li>
-</ul>
-<br>
-<h5 class=CaptionFigColumn id=header>Examples:</h5>
-<pre><p class=code id=tag><extension point="com.nokia.carbide.templatewizard.wizardTemplate"><p class=code id=tag><!-- Register application template for Yadda Yadda company -->
-<template
- templateId="com.yadda.templates.application"<br> location="templates/projecttemplates/Yadda-Application/template.xml"
- wizardId="com.yaddayadda.wizards.NewYaddaProjectWizard"
- groupLabel="YaddaYadda"
- filterArguments="Yadda:1.2;2.0-4.0"
- image="icons/icon_yadda_yadda.png"
- />
-<p class=code id=tag></extension></p></pre>
-<h5 class=CaptionFigColumn id=header>API Information: </h5>
-No API implementation is required to provide a basic template. Templates requiring custom processing in code may implement <code class="code">com.nokia.carbide.templatewizard.process.IProcess</code>
-<p></p>
-
-<h5 class=CaptionFigColumn id=header>Supplied Implementation:</h5>
-<p>This extension point registers an XML template. Implementation is not required.</p>
-<h5>Related Information</h5>
-<p><a href="../../tasks/CreatingWizardTemplates.htm">Creating Wizard Templates</a><br>
-</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>
-<p>
-
-</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">
+<title>Wizard Template</title>
+<!-- <style>@import url("PLUGINS_ROOT/org.eclipse.cdt.doc.isv/book.css");</style>
+<style>@import url("PLUGINS_ROOT/org.eclipse.cdt.doc.isv/schema.css");</style> -->
+<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
+</HEAD>
+<BODY>
+<H1>Wizard Template</H1>
+<p></p>
+<h5 class=CaptionFigColumn id=header>Identifier:</h5>
+<p>com.nokia.carbide.templatewizard.wizardTemplate</p>
+<h5 class=CaptionFigColumn id=header>Since: </h5>
+Carbide.c++ 1.2
+
+<h5 class=CaptionFigColumn id=header>Description: </h5>
+The wizard template extension point registers a template with the Carbide.c++ template wizard. Templates may create projects or classes.
+
+Refer to the documentation under Tasks > Creating Wizard Templates for more information.
+<h5 class=CaptionFigColumn id=header>Configuration Markup:</h5>
+<p class=code id=dtd><!ELEMENT extension (template+)></p>
+<p class=code id=dtd><!ATTLIST extension</p>
+<p class=code id=dtdAttlist>point CDATA #REQUIRED<p class=code id=dtdAttlist>id CDATA #IMPLIED<p class=code id=dtdAttlist>name CDATA #IMPLIED></p>
+<br>
+<p class=code id=dtd><!ELEMENT template EMPTY></p>
+<p class=code id=dtd><!ATTLIST template</p>
+<p class=code id=dtdAttlist>templateId CDATA #REQUIRED<p class=code id=dtdAttlist>location CDATA #REQUIRED<p class=code id=dtdAttlist>wizardId CDATA #REQUIRED<p class=code id=dtdAttlist>groupLabel CDATA #REQUIRED<p class=code id=dtdAttlist>filterArguments CDATA #IMPLIED<p class=code id=dtdAttlist>image CDATA #IMPLIED<p class=code id=dtdAttlist>extraPagesProvider CDATA #IMPLIED></p>
+<p></p>
+<p class=ConfigMarkup id=elementDesc>
+The template element registers a single template with the template wizard.</p>
+<br>
+<ul class=ConfigMarkup id=attlistDesc>
+<li><b>templateId</b> - The unique id for this template</li>
+<li><b>location</b> - The plugin-relative path to the template xml file</li>
+<li><b>wizardId</b> - The id of the wizard in which this template is used</li>
+<li><b>groupLabel</b> - The group label under which this template will appear in the template choice page of the appropriate template wizard</li>
+<li><b>filterArguments</b> - The optional wizard-specific data available for the IFilter implementing a filter checkbox, optionally shown in some template wizards</li>
+<li><b>image</b> - The optional plugin-relative location of a 16x16 pixel image file to use when showing this template in the choose template wizard page</li>
+<li><b>extraPagesProvider</b> - An optional provider of extra wizard pages</li>
+</ul>
+<br>
+<h5 class=CaptionFigColumn id=header>Examples:</h5>
+<pre><p class=code id=tag><extension point="com.nokia.carbide.templatewizard.wizardTemplate"><p class=code id=tag><template
+ templateId="com.nokia.cdt.templates.s60.controlapplication"<br> location="templates/projecttemplates/S60-ControlApplication/template.xml"
+ wizardId="com.nokia.carbide.cpp.project.ui.wizards.NewSymbianOSCppProjectWizard"
+ groupLabel="S60"
+ filterArguments="S60:1.2;2.0-2.9"
+ image="icons/icon_S60.png"
+ />
+<p class=code id=tag></extension></p></pre>
+<h5 class=CaptionFigColumn id=header>API Information: </h5>
+No API implementation is required to provide a basic template. Templates requiring custom processing in code may implement <code class="code">com.nokia.carbide.templatewizard.process.IProcess</code>
+<p></p>
+
+<h5 class=CaptionFigColumn id=header>Supplied Implementation:</h5>
+<p>This extension point registers an XML template. Implementation is not required.</p>
+<h5>Related Information</h5>
+<p><a href="../../tasks/CreatingWizardTemplates.htm">Creating Wizard Templates</a><br>
+</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>
+<p>
+
+</BODY>
+</HTML>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/tasks/sdkMainTopic.htm Tue Apr 28 11:04:43 2009 -0500
@@ -0,0 +1,35 @@
+<!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 Plug-ins Overview</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+
+<body>
+<h2>Carbide Plug-ins Overview</h2>
+
+<p>Creating a Carbide tool plug-in requires some knowledge and understanding of the Eclipse plug-in environment. There are two methods of creating Carbibe plug-ins, including:</p>
+<ul>
+ <li><a href="../gettingStarted/import_examples.htm">Importing</a> an existing Carbide tool plug-in and modifying it </li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.platform.doc.isv/guide/firstplugin.htm">Creating</a> a new Eclipse plug-in and adding Carbide API calls</li>
+</ul>
+<p>Each has its advantages and disadvantages. Importing an existing Carbide plug-in provides a working plug-in that you can modify and add to easily to get something up and running quickly. However, the plug-in probably doesn't include the API interaction you want to implement and includes a lot of resources you probably don't need or want. Creating a new plug-in from scratch has the advantage of giving you a clean slate upon which to add your own code. It doesn't include any basic Carbide support like menu items and preference panel calls that nearly every tool requires, forcing you to add them on your own.</p>
+<p>Which one you choose depends on the type of plug-in you want to develop and how much support you need to get up and running. In either case, both methods will require access to Carbide projects to allow them to interact with the active project.</p>
+<h2>Accessing Carbide Project Information</h2>
+<p>The following pages describe how to access specific Carbide project information for use in your own tool plug-ins.</p>
+<ul>
+ <li><a href="sdk_getprojinfo.htm">Getting Carbide Project Information</a></li>
+ <li><a href="sdk_getinfmmpinfo.htm">Retrieving INF and MMP Project Information </a></li>
+</ul>
+<h4>Related information</h4>
+<ul>
+ <li><a href="PLUGINS_ROOT/org.eclipse.platform.doc.isv/guide/firstplugin.htm">Simple Plug-in Example</a> (Platform Plug-in Developer Guide)</li>
+ <li><a href="PLUGINS_ROOT/com.nokia.carbide.cpp.doc.user/html/tasks/carbide_tools.htm">Creating Carbide Plug-ins</a></li>
+ <li><a href="PLUGINS_ROOT/org.eclipse.pde.doc.user/guide/intro/pde_overview.htm">Plug-in Development Environment Guide</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/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/tasks/sdk_getprojinfo.htm Mon Apr 27 15:07:35 2009 -0500
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/tasks/sdk_getprojinfo.htm Tue Apr 28 11:04:43 2009 -0500
@@ -1,69 +1,69 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
-<title>Getting Carbide Project Information</title>
-<link rel="StyleSheet" href="../../book.css" type="text/css"/>
-</head>
-<body bgcolor="#FFFFFF">
-
-<h2>Getting Carbide Project Information</h2>
-<p>The following example code fragment demonstrates the use of Carbide.c++ APIs to access Carbide project information.</p>
-<p class="note"><strong>NOTE</strong> There are two perspective IDs that may be useful when using the Carbide APIs. The perspective ID for the Carbide.c++ perspective is <strong>com.nokia.carbide.cpp.CarbideCppPerspective</strong> and for the Debug view it is <strong>org.eclipse.debug.ui.DebugPerspective</strong>.</p>
-<p>Retrieving Carbide.c++ project information starts with knowing your org.eclipse.core.resources.<STRONG>IProject</STRONG> resource and retrieving the com.nokia.carbide.cdt.builder.<STRONG>ICarbideBuildManager</STRONG> instance:</p>
-<p class="listing">ICarbideBuildManager buildMgr = ICarbideBuilderPlugin.getBuildManager();</p>
-<p>Now with your IProject resource you can grab the actual Carbide project in com.nokia.carbide.cdt.builder.<STRONG>ICarbideProjectInfo</STRONG>:</p>
-<p class="listing">// Assumes IProject (project) is known.<br>
- ICarbideProjectInfo cpi = null;<br>
- if (buildMgr.isCarbideProject(project)){<br>
- // check to make sure this is a Carbide project<br>
- cpi = buildMgr.getProjectInfo(project);<br>
-}</p>
-<p>Once you get the ICarbideProjectInfo object you can access all the project data, such as environment variables and SIS builder information via the com.nokia.carbide.cdt.builder.<STRONG>ICarbideBuildConfiguration</STRONG> interface. You can retrieve either the default configuration or the full list:</p>
-<p class="listing">// Get the default build configuration<br>
- ICarbideBuildConfiguration defaultConfig = cpi.getDefaultConfiguration();<br>
-// Get all configurations for this project.<br>
-List<ICarbideBuildConfiguration> configList = cpi.getBuildConfigurations();</p>
-<p>It is important to note that the data retrieved by the ICarbideBuildConfiguration object is what you see in the project properties pages under the Carbide.c++ group. This is separate from the data in the INF and MMP files. </p>
-<h3>Retrieving INF/MMP Project Information</h3>
-<p>All Carbide build stages, with the exception of the post-link SIS Builder stage get their data from INF and MMP files. So naturally Carbide needs a way to retrieve and store this data for doing things like setting up the source indexer and displaying the visual INF and MMP editors. The com.nokia.carbide.cdt.builder.<STRONG>EpocEngineHelper</STRONG> class is a good first stop to retrieve this information. For example, if you want to get all the source files in the first MMP file:</p>
-
-<PRE>// ...assumes ICarbideProjectInformation (cpi) is known.
-List<IPath> mmpPaths = EpocEngineHelper.getMMPFilesForProject(cpi);
-// array length check omitted for brevity....
-List<IPath> srcFilesTest = EpocEngineHelper.getSourceFilesForConfiguration(defultConfig, mmpPaths.get(0));</PRE>
-<h3>SDK Management</h3>
-<p>Each SDK entry in devices.xml is analogous to a com.nokia.carbide.cpp.sdk.core.<STRONG>ISymbianSDK</STRONG> object. If you want to get the entire list of ISymbianSDK objects (same list and properties from the SDK Preferences page) you simply invoke:</p>
-
-<PRE>ISDKManager sdkMgr = SDKCorePlugin.getSDKManager();
-List<ISymbianSDK> sdkList = sdkMgr.getSDKList();</PRE>
-
-<p>Now you can iterate the list and get whatever information you want out of the installed SDKs. For example, using Java 5 iterators we can get the EPOCROOT values of all the SDKs:</p>
-
-<PRE>for (ISymbianSDK currSDK : sdkList){
- String epocRootStr = currSDK.getEPOCROOT();
-}</PRE>
-
-<h3>Reading MMP Statements with the EpocEngine and IMMPData</h3>
-<p>This topic demonstrates how you can read the MMP data for any build configuration (ICarbideBuildConfiguration). The main interface for retrieving MMP data is <strong>com.nokia.carbide.cpp.epoc.engine.model.mmp.IMMPData</strong>. Once you get access to this interface you can learn anything you want about a particular MMP file.</p>
-<p><strong>Prerequisite:</strong> All MMP and bld.inf parsing requires a dependency to the plugin <strong>com.nokia.carbide.cpp.epoc.engine</strong>.</p>
-<p>Typically most keywords of interest are either single string settings (<span class="code">TARGETTYPE</span>, <span class="code">TARGET</span>, <span class="code">EPOCSTACKSIZE</span>) or list of settings (<span class="code">MACRO</span>, <span class="code">CAPABILITY</span>, <span class="code">LANG</span>). Other types can be directly retrieved from IMMPData routines. Check the API documentation for specifics.</p>
-<p>The example provided simply iterates through all the MMP files of a particular build configuration and grabs a list value and single item setting. You'll need to get the particular MMP file you are interested in. Play around with the IMMPData object in the run method and you can quickly get the idea.</p>
-<PRE class="listing">// Assumes buildConfig (ICarbideBuildConfiguration) is known
-for (IPath mmpPath : EpocEngineHelper.getMMPFilesForBuildConfiguration(buildConfig)) {
- Object data = EpocEnginePlugin.runWithMMPData(mmpPath, new
- DefaultMMPViewConfiguration(buildConfig.getCarbideProject().getProject(),
- buildConfig, new AcceptedNodesViewFilter()), new MMPDataRunnableAdapter() {
- public Object run(IMMPData mmpData) {
- // Example, getting a keyword as a list of strings
- List macros = mmpData.getListArgumentSettings().get(EMMPStatement.MACRO);
- // The real return value, getting a single argument setting
- return mmpData.getSingleArgumentSettings().get(EMMPStatement.TARGETTYPE);
- }
- });
-// Make sure to test for and cast to proper Object type!
-String mmpStatement = (String)data; // Now we should have the TARGETTYPE
-}</PRE>
-<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></div>
-</body>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<title>Getting Carbide Project Information</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+
+<h2>Getting Carbide Project Information</h2>
+<p>The following example code fragments demonstrate the use of Carbide.c++ APIs to access Carbide project information.</p>
+<p class="note"><strong>NOTE</strong> There are two perspective IDs that may be useful when using the Carbide APIs. The perspective ID for the Carbide.c++ perspective is com.nokia.carbide.cpp.CarbideCppPerspective and for the Debug view it is org.eclipse.debug.ui.DebugPerspective.</p>
+<p>Retrieving Carbide.c++ project information starts with knowing your org.eclipse.core.resources.<STRONG>IProject</STRONG> resource and retrieving the com.nokia.carbide.cdt.builder.<STRONG>ICarbideBuildManager</STRONG> instance:</p>
+<p class="listing">ICarbideBuildManager buildMgr = ICarbideBuilderPlugin.getBuildManager();</p>
+<p>Now with your IProject resource you can grab the actual Carbide project in com.nokia.carbide.cdt.builder.<STRONG>ICarbideProjectInfo</STRONG>:</p>
+<p class="listing">// Assumes IProject (project) is known.<br>
+ ICarbideProjectInfo cpi = null;<br>
+ if (buildMgr.isCarbideProject(project)){<br>
+ // check to make sure this is a Carbide project<br>
+ cpi = buildMgr.getProjectInfo(project);<br>
+}</p>
+<p>Once you get the ICarbideProjectInfo object you can access all the project data, such as environment variables and SIS builder information via the com.nokia.carbide.cdt.builder.<STRONG>ICarbideBuildConfiguration</STRONG> interface. You can retrieve either the default configuration or the full list:</p>
+<p class="listing">// Get the default build configuration<br>
+ ICarbideBuildConfiguration defaultConfig = cpi.getDefaultConfiguration();<br>
+// Get all configurations for this project.<br>
+List<ICarbideBuildConfiguration> configList = cpi.getBuildConfigurations();</p>
+<p>It is important to note that the data retrieved by the ICarbideBuildConfiguration object is what you see in the project properties pages under the Carbide.c++ group. This is separate from the data in the INF and MMP files. </p>
+<h3>Retrieving INF/MMP Project Information</h3>
+<p>All Carbide build stages, with the exception of the post-link SIS Builder stage get their data from INF and MMP files. So naturally Carbide needs a way to retrieve and store this data for doing things like setting up the source indexer and displaying the visual INF and MMP editors. The com.nokia.carbide.cdt.builder.<STRONG>EpocEngineHelper</STRONG> class is a good first stop to retrieve this information. For example, if you want to get all the source files in the first MMP file:</p>
+
+<PRE>// ...assumes ICarbideProjectInformation (cpi) is known.
+List<IPath> mmpPaths = EpocEngineHelper.getMMPFilesForProject(cpi);
+// array length check omitted for brevity....
+List<IPath> srcFilesTest = EpocEngineHelper.getSourceFilesForConfiguration(defultConfig, mmpPaths.get(0));</PRE>
+<h3>SDK Management</h3>
+<p>Each SDK entry in devices.xml is analogous to a com.nokia.carbide.cpp.sdk.core.<STRONG>ISymbianSDK</STRONG> object. If you want to get the entire list of ISymbianSDK objects (same list and properties from the SDK Preferences page) you simply invoke:</p>
+
+<PRE>ISDKManager sdkMgr = SDKCorePlugin.getSDKManager();
+List<ISymbianSDK> sdkList = sdkMgr.getSDKList();</PRE>
+
+<p>Now you can iterate the list and get whatever information you want out of the installed SDKs. For example, using Java 5 iterators we can get the EPOCROOT values of all the SDKs:</p>
+
+<PRE>for (ISymbianSDK currSDK : sdkList){
+ String epocRootStr = currSDK.getEPOCROOT();
+}</PRE>
+
+<h3>Reading MMP Statements with the EpocEngine and IMMPData</h3>
+<p>This topic demonstrates how you can read the MMP data for any build configuration (ICarbideBuildConfiguration). The main interface for retrieving MMP data is <strong>com.nokia.carbide.cpp.epoc.engine.model.mmp.IMMPData</strong>. Once you get access to this interface you can learn anything you want about a particular MMP file.</p>
+<p><strong>Prerequisite:</strong> All MMP and bld.inf parsing requires a dependency to the plugin <strong>com.nokia.carbide.cpp.epoc.engine</strong>.</p>
+<p>Typically most keywords of interest are either single string settings (<span class="code">TARGETTYPE</span>, <span class="code">TARGET</span>, <span class="code">EPOCSTACKSIZE</span>) or list of settings (<span class="code">MACRO</span>, <span class="code">CAPABILITY</span>, <span class="code">LANG</span>). Other types can be directly retrieved from IMMPData routines. Check the API documentation for specifics.</p>
+<p>The example provided simply iterates through all the MMP files of a particular build configuration and grabs a list value and single item setting. You'll need to get the particular MMP file you are interested in. Play around with the IMMPData object in the run method and you can quickly get the idea.</p>
+<PRE class="listing">// Assumes buildConfig (ICarbideBuildConfiguration) is known
+for (IPath mmpPath : EpocEngineHelper.getMMPFilesForBuildConfiguration(buildConfig)) {
+ Object data = EpocEnginePlugin.runWithMMPData(mmpPath, new
+ DefaultMMPViewConfiguration(buildConfig.getCarbideProject().getProject(),
+ buildConfig, new AcceptedNodesViewFilter()), new MMPDataRunnableAdapter() {
+ public Object run(IMMPData mmpData) {
+ // Example, getting a keyword as a list of strings
+ List macros = mmpData.getListArgumentSettings().get(EMMPStatement.MACRO);
+ // The real return value, getting a single argument setting
+ return mmpData.getSingleArgumentSettings().get(EMMPStatement.TARGETTYPE);
+ }
+ });
+// Make sure to test for and cast to proper Object type!
+String mmpStatement = (String)data; // Now we should have the TARGETTYPE
+}</PRE>
+<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/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/tocTasks.xml Mon Apr 27 15:07:35 2009 -0500
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/tocTasks.xml Tue Apr 28 11:04:43 2009 -0500
@@ -1,14 +1,14 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<?NLS TYPE="org.eclipse.help.toc"?>
-
-<toc label="Tasks" link_to="sdkTOC.xml#sdkTasks" >
- <topic label="Adding Items to the Carbide Menu" href="html/tasks/CarbideMenu.htm"/>
- <topic label="Adding Global Preferences to the Carbide Extensions group" href="html/tasks/CarbideExtensionPreferences.htm"/>
- <topic label="Adding Plug-in Help" href="html/tasks/CarbideHelp.htm"/>
- <topic label="Installing Your Own Carbide Plug-ins" href="html/tasks/carbide_adding_plugins.htm"/>
- <topic label="Creating Wizard Templates" href="html/tasks/CreatingWizardTemplates.htm"/>
- <topic label="Creating Plugins to Access Carbide Project Information">
- <topic label="Getting Carbide Project Information" href="html/tasks/sdk_getprojinfo.htm"/>
- <topic label="Retrieving INF and MMP Project Information" href="html/tasks/sdk_getinfmmpinfo.htm"/>
- </topic>
+<?xml version="1.0" encoding="UTF-8"?>
+<?NLS TYPE="org.eclipse.help.toc"?>
+
+<toc label="Tasks" link_to="sdkTOC.xml#sdkTasks" >
+ <topic label="Adding Items to the Carbide Menu" href="html/tasks/CarbideMenu.htm"/>
+ <topic label="Adding Global Preferences to the Carbide Extensions group" href="html/tasks/CarbideExtensionPreferences.htm"/>
+ <topic label="Adding Plug-in Help" href="html/tasks/CarbideHelp.htm"/>
+ <topic label="Creating Wizard Templates" href="html/tasks/CreatingWizardTemplates.htm"/>
+ <topic label="Carbide Plug-in Overview" href="html/tasks/sdkMainTopic.htm" >
+ <topic label="Getting Carbide Project Information" href="html/tasks/sdk_getprojinfo.htm"/>
+ <topic label="Retrieving INF and MMP Project Information" href="html/tasks/sdk_getinfmmpinfo.htm"/>
+ </topic>
+ <topic label="Installing Your Own Carbide Plug-ins" href="html/tasks/carbide_adding_plugins.htm"/>
</toc>
\ No newline at end of file
