[orca] Make braille "word wrap" feature configurable via GUI

[Joanmarie Diggs <joanied src gnome org>]

commit ad2bbe2d10b64defc7dce974202e9841b6902116
Author: Joanmarie Diggs <jdiggs igalia com>
Date:   Tue Feb 6 09:20:22 2018 -0500

    Make braille "word wrap" feature configurable via GUI

 help/C/preferences_braille.page |   12 ++++++++++
 src/orca/orca-setup.ui          |   45 ++++++++++++++++++++++++++-------------
 src/orca/orca_gui_prefs.py      |    3 ++
 src/orca/settings.py            |    3 +-
 4 files changed, 47 insertions(+), 16 deletions(-)
---
diff --git a/help/C/preferences_braille.page b/help/C/preferences_braille.page
index e8543e8..74b7ced 100644
--- a/help/C/preferences_braille.page
+++ b/help/C/preferences_braille.page
@@ -34,6 +34,18 @@
       </p>
     </note>
   </section>
+  <section id="braillewordwrap">
+    <title>Enable word wrap</title>
+    <p>
+      If <gui>Enable word wrap</gui> is checked, <app>Orca</app> will adjust the
+      text so that only full words are shown on the braille display. If it is not
+      checked, <app>Orca</app> will use all of the cells on the display so that
+      more text can be shown at once.
+    </p>
+    <p>
+      Default value: not checked
+    </p>
+  </section>
   <section id="contractedbraille">
     <title>Enable Contracted Braille</title>
     <p>
diff --git a/src/orca/orca-setup.ui b/src/orca/orca-setup.ui
index cf88c35..9995f20 100644
--- a/src/orca/orca-setup.ui
+++ b/src/orca/orca-setup.ui
@@ -2072,21 +2072,6 @@
                                   </packing>
                                 </child>
                                 <child>
-                                  <object class="GtkCheckButton" id="contractedBrailleCheckButton">
-                                    <property name="label" translatable="yes">_Enable Contracted 
Braille</property>
-                                    <property name="visible">True</property>
-                                    <property name="can_focus">True</property>
-                                    <property name="receives_default">False</property>
-                                    <property name="use_underline">True</property>
-                                    <property name="draw_indicator">True</property>
-                                    <signal name="toggled" handler="contractedBrailleToggled" swapped="no"/>
-                                  </object>
-                                  <packing>
-                                    <property name="left_attach">0</property>
-                                    <property name="top_attach">2</property>
-                                  </packing>
-                                </child>
-                                <child>
                                   <object class="GtkGrid" id="contractionTableGrid">
                                     <property name="visible">True</property>
                                     <property name="can_focus">False</property>
@@ -2123,9 +2108,39 @@
                                   </object>
                                   <packing>
                                     <property name="left_attach">0</property>
+                                    <property name="top_attach">4</property>
+                                  </packing>
+                                </child>
+                                <child>
+                                  <object class="GtkCheckButton" id="contractedBrailleCheckButton">
+                                    <property name="label" translatable="yes">_Enable Contracted 
Braille</property>
+                                    <property name="visible">True</property>
+                                    <property name="can_focus">True</property>
+                                    <property name="receives_default">False</property>
+                                    <property name="use_underline">True</property>
+                                    <property name="draw_indicator">True</property>
+                                    <signal name="toggled" handler="contractedBrailleToggled" swapped="no"/>
+                                  </object>
+                                  <packing>
+                                    <property name="left_attach">0</property>
                                     <property name="top_attach">3</property>
                                   </packing>
                                 </child>
+                                <child>
+                                  <object class="GtkCheckButton" id="enableBrailleWordWrapCheckButton">
+                                    <property name="label" translatable="yes" comments="Translators: If this 
option is enabled, Orca will adjust the text shown on the braille display so that only full words are shown. 
If it is not enabled, Orca uses all of the cells on the display, but some words might not be fully shown 
requiring the user to scroll to see the remainder.">Enable _word wrap</property>
+                                    <property name="visible">True</property>
+                                    <property name="can_focus">True</property>
+                                    <property name="receives_default">False</property>
+                                    <property name="use_underline">True</property>
+                                    <property name="draw_indicator">True</property>
+                                    <signal name="toggled" handler="checkButtonToggled" swapped="no"/>
+                                  </object>
+                                  <packing>
+                                    <property name="left_attach">0</property>
+                                    <property name="top_attach">2</property>
+                                  </packing>
+                                </child>
                               </object>
                             </child>
                           </object>
diff --git a/src/orca/orca_gui_prefs.py b/src/orca/orca_gui_prefs.py
index 24ba2f4..a9c4aa1 100644
--- a/src/orca/orca_gui_prefs.py
+++ b/src/orca/orca_gui_prefs.py
@@ -1523,6 +1523,9 @@ class OrcaSetupGUI(orca_gtkbuilder.GtkBuilderWrapper):
         else:
             self.get_widget("brailleVerboseButton").set_active(True)
 
+        self.get_widget("enableBrailleWordWrapCheckButton").set_active(
+            prefs.get("enableBrailleWordWrap", settings.speakContextPanel))
+
         selectionIndicator = prefs["brailleSelectorIndicator"]
         if selectionIndicator == settings.BRAILLE_UNDERLINE_7:
             self.get_widget("brailleSelection7Button").set_active(True)
diff --git a/src/orca/settings.py b/src/orca/settings.py
index 4687d2c..895b5b8 100644
--- a/src/orca/settings.py
+++ b/src/orca/settings.py
@@ -93,6 +93,7 @@ userCustomizableSettings = [
     "progressBarUpdateInterval",
     "progressBarVerbosity",
     "ignoreStatusBarProgressBars",
+    "enableBrailleWordWrap",
     "enableContractedBraille",
     "brailleContractionTable",
     "enableMouseReview",
@@ -262,6 +263,7 @@ enableFlashMessages            = True
 brailleFlashTime               = 5000
 flashIsPersistent              = False
 flashIsDetailed                = True
+enableBrailleWordWrap          = False
 enableContractedBraille        = False
 brailleContractionTable        = ''
 disableBrailleEOL              = False
@@ -399,4 +401,3 @@ structNavInSayAll = False
 # N.B. The following are experimental and may change or go away at any time.
 enableSadPidginHack = False
 presentChatRoomLast = False
-enableBrailleWordWrap = False