sbsv2/raptor/notes/tcomsupport.txt
branchfix
changeset 516 cd8318d5fb3a
parent 514 92300322d8f8
child 522 9971c248e894
equal deleted inserted replaced
515:49a9c0e288ac 516:cd8318d5fb3a
     1 New Trace Compiler
     1 New Trace Compiler
     2 -------------------
     2 -------------------
     3 
     3 
     4 Raptor supports an updated version of the Trace Compiler which has
     4 Raptor supports an updated version of the Trace Compiler which has
     5 an improved commandline interface that allows Raptor to specify the
     5 an improved command-line interface that allows Raptor to specify the
     6 directory in which trace data should be written.  This allows MMPs to
     6 directory in which trace data should be written.  This allows MMPs to
     7 implement a new convention for where trace files are stored.
     7 implement a new convention for where trace files are stored.
     8 
     8 
     9 The new convention prevents clashes where building the same
     9 The new convention prevents clashes where building the same
    10 source file for different MMPs would previously have resulted in two
    10 source file for different MMPs would previously have resulted in two
    11 build tasks trying to create the same trace file (header/dictionary).
    11 build tasks trying to create the same trace file (header/dictionary).
    12 This caused build slowdowns and also made the trace data inaccurate.
    12 This caused build slowdowns and also made the trace data inaccurate.
    13 
    13 
    14 The standard for this directory is that the last twwo elements of the
    14 The standard for this directory is that the last two elements of the
    15 path should be
    15 path should be
    16 
    16 
    17    traces/traces_<targetname>_<ext>
    17    traces/traces_<targetname>_<ext>
    18 
    18 
    19 e.g.
    19 e.g.
    20 
    20 
    21    traces/traces_euser_dll
    21    traces/traces_euser_dll
    22 
    22 
    23 The new trace compiler also creates "autogen" headers in a new location
    23 The new trace compiler also creates "autogen" headers in a new location
    24 under epoc32/include/platform rather than epoc32/incude/internal.
    24 under epoc32/include/platform rather than epoc32/include/internal.
    25 
    25 
    26 Trace Headers Directory can now also be in SYSTEMINCLUDEs
    26 Trace Headers Directory can now also be in SYSTEMINCLUDEs
    27 ----------------------------------------------------------
    27 ----------------------------------------------------------
    28 
    28 
    29 Some teams were having trouble getting qmake to generate MMPs with
    29 Some teams were having trouble getting qmake to generate MMPs with
    44 Create Trace Directories During Makefile Parse
    44 Create Trace Directories During Makefile Parse
    45 -----------------------------------------------
    45 -----------------------------------------------
    46 
    46 
    47 Some build engines consider it a "clash" when two jobs attempt to make the
    47 Some build engines consider it a "clash" when two jobs attempt to make the
    48 same directory.  This change causes some important trace output directories
    48 same directory.  This change causes some important trace output directories
    49 to be created during makefile parsing which removes the (small) possibilty
    49 to be created during makefile parsing which removes the (small) possibility
    50 that they would clash during the build part.
    50 that they would clash during the build part.
    51 
    51