|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
|
2 <html> |
|
3 <head> |
|
4 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> |
|
5 <title>Tips and tricks</title> |
|
6 <link href="../../book.css" type="text/css" rel="stylesheet"> |
|
7 </head> |
|
8 |
|
9 <body> |
|
10 <h2>TraceBuilder tips and tricks</h2> |
|
11 |
|
12 <h3>Handling non-source files</h3> |
|
13 |
|
14 <p>TraceCompiler parses Open System Traces (OST) from source files listed in a |
|
15 project's MMP file. However, if traces need to be parsed from header files or |
|
16 inline files (<i>.inl</i>), the files need to be explicitly specified in the |
|
17 <i>trace.properties</i> property file. </p> |
|
18 |
|
19 <p>TraceBuilder does not support the definition of non-source files but you can |
|
20 define them manually by adding the needed file elements to the |
|
21 <i>trace.properties</i> property file. </p> |
|
22 |
|
23 <p>For example:</p> |
|
24 |
|
25 <p><code><?xml version="1.0" encoding="UTF-8"?><br> |
|
26 <trace_properties><br> |
|
27 <b><file>../inc/MyFunctions.inl</file><br> |
|
28 <file>../inc/MyFunctions.h</file></b><br> |
|
29 </trace_properties></code><br> |
|
30 </p> |
|
31 |
|
32 <p>The path to the file is relative to the location of the property file. The |
|
33 header file where the traces will be generated follows the same naming rules as |
|
34 the source files. From the above example, traces from both |
|
35 <i>MyFunctions.inl</i> and <i>MyFunctions.h</i> (and also |
|
36 <i>MyFunctions.cpp</i> if it exists) would go to the <i>MyFunctionsTraces.h</i> |
|
37 file.</p> |
|
38 |
|
39 <p><b>NOTE!</b> Location of the property file <i>trace.properties</i> is the |
|
40 trace directory. It could be that the property file <i>trace.properties</i> |
|
41 does not exist if there are no enumeration type definitions or non-source file |
|
42 definitions. In that case, it needs to be created manually.</p> |
|
43 |
|
44 <h5>Related concepts</h5> |
|
45 <ul> |
|
46 <li><a href="../concepts/trace_format.htm">Open System Trace (OST)</a></li> |
|
47 </ul> |
|
48 |
|
49 <div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. |
|
50 License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div> |
|
51 </body> |
|
52 </html> |