draft of sbsv2 concept and related index, trk, and TOC changes
authorfturovic <frank.turovich@nokia.com>
Thu, 05 Aug 2010 14:41:19 -0500
changeset 1777 490bb9a68e6b
parent 1775 2771fd853ac2
child 1780 e2992bb8a7f9
draft of sbsv2 concept and related index, trk, and TOC changes
core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm
core/com.nokia.carbide.cpp.doc.user/html/concepts/sbsv2.htm
core/com.nokia.carbide.cpp.doc.user/html/concepts/trk.htm
core/com.nokia.carbide.cpp.doc.user/html/reference/pref_carb_build.htm
core/com.nokia.carbide.cpp.doc.user/index.xml
core/com.nokia.carbide.cpp.doc.user/intro/whatsnew_IntroExt.xml
core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm	Thu Aug 05 14:24:42 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/concepts.htm	Thu Aug 05 14:41:19 2010 -0500
@@ -36,6 +36,7 @@
   <li><a href="ngage_projects.htm">N-Gage Projects</a></li>
   <li><a href="trk.htm">On-device Debugging</a></li>
   <li><a href="precompiled_headers.htm">Precompiled Headers</a></li>
+  <li><a href="sbsv2.htm">Symbian Build System</a> (SBSv2)</li>
   <li><a href="registers.htm">Registers</a></li>
   <li><a href="../tasks/WorkingwithSDKs.html">SDK Support</a></li>
   <li><a href="cvs.htm">Software Configuration Management </a></li>
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/sbsv2.htm	Thu Aug 05 14:41:19 2010 -0500
@@ -0,0 +1,47 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
+<title>Symbian Build System (SBSv2)</title>
+<link rel="StyleSheet" href="../../book.css" type="text/css"/>
+</head>
+<body bgcolor="#FFFFFF">
+<h2><strong>Symbian</strong> Build System (SBSv2)</h2>
+<p>Carbide.c++ v3.x fully supports the <strong>Symbian Build System</strong> (SBSv2) for building Symbian executables. Codenamed RAPTOR, SBSv2 is also designed to overcome several limitations in GNU Make, including: </p>
+<ul>
+    <li>modularity and code re-use</li>
+    <li>separation of interface and implementation</li>
+    <li>extensibility</li>
+    <li>testability</li>
+</ul>
+<p>In addition, SBSv2:</p>
+<ul>
+    <li>is supported on the Windows and Linux operating systems</li>
+    <li>is more scalable than previous systems</li>
+    <li>supports incremental and parallel builds</li>
+    <li>offers more flexibility in build configurations</li>
+    <li>offers an overall 20% speed improvement</li>
+</ul>
+<p>SBSv2 also supports the use of build variants. A variant  is basically something which modifies a build. For example, a variant could be the standard ARMv5 build with Demand Paging functions enabled. Already defined variants are found in the <strong>Build &gt; SBSv2</strong> preference panel.</p>
+<p class="note"><strong>NOTE</strong> Carbide no longer supports the ABLD system. Use Carbide.c++ v2.7 instead if you require SBSv1 support.</p>
+<p>Preferences  for configuring SBSv2 is found  by clicking <strong>Window &gt; Preferences &gt; Carbide.c++</strong>:</p>
+<ul>
+    <li><a href="../reference/pref_carb_build.htm">Build &gt; SBSv2</a> &ndash; control general build options like clean, test components, dependency tracking, concurrent build jobs, build behavior, and emulator options</li>
+    <li><a href="../tasks/sdks/sdk_platform_filter.htm">Build Configuration Filtering</a> &ndash; controls which platforms are visible when creating new projects or build configurations.</li>
+    <li><a href="../reference/pref_carb_symbian_sdk.htm">Symbian SDKs</a> &ndash;  control which installed SDKs are available to projects during project creation or importing.</li>
+</ul>
+<p>Every project also has a set of SBSv2 properties to customize: </p>
+<ul>
+    <li><a href="../reference/build_properties/prop_carb_project_settings.htm">Properties for <em>project</em> &gt; Carbide.c++ &gt; Project Settings</a> &ndash; specifies whether all components or selected subcomponents listed in a build information file (<span class="code">bld.inf</span>) should be built for the currently selected project.</li>
+</ul>
+<p>For more information on SBSv2, see the Symbian Foundation's wiki article <a href="http://developer.symbian.org/wiki/index.php/Introduction_to_RAPTOR">Introduction to RAPTOR</a> and others.</p>
+<h5>Other References</h5>
+<ul>
+  <li><a href="concepts.htm">Concepts</a></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>
+
+</body>
+</html>
\ No newline at end of file
--- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/trk.htm	Thu Aug 05 14:24:42 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/trk.htm	Thu Aug 05 14:41:19 2010 -0500
@@ -4,20 +4,20 @@
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
 <meta http-equiv="Content-Style-Type" content="text/css" />
 <meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>On-device Debugging</title>
+<title>TRK On-device Debugging</title>
 <link rel="StyleSheet" href="../../book.css" type="text/css"/>
 </head>
 <body bgcolor="#FFFFFF">
-<h2>On-device Debugging</h2>
-<p>The on-device debug agent (Application TRK or System TRK) is a program that enables on-device debugging of  phone prototypes, reference boards, and retail phones. An on-device debug agent is a program that is installed on a phone or reference board. It communicates with the debugger using a serial-over-Bluetooth or serial-over-USB connection. Through this serial communication, the on-device debug agent acts as the interface between the Carbide.c++ debugger and the target device. An on-device debug agent provides: </p>
+<h2>TRK On-device Debugging</h2>
+<p>The on-device TRK remote agent (Application TRK or System TRK) is a program that enables on-device debugging of  phone prototypes, reference boards, and retail phones. An on-device debug agent is a program that is installed on a phone or reference board. It communicates with the debugger using a serial-over-Bluetooth or serial-over-USB connection. Through this serial communication, the on-device debug agent acts as the interface between the Carbide.c++ debugger and the target device. An on-device debug agent provides: </p>
 <ul>
   <li>Debug agent running on Symbian OS</li>
   <li>Provides a stable &amp; integrated interface to Symbian OS</li>
   <li>Used to debug applications on actual devices</li>
   <li>Can be built-in to the OS image or installed as a .sis file</li>
 </ul>
-<p>Using the on-device debug agent, one can use the Carbide.c++ IDE to debug programs running on phone hardware, making the debugging process much easier. The on-device debug agent works on all S60 3rd Edition devices, UIQ 3rd Edition devices, and Symbian TechView devkits.</p>
-<p>The Application TRK debug agents are stored online and can be downloaded and installed using the <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections &gt; New Connection Wizard &gt; Install remote agents</a> pane.</p>
+<p>Using the on-device remote agent, one can use the Carbide.c++ IDE to debug programs running on phone hardware, making the debugging process much easier. The on-device debug agent works on all Nokia Qt SDK, Symbian^3, and Symbian TechView devkits.</p>
+<p>The Application TRK remote agents are stored online and can be downloaded and installed using the <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections &gt; New Connection Wizard &gt; Install remote agents</a> pane.</p>
 <p>Some of the key benefits to using an on-device debug agent include:</p>
 <ul>
   <li>Easy debugging via serial interface (Bluetooth, USB, IrDA, etc)</li>
@@ -30,7 +30,6 @@
   <li><b>System TRK</b>&#8212;
   supports both application and limited ROM debugging (includes application executables and limited ROM based components (i.e. no device drivers) and available to original equipment manufacturers (OEM) for device creation and customization</li>
 </ul>
-<p class="note"><b>NOTE</b> The type of on-device debug agent you have is based upon which  Carbide.c++ product you have licensed. System TRK is only available with the Professional or OEM version of the product. </p>
 <h5>Related tasks</h5>
 <ul>
   <li><a href="../tasks/trk/trk_overview.htm">On-device Debugging Overview</a> </li>
--- a/core/com.nokia.carbide.cpp.doc.user/html/reference/pref_carb_build.htm	Thu Aug 05 14:24:42 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/pref_carb_build.htm	Thu Aug 05 14:41:19 2010 -0500
@@ -101,8 +101,8 @@
   <tr>
     <td><b>Clean level </b></td>
     <td>Select the level of clean when cleaning a project.
-      <p><strong>abld clean</strong> erases all files created by a corresponding abld target   command (all intermediate files created during compilation and all executables and import libraries created by the linker) </p>
-      <p><strong>abld reallyclean</strong> does what abld clean does, and also removes files   exported by abld export and makefiles generated by abld makefile, or the abld   test equivalents</p></td>
+      <p><strong>sbs clean</strong> erases all files created by a corresponding sbs target   command (all intermediate files created during compilation and all executables and import libraries created by the linker) </p>
+      <p><strong>sbs reallyclean</strong> does what sbs clean does, and also removes files   exported by sbs export and makefiles generated by sbs makefile, or the sbs   test equivalents</p></td>
   </tr>
   <tr>
     <td><b>Keep going </b></td>
--- a/core/com.nokia.carbide.cpp.doc.user/index.xml	Thu Aug 05 14:24:42 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/index.xml	Thu Aug 05 14:41:19 2010 -0500
@@ -644,6 +644,15 @@
 	<entry keyword="System Browser View">
 	   <topic href="html/reference/view_system_browser.htm" label="System Browser" />
 	</entry>
+	
+	<entry keyword="Symbian Build System">
+	   <topic href="html/concepts/sbsv2.htm" label="Symbian Build System" />
+	</entry>
+
+	<entry keyword="SBSv2">
+	   <topic href="html/concepts/sbsv2.htm" label="Symbian Build System" />
+	</entry>
+
 
 <!-- T -->
 
--- a/core/com.nokia.carbide.cpp.doc.user/intro/whatsnew_IntroExt.xml	Thu Aug 05 14:24:42 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/intro/whatsnew_IntroExt.xml	Thu Aug 05 14:41:19 2010 -0500
@@ -20,7 +20,17 @@
 		  
 		<group style-id="content-group" id="carbide-cpp">
        		<link 
-       		label="Improved Carbide Debugger  (3.0b)" 
+       		label="Symbian Build System (SBSv2, 3.0)" 
+       		url="http://org.eclipse.ui.intro/showHelpTopic?id=/com.nokia.carbide.cpp.doc.user/html/concepts/sbsv2.htm" 
+       		id="carbide-whatsnew" 
+       		style-id="content-link">
+          	<text>SBSv2 is the new build engine for Symbian programs. Find out more here.</text>
+       		</link>
+       	</group>
+
+		<group style-id="content-group" id="carbide-cpp">
+       		<link 
+       		label="Improved Carbide Debugger (3.0)" 
        		url="http://org.eclipse.ui.intro/showHelpTopic?id=/com.nokia.carbide.cpp.doc.user/html/release_notes.htm" 
        		id="carbide-whatsnew" 
        		style-id="content-link">
@@ -30,11 +40,11 @@
 
 		<group style-id="content-group" id="carbide-cpp">
        		<link 
-       		label="Plug-n-Play On-device Debugging (in 2.5)" 
-       		url="http://org.eclipse.ui.intro/showHelpTopic?id=/com.nokia.carbide.cpp.doc.user/html/release_notes.htm" 
+       		label="TCF TRK (3.0)" 
+       		url="http://org.eclipse.ui.intro/showHelpTopic?id=/com.nokia.carbide.cpp.doc.user/html/concepts/trk.htm" 
        		id="carbide-whatsnew" 
        		style-id="content-link">
-          	<text>Debugging programs on a target device has never been easier with PnP on-device debugging.</text>
+          	<text>The TRK remote agent now uses TCF for faster, more flexible communication.</text>
        		</link>
        	</group>
 
--- a/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml	Thu Aug 05 14:24:42 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml	Thu Aug 05 14:41:19 2010 -0500
@@ -102,6 +102,7 @@
   </topic>
   <topic label="Project management" >
     <topic label="Carbide C/C++ perspective" 			href="html/concepts/CarbidePerspective.html" />
+    <topic label="Symbian Build System (SBSv2)" 			href="html/concepts/sbsv2.htm" />
     <topic label="Carbide.c++ preferences" 				href="html/reference/pref_carb_cpp.htm" >
       <topic label="Build"								href="html/reference/pref_carb_build.htm" />
       <topic label="Debugger"							href="html/reference/pref_carb_debugger.htm" />