[orca] Fix for bgo#585017 - Orca should speak the toggled state of flat review mode

[William Walker <wwalker src gnome org>]

commit 9fef54504017313c095203117e759c59e80d0e99
Author: Willie Walker <william walker sun com>
Date:   Sun Jun 7 05:30:53 2009 -0400

    Fix for bgo#585017 - Orca should speak the toggled state of flat review mode
    
    This change will speak whether flat review has been entered or exited
    when the user presses the toggle flat review mode command
---
 src/orca/default.py |   24 ++++++++++++++++++++++++
 1 files changed, 24 insertions(+), 0 deletions(-)

diff --git a/src/orca/default.py b/src/orca/default.py
index 9eb81a7..5a154cb 100644
--- a/src/orca/default.py
+++ b/src/orca/default.py
@@ -4598,10 +4598,34 @@ class Script(script.Script):
         """Toggles between flat review mode and focus tracking mode."""
 
         if self.flatReviewContext:
+            if inputEvent:
+                # Translators: the 'flat review' feature of Orca
+                # allows the blind user to explore the text in a
+                # window in a 2D fashion.  That is, Orca treats all
+                # the text from all objects in a window (e.g.,
+                # buttons, labels, etc.) as a sequence of words in a
+                # sequence of lines.  The flat review feature allows
+                # the user to explore this text by the {previous,next}
+                # {line,word,character}.  This message lets the user know
+                # they have left the flat review feature.
+                #
+                speech.speak(_("Leaving flat review."))
             self.drawOutline(-1, 0, 0, 0)
             self.flatReviewContext = None
             self.updateBraille(orca_state.locusOfFocus)
         else:
+            if inputEvent:
+                # Translators: the 'flat review' feature of Orca
+                # allows the blind user to explore the text in a
+                # window in a 2D fashion.  That is, Orca treats all
+                # the text from all objects in a window (e.g.,
+                # buttons, labels, etc.) as a sequence of words in a
+                # sequence of lines.  The flat review feature allows
+                # the user to explore this text by the {previous,next}
+                # {line,word,character}.  This message lets the user know
+                # they have entered the flat review feature.
+                #
+                speech.speak(_("Entering flat review."))
             context = self.getFlatReviewContext()
             [wordString, x, y, width, height] = \
                      context.getCurrent(flat_review.Context.WORD)