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
205
206
|
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY kdebugdialog "<application
>KDebugDialog</application
>">
<!ENTITY kappname "&kdebugdialog;">
<!ENTITY % addindex "IGNORE">
<!ENTITY % British-English "INCLUDE"
> <!-- change language only here -->
]>
<book lang="&language;">
<bookinfo>
<title
>The &kdebugdialog; Handbook</title>
<authorgroup>
<author
>&David.Faure; &David.Faure.mail;</author>
<othercredit role="translator"
><firstname
>Malcolm</firstname
><surname
>Hunter</surname
><affiliation
><address
><email
>malcolm.hunter@gmx.co.uk</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
>
</authorgroup>
<date
>2001-02-13</date>
<releaseinfo
>0.03.00</releaseinfo>
<abstract>
<para
>This document describes &kdebugdialog;.</para>
</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>KDebugdialog</keyword>
</keywordset>
</bookinfo>
<chapter id="Introduction">
<title
>What is KDebugDialog?</title>
<para
>It is a dialogue box for managing diagnostic messages at runtime. </para>
<para
>If you simply start <command
>kdebugdialog</command
>, you will see a list of <quote
>areas</quote
>, that can be disabled or enabled. A <function
>kdDebug(area)</function
> call in the code will show something in the debug output only if the area is enabled.</para>
<note
><para
>Note that kdWarning, kdError and kdFatal always appear, they are NOT controlled by this setting. </para
></note>
<variablelist>
<varlistentry>
<term
><guilabel
>Area</guilabel
></term>
<listitem>
<para
>The areas which should only be output. Every message that is not mentioned here will simply not be output (unless this field remains empty, which is the default, and means that all messages should be output). You can enter several areas separated by commas here, and you can also use area ranges with the syntax start-end. Thus a valid entry could be: 117,214-289,356-359,221. Do not use whitespaces.</para>
</listitem>
</varlistentry>
</variablelist>
<para
>If you start <command
>kdebugdialog</command
> <option
>--fullmode</option
>, then for every severity level you can define separately what should be done with the diagnostic messages of that level, and the same for each debug area.</para>
<para
>In full mode, first you should select the debug area you are interested in from the drop down list at the top.</para>
<para
>You may independently set the output for various types of messages:</para>
<itemizedlist>
<listitem
><para
><guilabel
>Information</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Warning</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Error</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Fatal Error</guilabel
></para
></listitem>
</itemizedlist>
<para
>For each of these types, you can set the following:</para>
<variablelist>
<varlistentry>
<term
><guilabel
>Output to:</guilabel
></term>
<listitem>
<para
>In this Combobox, you can choose where the messages should be output. The choices are: <quote
>File</quote
>, <quote
>Message Box</quote
>, <quote
>Shell</quote
> (meaning stderr) and <quote
>Syslog</quote
>. Please do not direct fatal messages to syslog unless you are the system administrator yourself. The default is <quote
>Message Box</quote
>.</para
>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Filename:</guilabel
></term>
<listitem
><para
>This is only enabled when you have chosen <quote
>File</quote
> as the output and provides the name of that file (which is interpreted as relative to the current folder). The default is <filename
>kdebug.dbg</filename
>.</para>
</listitem>
</varlistentry>
</variablelist>
<para
>Apart from this, you can also tick the checkbox <guilabel
>Abort on fatal errors</guilabel
>. In this case, if a diagnostic message with the severity level <computeroutput
>KDEBUG_FATAL</computeroutput
> is output, the application aborts with a SIGABRT after outputting the message.</para>
<para
>When you close the dialogue by pressing <guibutton
>OK</guibutton
>, your entries apply immediately and are saved in <filename
>kdebugrc</filename
>. When you press <guibutton
>Cancel</guibutton
>, your entries are discarded and the old ones are restored.</para>
<para
>Credits to Kalle Dalheimer for the original version of &kdebugdialog;</para>
</chapter>
&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-general-insert-case: lower
sgml-shorttag: t
End:
-->
|
