sbsv2/raptor/notes/tcomsupport.txt
author timothy.murphy@nokia.com
Fri, 30 Apr 2010 16:55:36 +0100
branchfix
changeset 514 92300322d8f8
parent 512 f270c42a56c4
child 516 cd8318d5fb3a
permissions -rw-r--r--
Better release notes.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
514
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
     1
New Trace Compiler
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
     2
-------------------
512
f270c42a56c4 notes about tcomsupport update
timothy.murphy@nokia.com
parents:
diff changeset
     3
514
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
     4
Raptor supports an updated version of the Trace Compiler which has
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
     5
an improved commandline interface that allows Raptor to specify the
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
     6
directory in which trace data should be written.  This allows MMPs to
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
     7
implement a new convention for where trace files are stored.
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
     8
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
     9
The new convention prevents clashes where building the same
512
f270c42a56c4 notes about tcomsupport update
timothy.murphy@nokia.com
parents:
diff changeset
    10
source file for different MMPs would previously have resulted in two
f270c42a56c4 notes about tcomsupport update
timothy.murphy@nokia.com
parents:
diff changeset
    11
build tasks trying to create the same trace file (header/dictionary).
f270c42a56c4 notes about tcomsupport update
timothy.murphy@nokia.com
parents:
diff changeset
    12
This caused build slowdowns and also made the trace data inaccurate.
f270c42a56c4 notes about tcomsupport update
timothy.murphy@nokia.com
parents:
diff changeset
    13
514
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    14
The standard for this directory is that the last twwo elements of the
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    15
path should be
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    16
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    17
   traces/traces_<targetname>_<ext>
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    18
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    19
e.g.
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    20
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    21
   traces/traces_euser_dll
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    22
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    23
The new trace compiler also creates "autogen" headers in a new location
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    24
under epoc32/include/platform rather than epoc32/incude/internal.
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    25
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    26
Trace Headers Directory can now also be in SYSTEMINCLUDEs
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    27
----------------------------------------------------------
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    28
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    29
Some teams were having trouble getting qmake to generate MMPs with
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    30
USERINCLUDEs set.  So they were specifying the trace header directory in
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    31
their SYTEMINCLUDEs.  This change causes Raptor to look for the traces
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    32
directory in bot SYSTEMINCLUDES and USERINCLUDES.
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    33
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    34
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    35
Automatic Macro definition - OST_TRACE_COMPILER_IN_USE
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    36
--------------------------------------------------------
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    37
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    38
When Raptor notices that the trace compiler is required for an MMP (by
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    39
looking for the traces/targetname_ext directory in the SYSTEMINCLUDES
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    40
or USERINCLUDES) it causes the application to build with the
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    41
OST_TRACE_COMPILER_IN_USE defined automatically
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    42
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    43
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    44
Create Trace Directories During Makefile Parse
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    45
-----------------------------------------------
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    46
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    47
Some build engines consider it a "clash" when two jobs attempt to make the
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    48
same directory.  This change causes some important trace output directories
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    49
to be created during makefile parsing which removes the (small) possibilty
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    50
that they would clash during the build part.
92300322d8f8 Better release notes.
timothy.murphy@nokia.com
parents: 512
diff changeset
    51