User guide: document auto-suggestions notification setting. re nvacce…

…ss#6241. In the user guide, an explanatory text has been added to describe what auto-suggestions are.
josephsl · Jan 19, 2017 · 6e0a27b · 6e0a27b
1 parent d774f1b
commit 6e0a27b
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 1 deletion.
diff --git a/source/gui/settingsDialogs.py b/source/gui/settingsDialogs.py
@@ -967,7 +967,7 @@ def makeSettings(self, settingsSizer):
 
 		# Translators: This is the label for a combobox in the
 		# object presentation settings dialog.
-		autoSuggestionsLabelText = _("Report &auto-suggestions:")
+		autoSuggestionsLabelText = _("&Auto-suggestions notification:")
 		autoSuggestionsChoices = [name for setting, name in self.autoSuggestionsLabels]
 		self.autoSuggestionsList=sHelper.addLabeledControl(autoSuggestionsLabelText, wx.Choice,choices=autoSuggestionsChoices)
 		for index, (setting, name) in enumerate(self.autoSuggestionsLabels):

diff --git a/user_docs/en/userGuide.t2t b/user_docs/en/userGuide.t2t
@@ -1116,6 +1116,19 @@ Key: NVDA+5
 
 Toggles the announcement of new content in particular objects such as terminals and the history control in chat programs.
 
+==== Auto-suggestions notification ====
+This option allows you to configure how NVDA will notify you of appearance of auto-suggestions.
+Auto-suggestions are lists of suggested entries based on text entered into certain edit fields and documents.
+For example, when you enter text into the search box in Start menu in Windows Vista and later, Windows displays a list of suggestions based on what you typed.
+For some edit fields such as search fields in various Windows 10 apps, NVDA can notify you that a list of suggestions has appeared when you type text.
+The auto-suggestions list will close once you move away from the edit field, and for some fields, NVDA can notify you of this when this happens.
+
+The ways in which NVDA can notify you of appearance of auto-suggestions are:
+- Off: Appearance of suggestions will not be announced.
+- Message: NVDA will speak or braille a message when suggestions appear.
+- Sound: NVDA will play a sound when suggestions appear.
+-
+
 +++ Input Composition Settings +++
 The Input Composition Settings dialog can be found under the Preferences menu.
 This dialog allows you to control how NVDA reports the input of Asian characters, such as with IME or Text Service input methods.