[orca] Make viewing Orca help in Yelp activatable via Learn Mode

[Joanmarie Diggs <joanied src gnome org>]

commit 0e5b2448eeb8c2e2ef908db1960723953b870b52
Author: Joanmarie Diggs <jdiggs igalia com>
Date:   Sat Dec 1 15:46:34 2012 -0500

    Make viewing Orca help in Yelp activatable via Learn Mode

 src/orca/orca.py            |    4 ++++
 src/orca/scripts/default.py |    2 ++
 2 files changed, 6 insertions(+), 0 deletions(-)
---
diff --git a/src/orca/orca.py b/src/orca/orca.py
index 9c850a2..3b210df 100644
--- a/src/orca/orca.py
+++ b/src/orca/orca.py
@@ -241,6 +241,10 @@ def _processKeyboardEvent(event):
     # Special modes.
     if not isPressedEvent and keyboardEvent.event_string == "Escape":
         script.exitLearnMode(keyboardEvent)
+    if orca_state.learnModeEnabled and keyboardEvent.event_string == "F1" \
+       and not keyboardEvent.modifiers:
+        orca_state.learnModeEnabled = False
+        return helpForOrca()
     if orca_state.capturingKeys:
         return False
     if orca_state.listShortcutsModeEnabled:
diff --git a/src/orca/scripts/default.py b/src/orca/scripts/default.py
index be5deda..b08380c 100644
--- a/src/orca/scripts/default.py
+++ b/src/orca/scripts/default.py
@@ -1558,6 +1558,8 @@ class Script(script.Script):
             # This text here is what is spoken to the user.
             #
             _("Entering learn mode.  Press any key to hear its function.  " \
+              "To get a list of Orca shortcuts, press the Orca modifier " \
+              "plus H twice quickly. To view the documentation, press F1. " \
               "To exit learn mode, press the escape key."))
 
         # Translators: Orca has a "Learn Mode" that will allow