tcomsupport.txt 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243
  1. New Trace Compiler
  2. -------------------
  3. Raptor supports an updated version of the Trace Compiler which has
  4. an improved command-line interface that allows Raptor to specify the
  5. directory in which trace data should be written. This allows MMPs to
  6. implement a new convention for where trace files are stored.
  7. The new convention prevents clashes where building the same
  8. source file for different MMPs would previously have resulted in two
  9. build tasks trying to create the same trace file (header/dictionary).
  10. This caused build slowdowns and also made the trace data inaccurate.
  11. The standard for this directory is that the last two elements of the
  12. path should be
  13. traces/traces_<targetname>_<ext>
  14. e.g.
  15. traces/traces_euser_dll
  16. The new trace compiler also creates "autogen" headers in a new location
  17. under epoc32/include/platform rather than epoc32/include/internal.
  18. Trace Headers Directory can now also be in SYSTEMINCLUDEs
  19. ----------------------------------------------------------
  20. Some teams were having trouble getting qmake to generate MMPs with
  21. USERINCLUDEs set. So they were specifying the trace header directory in
  22. their SYTEMINCLUDEs. This change causes Raptor to look for the traces
  23. directory in bot SYSTEMINCLUDES and USERINCLUDES.
  24. Create Trace Directories During Makefile Parse
  25. -----------------------------------------------
  26. Some build engines consider it a "clash" when two jobs attempt to make the
  27. same directory. This change causes some important trace output directories
  28. to be created during makefile parsing which removes the (small) possibility
  29. that they would clash during the build part.