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