# HG changeset patch
# User timkelly
# Date 1280509993 18000
# Node ID 9ad7e7b0412099aa35d0b9d841311f638c54752f
# Parent  e0e324a4ef678cd9e5ef9b67916a78b012f487ed
Added API change notes for SDK/Builder related stuff. Added an @since 3.0 tag on API

diff -r e0e324a4ef67 -r 9ad7e7b04120 builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/builder/project/ICarbideBuildConfiguration.java
--- a/builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/builder/project/ICarbideBuildConfiguration.java	Thu Jul 29 15:50:56 2010 -0500
+++ b/builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/builder/project/ICarbideBuildConfiguration.java	Fri Jul 30 12:13:13 2010 -0500
@@ -169,7 +169,8 @@
 
 	/**
 	 * Get the <cconfiguration/> 'id' attribute for this configuration (from .cproject file). This is an ISymbianBuildContext wrapper.
-	 * @return
+	 * @return String
+	 * @since 3.0
 	 */
 	String getConfigurationID();
 	
diff -r e0e324a4ef67 -r 9ad7e7b04120 carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/api_Change_Notes.htm
--- a/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/api_Change_Notes.htm	Thu Jul 29 15:50:56 2010 -0500
+++ b/carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/reference/api_Change_Notes.htm	Fri Jul 30 12:13:13 2010 -0500
@@ -107,13 +107,47 @@
 	<li>Added <em> com.nokia.carbide.cdt.builder.project.ISymbianBuildConfiguration#getTargetOutputDirectory( )</em>.</li>
 </ul>
 
-<p>Since Carbide 3.0.0</p>
+<p>Since Carbide 3.0.0 (C3)</p>
 <ul>
-	<li>IConnectionsManager was updated to indicate it is not intended to be implemented by clients.
+
+	<li>C3 is an API breaking release, primarily around areas of Symbian SDK management and Symbian build support.
+	This release removes support for Symbian OS versions prior to 9.4 (i.e. only support for Symbian^2 and up are supported).
+	Management of Symbian SDKs has been simplified and the APIs have been trimmed to reflect this.</li>
+
+	<li><i>ISymbianSDK</i></li>
+	<ul>
+		<li>added <i>getSupportedFeatures()</i> - see <i>com.nokia.carbide.cpp.sdk.core#ISymbianSDKFeatures</i> for supported feature constants.</li>
+		<li>added <i>ISDKBuildInfo getBuildInfo(String builderId)</i> - This is used to get the base data (ISymbianBuildContext) for a build configuration, depending on the builder you are using (e.g. abld versus sbsv2). See com.nokia.carbide.cpp.sdk.core#ISDKBuildInfo </li>
+	</ul>
+	
+	<li><i>com.nokia.carbide.cpp.sdk.core#ISDKBuildInfo</i> was added.</li>
+	<li><i>com.nokia.carbide.cpp.sdk.core#ISBSv1BuildContext</i> was added.</li>
+	<li><i>com.nokia.carbide.cpp.sdk.core#ISBSv2BuildContext</i> was added.</li>
+	<li><i>com.nokia.carbide.cpp.sdk.core#ISBSv2BuiISymbianSDKFeatures</i> was added.</li>
+	
+	<li><i>ICarbideBuildConfiguration</i></li>
+	<ul>
+		<li>added <i>ISymbianBuildContext getBuildContext()</i></li>
+		<li>added <i>getDisplayString()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getSDK()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getPlatformString()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getTargetString()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getCompilerPrefixFile()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getCompilerMacros()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getVariantHRHDefines()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getPrefixFileIncludes()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getBuildVariationName()</i> - A convenience wrapper for ISymbiabBuildContext</li>
+		<li>added <i>getConfigurationID()</i></li>
+		<li>added <i>hasSTDCPPSupport()</i></li>
+	</ul>
+
+	<li><i>ISymbianBuildContext</i> - This interface is no longer implemented by ICarbideBuildConfiguration. Rather, it is now an abstracted interface for builders to provide base build data for an <i>ICarbideBuildConfiguration</i> instance</li>
+
+	<li><i>IConnectionsManager</i> was updated to indicate it is not intended to be implemented by clients.
 	<li>Added several new methods to support automated connection/device discovery agents and default connections.</li>
-	<li>Deprecated IClientServiceSiteUI and adding new IClientServiceSiteUI2 to support concept of default connection
+	<li>Deprecated <i>IClientServiceSiteUI</i> and adding new <i>IClientServiceSiteUI2</i> to support concept of default connection
 	<ul>
-		<li>getSelectedConnection() and selectConnection() now use connection ids rather than connection objects
+		<li><i>getSelectedConnection()</i> and <i>selectConnection()</i> now use connection ids rather than connection objects
 		<li>Exposing new selection status to allow reporting when default connection is not supported by client service
 	</ul>
 </ul>
@@ -162,6 +196,12 @@
 <ul>
   <li><i>com.nokia.carbide.cdt.builder.builder.CarbideCPPBuilder#generateAbldMakefileIfNecessary(ICarbideBuildConfiguration config, CarbideCommandLauncher launcher, IPath componentPath, boolean isTest)</i></li>
 </ul>
+
+<p>Since Carbide 3.0</p>
+<ul>
+  <li><i>ISymbiabSDK#getOSVersion</i> - use ISymbianSDK#getSupportedFeatures instead to test for properties of an SDK.</li>
+</ul>
+
 <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>
@@ -192,6 +232,12 @@
   <li>None</li>
 </ul>
 
+<p>Since Carbide 3.0</p>
+<ul>
+  <li><i>com.nokia.carbide.cpp.sdk.core#ISymbianSDK</i> removed several methods. Please refer to the source code.</li>
+   <li><i>ICarbideBuildConfiguration</i> no longer implements <i>ISymbiabBuildContext</i>. You will need to use the ISymbianBuildContext wrapper methods to access that interface now.</li>
+</ul>
+
 <div id="footer">Copyright &copy; 2010 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>