summaryrefslogtreecommitdiffstats
path: root/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmnotify/index.docbook
blob: 7ebe5b1ce1f846ba193c0a51eba3f38906e03523 (plain)
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
<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % British-English "INCLUDE"
> <!-- change language only here -->
]>

<article lang="&language;">
<articleinfo>

<authorgroup>
<author
>&Mike.McBride; &Mike.McBride.mail;</author>
<othercredit role="translator"
><firstname
>John</firstname
><surname
>Knight</surname
><affiliation
><address
><email
>[email protected]</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
> 
</authorgroup>

<date
>2002-02-12</date>
<releaseinfo
>3.00.00</releaseinfo>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KControl</keyword>
<keyword
>system notification</keyword>
<keyword
>notification</keyword>
</keywordset>
</articleinfo>

<sect1 id="sys-notify">
<title
>System Notification Settings</title>

<para
>&kde;, like all applications, needs to inform the user when a problem occurs, a task is completed, or something has happened. &kde; uses a set of <quote
>System Notifications</quote
> to keep the user informed on what is happening.</para>

<para
>Using this module, you can determine what &kde; does to communicate each event.</para>

<para
>The panel consists of a large list of specific events which need to be communicated to the user. This list is organised into a tree, so that you can rapidly find the notification you are looking for.</para>

<para
>To configure a notification, simply click on a group, which will open up a subgroup. You can click on subgroups, which may lead to more subgroups, or it may lead to a list of notifications.</para>

<para
>Once you have found the notification you are looking for, double-click on the notification.</para>

<para
>You will be presented with 4 options:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Log to file</guilabel
></term>
<listitem
><para
>This will tell &kde; to add the notification to the end of a file. Once you place a mark in front of this option, you can enter a filename at the bottom of the module. If you click on the <guiicon
>folder</guiicon
> to the right of the blank, you can browse through your filesystem and select the file you want.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Play sound</guilabel
></term>
<listitem
><para
>When this notification is activated, &kde; will play a sound. Once you place a mark in front of this option, you can enter a filename at the bottom of the module. </para>
<para
>If you click on the <guiicon
>folder</guiicon
> to the right of the blank, you can browse through your filesystem and select the file you want.</para>
<para
>By clicking the arrow button to the right of the <guiicon
>folder</guiicon
> button, you can hear the sound.</para>

<para
>Maybe you want to use a special media player to play sound files, &eg; because you use sound files in a special format or you don't use the &arts; sound daemon. In that case, check the <guilabel
>Use external player</guilabel
> option and enter the full path and name of the program you want to use into the text field.</para
></listitem>

</varlistentry>
<varlistentry>
<term
><guilabel
>Show messagebox</guilabel
></term>
<listitem
><para
>When this notification is activated, a message box appears in the middle of the screen to inform the user of the message.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Standard error output</guilabel
></term>
<listitem
><para
>When this notification is activated, the message is sent to the standard output.</para
></listitem>
</varlistentry>
</variablelist>
<tip
><para
>You are not limited to choosing one option, you can use any combination of these four options for each notification.</para
></tip>

<para
>You can turn off (or on) all sounds at once, for all installed applications, with the <guibutton
>Enable All Sounds</guibutton
> or <guibutton
>Disable All Sounds</guibutton
> Button. Which of these you see depends on the current status.</para>

</sect1>

</article>