diff -r ed1c9f64298a -r 5b9d4d8641ce trace/traceviewer/com.nokia.traceviewer.help/html/tasks/setup_rules.htm
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/trace/traceviewer/com.nokia.traceviewer.help/html/tasks/setup_rules.htm Wed Jun 23 14:49:59 2010 +0300
@@ -0,0 +1,106 @@
+
+
+
+Setting up rules and filters
+
+
+
+
Setting up rules and filters
+
Before you start
+
You can work with generated traces in various ways, by setting rules and filters
+for them. The settings are saved into a configuration file named userConf.xml
+, and can be exported from TraceViewer or imported back in by using Carbide's
+import and export functions available under the File menu.
+
You can configure rules and filters in a separate dialog that lists its contents
+like a tree.
+
+
To set up rules for traces, do the following:
+
+
On the TraceViewer toolbar, click the item for which you want to create
+a rule or a rule definition:
+
+
+
+
+
+
+
+
+
Button
+
Use it to open:
+
+
+
+
+
+
Basic filter settings.
+
+
+
+
Trace coloring settings, including definitions for foreground and background
+colors.
+
+
+
+
Trace counting settings
+
+
+
+
Variable value tracing settings, including definitions for the number
+of steps stored in variable tracing history.
+
+
+
+
Trigger settings, including definitions for start and stop triggers.
+For instructions, see Configuring triggers.
+
+
+
+
+
The Rules dialog for the selected item is displayed.
+
To manage the rules, do any of the following:
+
+
To create a new rule, click Add. The Definition dialog is
+opened.
+
To edit an existing rule, select it and click Edit. The Definition
+ dialog is opened.
+
To delete a rule, select it and click Remove.
+
To clear the whole tree, click Clear.
+
To create groups for rules, click Group.
+
Note: For filtering, there are more configuration settings available.
+See Setting filtering options.
+
+
(Optional) In the Definition dialog, do any of the following modifications
+and click OK to return to the Rules dialog.
+
+
Enter a name for the rule.
+
Select rule type, either Text rule and Component / Group rule
+.
+
Text rule: type in the text to be matched with each trace.
+
Component / Group rule: type in the component name and/or group
+IDs from where you want traces to be found. You can use the asterisk * as
+a wildcard character for any component or group.
+
For text rules, select Match case to make the trace text be in
+the same case as with the rule.
+
+
+
Example: The following figure shows the Color Definition dialog.
+
+
When rules are created and they are listed in the dialog, select the ones
+you want to enable.
+
To save your changes, click OK.
+
+
+
Tip: If you close TraceViewer when you have any
+of the rules (color, filter, line count, variable tracing) enabled, they will
+get automatically enabled the next time you start TraceViewer.
