sbsv2/raptor/notes/tcomsupport.txt
author mikek
Fri, 04 Jun 2010 13:09:28 +0100
changeset 18 de5b887c98f7
permissions -rw-r--r--
Upgrading to Raptor 2.14
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
18
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     1
New Trace Compiler
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     2
-------------------
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     3
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     4
Raptor supports an updated version of the Trace Compiler which has
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     5
an improved command-line interface that allows Raptor to specify the
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     6
directory in which trace data should be written.  This allows MMPs to
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     7
implement a new convention for where trace files are stored.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     8
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     9
The new convention prevents clashes where building the same
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    10
source file for different MMPs would previously have resulted in two
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    11
build tasks trying to create the same trace file (header/dictionary).
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    12
This caused build slowdowns and also made the trace data inaccurate.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    13
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    14
The standard for this directory is that the last two elements of the
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    15
path should be
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    16
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    17
   traces/traces_<targetname>_<ext>
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    18
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    19
e.g.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    20
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    21
   traces/traces_euser_dll
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    22
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    23
The new trace compiler also creates "autogen" headers in a new location
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    24
under epoc32/include/platform rather than epoc32/include/internal.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    25
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    26
Trace Headers Directory can now also be in SYSTEMINCLUDEs
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    27
----------------------------------------------------------
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    28
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    29
Some teams were having trouble getting qmake to generate MMPs with
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    30
USERINCLUDEs set.  So they were specifying the trace header directory in
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    31
their SYTEMINCLUDEs.  This change causes Raptor to look for the traces
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    32
directory in bot SYSTEMINCLUDES and USERINCLUDES.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    33
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    34
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    35
Create Trace Directories During Makefile Parse
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    36
-----------------------------------------------
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    37
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    38
Some build engines consider it a "clash" when two jobs attempt to make the
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    39
same directory.  This change causes some important trace output directories
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    40
to be created during makefile parsing which removes the (small) possibility
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    41
that they would clash during the build part.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    42