Repository: nvaccess/nvda

Issue:
Input gesture name for NVDA+b command is not obvious
<!--
Please thoroughly read NVDA's wiki article on how to fill in this template, including how to provide the required files.
Issues may be closed if the required information is not present.
https://github.com/nvaccess/nvda/wiki/Github-issue-template-explanation-and-examples
-->

### Is your feature request related to a problem? Please describe.

A user asked what the command was called that was invoked with NVDA+b as they could not find it in the Input Gestures dialog.

In the User guide, it is listed as:
Name: Read active window
Description: reads all the controls in the currently active window (useful for dialogs)

In the Input Gestures dialog, it is "Speaks the current foreground object".

### Describe the solution you'd like

Change the description in the Input Gestures dialog to something like "Reads active window" or "Reads all controls in the active window".

Aside from anything else, the current name is not actually correct as it does read the whole active window and not the active object (open WINVER, leave the focus on the OK button and press NVDA+B - it reads the dialog even though the active object, is that OK button).


### Describe alternatives you've considered

### Additional context



Discussion:
> A user asked what the command was called that was invoked with NVDA+b as they could not find it in the Input Gestures dialog.

This user could be, as #10302 is not (yet) implemented, advised to use the Input Help to obtain the name of the command bound to any key.

Besides, I agree the naming of this command might be confusing.
Good point - I did mention that to the user (as well as the exact wording to search for).

Just for anyone else - the wording of a command in the input gesture dialog is the same as that used when you press a keystroke which invokes that command with Input help on.
This has come up before. I find this feature very illuminating. It seems to 
be able to at least indicate text on the screen and read it in situations 
where none of the navigation modes seem to be able to get at it. This is a 
pity because some very non standard applications operate some unmarked 
options just by clicking on text which is not apparently active. The latest 
Klite codec pack installer is like this. The only way to be sure these bits 
of software can be used is let a sighted person do it.
 Brian

bglists@blueyonder.co.uk
Sent via blueyonder.
Please address personal E-mail to:-
briang1@blueyonder.co.uk, putting 'Brian Gaff'
in the display name field.
Newsgroup monitored: alt.comp.blind-users 



Resolving patch:
diff --git a/source/globalCommands.py b/source/globalCommands.py
--- a/source/globalCommands.py
+++ b/source/globalCommands.py
@@ -1591,7 +1591,7 @@ def script_speakForeground(self,gesture):
 		if obj:
 			sayAllHandler.readObjects(obj)
 	# Translators: Input help mode message for read foreground object command (usually the foreground window).
-	script_speakForeground.__doc__ = _("Speaks the current foreground object")
+	script_speakForeground.__doc__ = _("Reads all controls in the active window")
 	script_speakForeground.category=SCRCAT_FOCUS
 
 	def script_test_navigatorDisplayModelText(self,gesture):
@@ -1894,8 +1894,11 @@ def script_revertConfiguration(self,gesture):
 			gui.mainFrame.onRevertToSavedConfigurationCommand(None)
 		elif scriptCount==2:
 			gui.mainFrame.onRevertToDefaultConfigurationCommand(None)
-	# Translators: Input help mode message for apply last saved or default settings command.
-	script_revertConfiguration.__doc__ = _("Pressing once reverts the current configuration to the most recently saved state. Pressing three times reverts to factory defaults.")
+	script_revertConfiguration.__doc__ = _(
+		# Translators: Input help mode message for apply last saved or default settings command.
+		"Pressing once reverts the current configuration to the most recently saved state."
+		" Pressing three times resets to factory defaults."
+	)
 	script_revertConfiguration.category=SCRCAT_CONFIG
 
 	def script_activatePythonConsole(self,gesture):


Test patch: