File: chapter.gui.preferences.html

package info (click to toggle)
covered 0.7.10-3.1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 8,916 kB
  • sloc: ansic: 48,807; yacc: 11,650; xml: 8,838; tcl: 7,698; sh: 3,925; lex: 2,240; makefile: 360; perl: 329
file content (204 lines) | stat: -rw-r--r-- 30,437 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter28.Navigating the Preferences Window</title><link rel="stylesheet" href="covered.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.71.1"><link rel="start" href="index.html" title="Covered User's Guide - 0.7.9"><link rel="up" href="part.gui.html" title="PartIV.Graphical User Interface"><link rel="prev" href="chapter.gui.rank.html" title="Chapter27.Creating a CDD Ranking Report"><link rel="next" href="chapter.gui.exclude.html" title="Chapter29.The Exclusion Reason Popup Window"><center><img src="img/banner.jpg"></center><hr></head><body bgcolor="#dfeef8" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter28.Navigating the Preferences Window</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="chapter.gui.rank.html"><img src="img/prev.gif" alt="Prev"></a></td><th width="60%" align="center">PartIV.Graphical User Interface</th><td width="20%" align="right"><a accesskey="n" href="chapter.gui.exclude.html"><img src="img/next.gif" alt="Next"></a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="chapter.gui.preferences"></a>Chapter28.Navigating the Preferences Window</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.categories">28.1. Option Categories</a></span></dt><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.buttons">28.2. Preference Buttons</a></span></dt><dd><dl><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.buttons.apply">Apply Button</a></span></dt><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.buttons.ok">OK Button</a></span></dt><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.buttons.cancel">Cancel Button</a></span></dt><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.buttons.help">Help (?) Button</a></span></dt></dl></dd><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.configfile">28.3. Preferences Configuration File</a></span></dt><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.general">28.4. Preferences General Pane</a></span></dt><dd><dl><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.general.wizard">Show wizard window on startup</a></span></dt><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.general.state">Save state of GUI when exiting the application</a></span></dt><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.general.tooltips">Show tooltips</a></span></dt></dl></dd><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.color">28.5. Preferences Color Pane</a></span></dt><dd><dl><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.color.set">Set Highlight Color</a></span></dt></dl></dd><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.goals">28.6. Preference Coverage Goals Pane</a></span></dt><dd><dl><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.goals.acceptable">Set Acceptable Coverage Goals Frame</a></span></dt></dl></dd><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.syntax">28.7. Preferences Syntax Highlighting Pane</a></span></dt><dd><dl><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.syntax.highlighting">Set Syntax Highlighting Options</a></span></dt></dl></dd><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.exclude">28.8. Preferences Exclusion Pane</a></span></dt><dd><dl><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.exclude.enable">Enable exclusion reason support when items are excluded</a></span></dt><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.exclude.genreasons">Create General Exclusion Reasons</a></span></dt></dl></dd><dt><span class="sect1"><a href="chapter.gui.preferences.html#section.gui.pref.merging">28.9. Preference Merging Pane</a></span></dt><dd><dl><dt><span class="sect2"><a href="chapter.gui.preferences.html#section.gui.pref.merging.er">Exclusion Reason Conflict Resolution Frame</a></span></dt></dl></dd></dl></div><p>
    The preferences window allows the user to adjust the view of some of the GUI elements for the purpose of more easily 
    analyzing coverage information for a specific user. <a href="chapter.gui.preferences.html#figure.gui.pref.main" title="Figure28.1.Main Preferences Window">Figure28.1, &#8220;Main Preferences Window&#8221;</a> shows the preferences 
    window that is created when the user selects the <span class="bold"><strong><code class="code">View &gt; Preferences...</code></strong></span> menu option 
    from the main window.
  </p><p>
    </p><div class="figure"><a name="figure.gui.pref.main"></a><p class="title"><b>Figure28.1.Main Preferences Window</b></p><div class="figure-contents"><div class="mediaobject"><img src="img/pref_main.gif" alt="Main Preferences Window"></div></div></div><p><br class="figure-break">
  </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.categories"></a>28.1.Option Categories</h2></div></div></div><p>
      On the left side of the preferences window is a list of option categories that can be modified. Selecting any one 
      of the items in the listbox will display the modifiable options to the frame to the right of the listbox. The 
      following option categories exist:
    </p><p>
      </p><div class="itemizedlist"><ul type="disc"><li><p><a href="chapter.gui.preferences.html#section.gui.pref.general" title="28.4.Preferences General Pane">Section28.4, &#8220;Preferences General Pane&#8221;</a></p></li><li><p><a href="chapter.gui.preferences.html#section.gui.pref.color" title="28.5.Preferences Color Pane">Section28.5, &#8220;Preferences Color Pane&#8221;</a></p></li><li><p><a href="chapter.gui.preferences.html#section.gui.pref.goals" title="28.6.Preference Coverage Goals Pane">Section28.6, &#8220;Preference Coverage Goals Pane&#8221;</a></p></li><li><p><a href="chapter.gui.preferences.html#section.gui.pref.syntax" title="28.7.Preferences Syntax Highlighting Pane">Section28.7, &#8220;Preferences Syntax Highlighting Pane&#8221;</a></p></li><li><p><a href="chapter.gui.preferences.html#section.gui.pref.exclude" title="28.8.Preferences Exclusion Pane">Section28.8, &#8220;Preferences Exclusion Pane&#8221;</a></p></li><li><p><a href="chapter.gui.preferences.html#section.gui.pref.merging" title="28.9.Preference Merging Pane">Section28.9, &#8220;Preference Merging Pane&#8221;</a></p></li></ul></div><p>
    </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.buttons"></a>28.2.Preference Buttons</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.buttons.apply"></a>Apply Button</h3></div></div></div><p>
        Clicking on the <span class="bold"><strong>Apply</strong></span> button will cause the currently selected preference 
        options to be immediately updated in Covered but will not update the preference option values in the .coveredrc 
        file.  This has the effect of changing the preferences for the current application only. Clicking on this button 
        will not close the Preferences window.
      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.buttons.ok"></a>OK Button</h3></div></div></div><p>
        Clicking on the <span class="bold"><strong>OK</strong></span> button will cause the currently selected preference options 
        to be immediately updated in Covered and will update the .coveredrc file with the new values. This also causes 
        the Preferences window to close.
      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.buttons.cancel"></a>Cancel Button</h3></div></div></div><p>
        Clicking on the <span class="bold"><strong>Cancel</strong></span> button will cause the the Preferences window to close 
        without updating Covered with the currently selected values and without updating the .coveredrc file.
      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.buttons.help"></a>Help (?) Button</h3></div></div></div><p>
        Clicking on the help (?) button will cause the help page for the currently selected'Option Category' to be
        displayed.
      </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.configfile"></a>28.3.Preferences Configuration File</h2></div></div></div><p>
      User preferences are loaded from the ".coveredrc" file that is searched for in the following order:
    </p><p>
      </p><div class="orderedlist"><ol type="1"><li><p>Current directory that the 'covered report -view' command was executed from.</p></li><li><p>The user's home directory.</p></li><li><p>The installation directory (by default this is /usr/local/share/covered).</p></li></ol></div><p>
    </p><p>
      If user preferences are changed in this window and the <span class="bold"><strong>OK</strong></span> button is pressed, the 
      settings are immediately saved back to a configuration file and the GUI is immediately updated to reflect the new 
      user changes.  If the <span class="bold"><strong>Cancel</strong></span> button is pressed, all changes are thrown away and 
      the configuration file remains unchanged. The location of the stored configuration file depends on which 
      configuration file location was initially loaded. The following table describes this correlation.
    </p><p>
      </p><div class="table"><a name="table.gui.pref.coveredrc"></a><p class="title"><b>Table28.1.Location of Written .coveredrc File According to the Location of Read .coveredrc File</b></p><div class="table-contents"><table summary="Location of Written .coveredrc File According to the Location of Read .coveredrc File" border="1"><colgroup><col><col></colgroup><thead><tr><th>Loaded config file location</th><th>Stored config file location</th></tr></thead><tbody><tr><td>Current directory</td><td>Current directory</td></tr><tr><td>Home directory</td><td>Home directory</td></tr><tr><td>Install directory</td><td>Current directory</td></tr><tr><td>None found</td><td>Current directory</td></tr></tbody></table></div></div><p><br class="table-break">
    </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.general"></a>28.4.Preferences General Pane</h2></div></div></div><p>
      The general preferences pane allows the user to control Covered's settings that are not specific to an individual
      task.  The following subsections describe the controls available within this pane.
    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.general.wizard"></a>Show wizard window on startup</h3></div></div></div><p>
        This checkbutton selects if Covered's <a href="chapter.gui.wizard.html" title="Chapter30.Navigating the Wizard Window">wizard</a> popup window will be displayed upon
        starting Covered.  Simply check this button if you would like to see the wizard at the beginning of each startup
        or uncheck it to cause the wizard window to not be displayed on startup. On the wizard window itself, there is
        an option to change this behavior as well.
      </p><p>
        Note that you can always display the wizard window by selecting its menu option in the 
        <a href="chapter.gui.main.html#section.gui.main.viewmenu" title="The View Menu">view</a> menu.
      </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.general.state"></a>Save state of GUI when exiting the application</h3></div></div></div><p>
       This checkbutton determines if certain GUI element (i.e., window placement/sizing, module/instance listbox 
       column arrangement/width/state, etc.) information is saved when the GUI exits.  If this checkbutton is selected,
       the state is saved to the configuration file on application exit and will be used when the application is started.
       If the checkbutton is deselected, the state will not be saved and the default GUI element behaviors will be used.
     </p><p>
       This setting allows the user to setup the various GUI elements to their liking and retains this information whenever
       the application is restarted, saving the user the hassle of getting the environment setup again.
     </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/note.gif"></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
       While the application is being used, any GUI state information will be remembered for the duration of the application
       run, regardless of the setting of this preference item.
     </td></tr></table></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.general.tooltips"></a>Show tooltips</h3></div></div></div><p>
        This checkbutton specifies if GUI widget tooltips should be displayed if the user hovers the cursor over a GUI element
        that has a tooltip associated with it.  To disable tooltips from being used, uncheck this option and click either the
        <span class="bold"><strong>Apply</strong></span> or <span class="bold"><strong>OK</strong></span> buttons.
      </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.color"></a>28.5.Preferences Color Pane</h2></div></div></div><p>
      The color preference pane allows the user to adjust the foreground and background colors for all code that is 
      considered covered, uncovered, or in a race condition state.
    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.color.set"></a>Set Highlight Color</h3></div></div></div><p>
        This frame contains six buttons that affect the foreground and background colors used to highlight code in the 
        <a href="chapter.gui.main.html#section.gui.main.viewer" title="17.4.The Coverage File Viewer">file viewer</a> portion of the main window. The currently selected foreground/background 
        colors are displayed to the left of the corresponding buttons to allow the user to see the selections prior to 
        committing to them by clicking the <span class="bold"><strong>Apply</strong></span> or <span class="bold"><strong>OK</strong></span> 
        buttons at the bottom of the Preferences window.
      </p><p>
        The "F" button controls the foreground color while the "B" button controls the background color.  Clicking one
        of these buttons will bring up a color selection window that you can use to modify the current color to one of
        your choosing.
      </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.goals"></a>28.6.Preference Coverage Goals Pane</h2></div></div></div><p>
      The coverage goals preference pane allows the user to change the acceptable coverage goals for each coverage metric.
    </p><p>
      </p><div class="figure"><a name="figure.gui.pref.goals"></a><p class="title"><b>Figure28.2.Coverage Goals Window</b></p><div class="figure-contents"><div class="mediaobject"><img src="img/pref_goals.gif" alt="Coverage Goals Window"></div></div></div><p><br class="figure-break">
    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.goals.acceptable"></a>Set Acceptable Coverage Goals Frame</h3></div></div></div><p>
        This frame contains four spinner boxes that contains values between 0 and 100. These values correspond to a 
        coverage percentage for each coverage metric that the user deems to be "good enough". These values are used by 
        the <a href="chapter.gui.main.html#section.gui.main.listbox" title="17.3.The Module/Instance Listbox">listbox</a> to help visually identify modules/instances that are meeting or 
        exceeding these goals and which modules are not meeting these goals. If a coverage percentage for a 
        module/instance is less than this value, the module is colored red. If the coverage percentage is greater than or 
        equal to this value, the module/instance is colored yellow (or green which indicates that the module/instance 
        reached 100% coverage for a given metric).
      </p><p>
        To increase the specified percentage value, simply click on the "Up" button to the right of the percentage until 
        the desired value is displayed. To decrease the specified percentage value, simply click on the "down" button to 
        the right of the percentage until the desired value is displayed.
      </p><p>
        </p><div class="itemizedlist"><ul type="disc"><li><p><span class="bold"><strong>Line Coverage %</strong></span></p><p>
              Sets the coverage goal of line coverage to the specified percentage to the right. If line coverage for a 
              given module/instance meets or exceeds this percentage value, it will be displayed yellow in the 
              Module/Instance listbox on the Main window.
            </p></li><li><p><span class="bold"><strong>Toggle Coverage %</strong></span></p><p>
              Sets the coverage goal of toggle coverage to the specified percentage to the right. If toggle coverage for 
              a given module/instance meets or exceeds this percentage value, it will be displayed yellow in the 
              Module/Instance listbox on the Main window.
            </p></li><li><p><span class="bold"><strong>Memory Coverage %</strong></span></p><p>
              Sets the coverage goal of memory coverage to the specified percentage to the right. If memory coverage for 
              a given module/instance meets or exceeds this percentage value, it will be displayed yellow in the 
              Module/Instance listbox on the Main window.
            </p></li><li><p><span class="bold"><strong>Combinational Logic Coverage %</strong></span></p><p>
              Sets the coverage goal of combinational coverage to the specified percentage to the right. If combinational 
              logic coverage for a given module/instance meets or exceeds this percentage value, it will be displayed 
              yellow in the Module/Instance listbox on the Main window.
            </p></li><li><p><span class="bold"><strong>FSM State/Arc Coverage %</strong></span></p><p>
              Sets the coverage goal of FSM state/arc coverage to the specified percentage to the right. If FSM state/arc 
              coverage for a given module/instance meets or exceeds this percentage value, it will be displayed yellow in 
              the Module/Instance listbox on the Main window.
            </p></li><li><p><span class="bold"><strong>Assertion Coverage %</strong></span></p><p>
              Sets the coverage goal of assertion coverage to the specified percentage to the right. If assertion 
              coverage for a given module/instance meets or exceeds this percentage value, it will be displayed yellow in 
              the Module/Instance listbox on the Main window.
            </p></li></ul></div><p>
      </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.syntax"></a>28.7.Preferences Syntax Highlighting Pane</h2></div></div></div><p>
      The syntax highlighting preferences pane allows the user to adjust the syntax highlighting mode and colors for any 
      displayed Verilog source code.
    </p><p>
      </p><div class="figure"><a name="figure.gui.pref.syntax"></a><p class="title"><b>Figure28.3.Syntax Highlighting Preferences Pane</b></p><div class="figure-contents"><div class="mediaobject"><img src="img/pref_syntax.gif" alt="Syntax Highlighting Preferences Pane"></div></div></div><p><br class="figure-break">
    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.syntax.highlighting"></a>Set Syntax Highlighting Options</h3></div></div></div><p>
        This frame allows the user to specify if syntax highlighting should be performed in all Verilog source viewers or 
        not. When the square to the left of the <span class="bold"><strong>Turn on syntax highlighting mode</strong></span> is 
        selected, syntax highlighting will occur; otherwise, it will not perform syntax highlighting. The various colored 
        buttons below the selection mode allow the user to select the foreground color of the text associated with its 
        specified syntax type (Comments, Preprocessor Keywords, Verilog Keywords, Strings, Constant Values, and Operation 
        Symbols). Simply click on one of the buttons to change its color. Doing so will cause a color selection window 
        (see <a href="chapter.gui.preferences.html#figure.gui.pref.syntax" title="Figure28.3.Syntax Highlighting Preferences Pane">Figure28.3, &#8220;Syntax Highlighting Preferences Pane&#8221;</a> above) to be displayed.
      </p><p>
        If the syntax highlighting mode is disabled by the user, the color selection buttons will be disabled.
      </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.exclude"></a>28.8.Preferences Exclusion Pane</h2></div></div></div><p>
      The exclude preferences pane allows the user to control whether or not the coverage exclusion reason window
      automatically pops up when a coverage point is excluded, and it allows the user to create some general purpose
      exclusion reasons.  The reasons created in this pane can be selected in the exclusion reason window's drop-down
      table and can help to expedite the exclusion process when many coverage points are being excluded for the same
      reason.  <a href="chapter.gui.preferences.html#figure.gui.pref.exclude" title="Figure28.4.Exclusion Preferences Pane">Figure28.4, &#8220;Exclusion Preferences Pane&#8221;</a> shows the layout of this preference pane.
    </p><p>
      </p><div class="figure"><a name="figure.gui.pref.exclude"></a><p class="title"><b>Figure28.4.Exclusion Preferences Pane</b></p><div class="figure-contents"><div class="mediaobject"><img src="img/pref_exclude.gif" alt="Exclusion Preferences Pane"></div></div></div><p><br class="figure-break">
    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.exclude.enable"></a>Enable exclusion reason support when items are excluded</h3></div></div></div><p>
        If this option is enabled, whenever the user clicks on a coverage point to cause it to be excluded from
        coverage, a popup window will be displayed, allowing for an exclusion message to be associated with the
        excluded coverage point.
      </p><p>
        If this option is not enabled, the coverage point will still be excluded but no exclusion message will
        be associated with it.
      </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/note.gif"></td><th align="left">Note</th></tr><tr><td align="left" valign="top">
        If a coverage point was excluded and is selected to be included and the coverage point had an exclusion
        message associated with it, the exclusion message will be forgotten/deleted.
      </td></tr></table></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.exclude.genreasons"></a>Create General Exclusion Reasons</h3></div></div></div><p>
        This frame allows the user to add/delete general purpose exclusion reasons that can be selected from within
        the <a href="chapter.gui.exclude.html" title="Chapter29.The Exclusion Reason Popup Window">exclusion reason popup window's</a> drop-down table.  Having these 
        reasons specified can help to speed up coverage point exclusion when multiple coverage points need to be 
        excluded for the same reason.
      </p><p>
        To add a new general purpose exclusion reason, simply type in the general purpose exclusion reason in the
        bottom textbox (note that any formatting characters such as newlines, tabs, extra spaces will be removed
        from the exclusion message) and click the "+" button.  You will see the exclusion reason get added to the
        table when this occurs.  Note that the "+" button will only be enabled when you have entered at least one
        character in the textbox.
      </p><p>
        To remove a general purpose exclusion reason from the table, simply click on the reason in the table and
        click the "-" button.  Note that the "-" button will only be enabled once an entry has been selected in
        the table.
      </p><p>
        To help find an exclusion reason more easily within the exclusion reason popup window, you may also rearrange
        the order of the exclusions within the table by simply clicking on an entry and dragging it to the desired
        location.  The order of the exclusion reasons specified in this table will be the initial order of the
        exclusion reasons in the popup window.
      </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.gui.pref.merging"></a>28.9.Preference Merging Pane</h2></div></div></div><p>
      The merging pane is needed to specify to Covered how to resolve conflicts that are found when merging CDD
      files.  Although coverage points and exclusions are simply merged (ORed) together, things such as exclusion
      reasons can exist for the same coverage point but contain different information.  When two exclusion reasons
      are given for the same coverage point, Covered must decide how to resolve this information and this preference
      pane allows the user to set what this behavior will be.
    </p><p>
      </p><div class="figure"><a name="figure.gui.pref.merging"></a><p class="title"><b>Figure28.5.Merging Preferences Pane</b></p><div class="figure-contents"><div class="mediaobject"><img src="img/pref_merge.gif" alt="Merging Preferences Pane"></div></div></div><p><br class="figure-break">
    </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.gui.pref.merging.er"></a>Exclusion Reason Conflict Resolution Frame</h3></div></div></div><p>
        This frame allows the user to specify the way in which exclusion reason conflicts should be resolved.  The
        following options are provided:
      </p><p>
        </p><div class="itemizedlist"><ul type="disc"><li><p><span class="bold"><strong>Use the first reason</strong></span></p><p>
              Specifies if two or more exclusion reasons are found for the same coverage point, Covered should use
              the exclusion reason found in the first CDD file merged.  The rest of the exclusion reasons are thrown away.
            </p></li><li><p><span class="bold"><strong>Use the last reason</strong></span></p><p>
              Specifies if two or more exclusion reasons are found for the same coverage point, Covered should use
              the exclusion reason found in the last CDD file merged.  The rest of the exclusion reasons are thrown away.
            </p></li><li><p><span class="bold"><strong>Use the newest reason</strong></span></p><p>
              Specifies if two or more exclusion reasons are found for the same coverage point, Covered should use
              the newest exclusion reason (when an exclusion is created, a timestamp is saved along with the
              coverage reason).  The rest of the exclusion reasons are thrown away.
            </p></li><li><p><span class="bold"><strong>Use the oldest reason</strong></span></p><p>
              Specifies if two or more exclusion reasons are found for the same coverage point, Covered should use
              the oldest exclusion reason.  The rest of the exclusion reasons are thrown away.
            </p></li><li><p><span class="bold"><strong>Merge all reasons</strong></span></p><p>
              Specifies if two or more exclusion reasons are found for the same coverage point, Covered should
              merge all of them.  No information is lost in this case.
            </p></li></ul></div><p>
      </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="chapter.gui.rank.html"><img src="img/prev.gif" alt="Prev"></a></td><td width="20%" align="center"><a accesskey="u" href="part.gui.html"><img src="img/up.gif" alt="Up"></a></td><td width="40%" align="right"><a accesskey="n" href="chapter.gui.exclude.html"><img src="img/next.gif" alt="Next"></a></td></tr><tr><td width="40%" align="left" valign="top">Chapter27.Creating a CDD Ranking Report</td><td width="20%" align="center"><a accesskey="h" href="index.html"><img src="img/home.gif" alt="Home"></a></td><td width="40%" align="right" valign="top">Chapter29.The Exclusion Reason Popup Window</td></tr></table></div></body></html>