Debian Codegraph @

help/C/howto_notifications.page

raw
1 <page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_notifications">
2 <info>
3 <link type="guide" xref="index#reviewing"/>
4 <title type="sort">5. Notifications</title>
5 <desc>Reading previously-received messages</desc>
6 <credit type="author">
7 <name>Joanmarie Diggs</name>
8 <email>[email protected]</email>
9 </credit>
10 <license>
11 <p>Creative Commons Share Alike 3.0</p>
12 </license>
13 </info>
14 <title>Notifications</title>
15 <p>
16 The GNOME Desktop includes a "notification area" which can be used by
17 applications to present information to the user. Examples of notifications
18 include incoming chat messages, the details associated with the song your
19 media player is starting to play, and warnings that your battery level is
20 getting low.
21 </p>
22 <p>
23 Because notifications are intended to present information to users without
24 interrupting what the user is doing, these messages tend to appear and
25 disappear relatively quickly. They are also not focusable. While
26 <app>Orca</app> will present these messages to you as they come in, it is
27 far too easy to interrupt <app>Orca</app>'s announcement accidentally by
28 continuing to type or to change focus. For this reason, <app>Orca</app> has
29 three commands which you can use to access previously-displayed notification
30 messages:
31 </p>
32 <list>
33 <item>
34 <p>Present the last (most recent) notification message</p>
35 </item>
36 <item>
37 <p>Present the previous notification message</p>
38 </item>
39 <item>
40 <p>Present list of all notification messages</p>
41 </item>
42 </list>
43 <p>
44 The first two commands are designed mainly for quick access to a message
45 you just received. The last command is the most powerful as it stores your
46 notification message history.
47 </p>
48 <p>
49 When you enter the list of notification messages, you will be told the size
50 of the list and prompted with the following choices:
51 </p>
52 <list>
53 <item><p>Press H for help.</p></item>
54 <item><p>Use Up, Down, Home or End to navigate in the list.</p></item>
55 <item><p>Press Escape to exit.</p></item>
56 <item><p>Press Space to repeat the last message read.</p></item>
57 <item><p>Press one digit to read a specific message.</p></item>
58 </list>
59 <p>
60 Note that the most recently-received message is at the top of the list.
61 </p>
62 <p>
63 Each of <app>Orca</app>'s notification review commands is unbound by
64 default. You can bind any or all of them to the shortcut or shortcuts
65 you choose. How to do so is described in the
66 <link xref="howto_key_bindings">Introduction to Key Bindings</link>.
67 </p>
68 </page>