# HG changeset patch
# User timothy.murphy@nokia.com
# Date 1272642936 -3600
# Node ID 92300322d8f8d002290af7151bc020ef8a4e6d4d
# Parent  a9260a413076028519d9d89fb52cafab334e5a4e
Better release notes.

diff -r a9260a413076 -r 92300322d8f8 sbsv2/raptor/RELEASE-NOTES.html
--- a/sbsv2/raptor/RELEASE-NOTES.html	Fri Apr 30 16:34:01 2010 +0100
+++ b/sbsv2/raptor/RELEASE-NOTES.html	Fri Apr 30 16:55:36 2010 +0100
@@ -18,8 +18,8 @@
 <ul>
 <li><a href="http://developer.symbian.org/bugs/show_bug.cgi?id=2297"> SF Bug 2297 </a> Python exception in raptor_meta.py when processing bld.inf file </li>
 <li><a href="http://developer.symbian.org/bugs/show_bug.cgi?id=2174"> SF Bug 2174 </a> -- layer option shows errors when bld.inf missing in another layer </li>
-<li>Fix: ensure trace paths exist before build starts to avoid clashes during the build with some make engines    </a></li>
-<li>Fix: permit traces path to be specified in systemincludes - helps Qt    </a></li>
+<li><a href="notes/tcomsupport.txt">Fix: ensure trace paths exist before build starts to avoid clashes during the build with some make engines    </a></li>
+<li><a href="notes/tcomsupport.txt">Fix: permit traces header directory to be specified in systemincludes - helps Qt    </a></li>
 </ul>
 
 
diff -r a9260a413076 -r 92300322d8f8 sbsv2/raptor/notes/tcomsupport.txt
--- a/sbsv2/raptor/notes/tcomsupport.txt	Fri Apr 30 16:34:01 2010 +0100
+++ b/sbsv2/raptor/notes/tcomsupport.txt	Fri Apr 30 16:55:36 2010 +0100
@@ -1,10 +1,51 @@
-Raptor supports a new interface to the trace compiler that allows
-Raptor to specify the direcotry in which trace data should be written.
-This allows components to support a new convention for where trace files
-are stored.
+New Trace Compiler
+-------------------
 
-The new convention that prevents the clashes where building the same
+Raptor supports an updated version of the Trace Compiler which has
+an improved commandline interface that allows Raptor to specify the
+directory in which trace data should be written.  This allows MMPs to
+implement a new convention for where trace files are stored.
+
+The new convention prevents clashes where building the same
 source file for different MMPs would previously have resulted in two
 build tasks trying to create the same trace file (header/dictionary).
 This caused build slowdowns and also made the trace data inaccurate.
 
+The standard for this directory is that the last twwo elements of the
+path should be
+
+   traces/traces_<targetname>_<ext>
+
+e.g.
+
+   traces/traces_euser_dll
+
+The new trace compiler also creates "autogen" headers in a new location
+under epoc32/include/platform rather than epoc32/incude/internal.
+
+Trace Headers Directory can now also be in SYSTEMINCLUDEs
+----------------------------------------------------------
+
+Some teams were having trouble getting qmake to generate MMPs with
+USERINCLUDEs set.  So they were specifying the trace header directory in
+their SYTEMINCLUDEs.  This change causes Raptor to look for the traces
+directory in bot SYSTEMINCLUDES and USERINCLUDES.
+
+
+Automatic Macro definition - OST_TRACE_COMPILER_IN_USE
+--------------------------------------------------------
+
+When Raptor notices that the trace compiler is required for an MMP (by
+looking for the traces/targetname_ext directory in the SYSTEMINCLUDES
+or USERINCLUDES) it causes the application to build with the
+OST_TRACE_COMPILER_IN_USE defined automatically
+
+
+Create Trace Directories During Makefile Parse
+-----------------------------------------------
+
+Some build engines consider it a "clash" when two jobs attempt to make the
+same directory.  This change causes some important trace output directories
+to be created during makefile parsing which removes the (small) possibilty
+that they would clash during the build part.
+