sbsv2/raptor/notes/tcomsupport.txt
author Mike Kinghan <mikek@symbian.org>
Thu, 25 Nov 2010 13:59:07 +0000
changeset 40 68f68128601f
parent 18 de5b887c98f7
permissions -rw-r--r--
1) Add the sbsv1 components from sftools/dev/build to make the linux_build package independent of the obsolete buildtools package. 2) Enhance romnibus.pl so that it generate the symbol file for the built rom when invoked by Raptor 3) Make the maksym.pl tool portable for Linux as well as Windows. 4) Remove the of armasm2as.pl from the e32tools component in favour of the copy now exported from sbsv1/e32util.
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