Merge e8f9470 into 32a8613

seanbudd · web-flow · commit c64e806ed67e · 2023-12-21T00:04:31.000Z
diff --git a/projectDocs/dev/developerGuide/developerGuide.t2t b/projectDocs/dev/developerGuide/developerGuide.t2t
@@ -116,12 +116,13 @@ The fields are as follows:
 In most cases, this is just the character or characters of the symbol.
 However, it can also be the identifier of a complex symbol.
 Certain characters cannot be typed into the file, so the following special sequences can be used:
- - \0: null
- - \t: tab
- - \n: line feed
- - \r: carriage return
- - \f: form feed
- - \#: # character (needed because # at the start of a line denotes a comment)
+  - \0: null
+  - \t: tab
+  - \n: line feed
+  - \r: carriage return
+  - \f: form feed
+  - \#: # character (needed because # at the start of a line denotes a comment)
+  -
 - replacement: The text which should be spoken for the symbol.
 If the symbol is a complex symbol, \1, \2, etc. can be used to refer to the groups matches, which will be inlined in the replacement, allowing for simpler rules.
 This also means that to get a \ character in the replacement, one has to type \\.
@@ -133,12 +134,12 @@ The default is to inherit the value or "all" if there is nothing to inherit.
 - preserve: Whether the symbol itself should be preserved to facilitate correct pronunciation by the synthesiser.
 For example, symbols which cause pauses or inflection (such as the comma in English) should be preserved.
 This field should be one of the following:
- - never: Never preserve the symbol.
- - always: Always preserve the symbol.
- - norep: Only preserve the symbol if it is not being replaced; i.e. the user has set symbol level lower than the level of this symbol.
- - -: Use the default.
- -
-The default is to inherit the value or "never" if there is nothing to inherit.
+  - never: Never preserve the symbol.
+  - always: Always preserve the symbol.
+  - norep: Only preserve the symbol if it is not being replaced; i.e. the user has set symbol level lower than the level of this symbol.
+  - -: Use the default.
+  - The default is to inherit the value or "never" if there is nothing to inherit.
+  -
 -
 Finally, a display name for the symbol can be provided in a comment after a tab at the end of the line.
 This will be shown to users when editing the symbol information and is especially useful for translators to define translated names for English complex symbols.
diff --git a/user_docs/en/changes.t2t b/user_docs/en/changes.t2t
@@ -2205,7 +2205,7 @@ Highlights of this release include auto detection of Freedom Scientific braille
 
 == Changes for Developers ==
 - You can now set the "disableBrowseModeByDefault" property on app modules to leave browse mode off by default. (#8846)
-- The extended window style of a window is now exposed using the `extendedWindowStyle` property on Window objects and their derivatives. (#9136)
+- The extended window style of a window is now exposed using the ``extendedWindowStyle`` property on Window objects and their derivatives. (#9136)
 - Updated comtypes package to 1.1.7. (#9440, #8522)
 - When using the report module info command, the order of information has changed to present the module first. (#7338)
 - Added an example to demonstrate using nvdaControllerClient.dll from C#. (#9600)
@@ -2235,7 +2235,7 @@ Please refer to the list of changes further down for more details on this and ho
 - New braille tables: Afrikaans, Arabic 8 dot computer braille, Arabic grade 2, Spanish grade 2. (#4435, #9186)
 - Added an option to NVDA's mouse settings to make NVDA handle situations where the mouse is controlled by another application. (#8452) 
  - This will allow NVDA to track the mouse when a system is controlled remotely using TeamViewer or other remote control software.
-- Added the `--enable-start-on-logon` command line parameter to allow configuring whether silent installations of NVDA set NVDA to start at Windows logon or not. Specify true to start at logon or false to not start at logon. If the --enable-start-on-logon argument is not specified at all then NVDA will default to starting at logon, unless it was  already configured not to by a previous installation. (#8574)
+- Added the ``--enable-start-on-logon`` command line parameter to allow configuring whether silent installations of NVDA set NVDA to start at Windows logon or not. Specify true to start at logon or false to not start at logon. If the --enable-start-on-logon argument is not specified at all then NVDA will default to starting at logon, unless it was  already configured not to by a previous installation. (#8574)
 - It is possible to turn NVDA's logging features off by setting logging level to "disabled" from General settings panel. (#8516)
 - The presence of formulae in LibreOffice and Apache OpenOffice spreadsheets is now reported. (#860)
 - In Mozilla Firefox and Google Chrome, browse mode now reports the selected item in list boxes and trees.
@@ -2254,7 +2254,7 @@ Please refer to the list of changes further down for more details on this and ho
 - This version of NVDA will allow installing and loading of add-ons  that do not yet contain Minimum and Last Tested NVDA version information, but upgrading to future versions of NVDA (E.g. 2019.2) may automatically cause these older add-ons to be disabled.
 - The move mouse to navigator object command is now available in Microsoft Word as well as for UIA controls, particularly Microsoft Edge. (#7916, #8371)
 - Reporting of text under the mouse has been improved within Microsoft Edge and other UIA applications. (#8370)
-- When NVDA is started with the `--portable-path` command line parameter, the provided path is automatically filled in when trying to create a portable copy of NVDA using the NVDA menu. (#8623)
+- When NVDA is started with the ``--portable-path`` command line parameter, the provided path is automatically filled in when trying to create a portable copy of NVDA using the NVDA menu. (#8623)
 - Updated the path to the Norwegian braille table to reflect the standard from the year 2015. (#9170)
 - When navigating by paragraph (control+up or down arrows) or navigating by table cell (control+alt+arrows), the existence of spelling errors will no longer be announced, even if NVDA is configured to announce these automatically. This is because paragraphs and table cells can be quite large, and detecting spelling errors in some applications can be very costly. (#9217)
 - NVDA no longer automatically loads custom appModules, globalPlugins and braille and synth drivers from the NVDA user configuration directory. This code should be instead packaged as an add-on with correct version information, ensuring that incompatible code is not run with current versions of NVDA. (#9238)
@@ -2759,10 +2759,10 @@ Highlights of this release include full support for audio ducking in the Windows
  - If you want normalized identifiers, there is now an InputGesture.normalizedIdentifiers property which normalizes the identifiers returned by the identifiers property .
 - The InputGesture.logIdentifier property is now deprecated. Callers should use InputGesture.identifiers[0] instead. (#6945)
 - Removed some deprecated code:
- - `speech.REASON_*` constants: `controlTypes.REASON_*` should be used instead. (#6846)
- - `i18nName` for synth settings: `displayName` and `displayNameWithAccelerator` should be used instead. (#6846, #5185)
- - `config.validateConfig`. (#6846, #667)
- - `config.save`: `config.conf.save` should be used instead. (#6846, #667)
+ - ``speech.REASON_*`` constants: ``controlTypes.REASON_*`` should be used instead. (#6846)
+ - ``i18nName`` for synth settings: ``displayName`` and ``displayNameWithAccelerator`` should be used instead. (#6846, #5185)
+ - ``config.validateConfig``. (#6846, #667)
+ - ``config.save``: ``config.conf.save`` should be used instead. (#6846, #667)
 - The list of completions in the autocomplete context menu of the Python Console no longer shows  any object path leading up to the final symbol being completed. (#7023)
 - There is now a unit testing framework for NVDA. (#7026)
  - Unit tests and infrastructure are located in the tests/unit directory. See the docstring in the tests\unit\__init__.py file for details.
diff --git a/user_docs/en/userGuide.t2t b/user_docs/en/userGuide.t2t
@@ -1452,10 +1452,9 @@ The available logging levels are:
 - Info: NVDA will log basic information such as startup messages and information useful for developers.
 - Debug warning: Warning messages that are not caused by severe errors will be logged.
 - Input/output: Input from keyboard and braille displays, as well as speech and braille output will be logged.
- - If you are concerned about privacy, do not set the logging level to this option.
+If you are concerned about privacy, do not set the logging level to this option.
 - Debug: In addition to info, warning, and input/output messages, additional debug messages will be logged.
- - Just like input/output, if you are concerned about privacy, you should not set the logging level to this option.
- -
+Just like input/output, if you are concerned about privacy, you should not set the logging level to this option.
 -
 
 ==== Start NVDA after I sign in ====[GeneralSettingsStartAfterLogOn]
@@ -2263,44 +2262,48 @@ For example, if you check the report font name checkbox, each time you arrow ont
 The document formatting options are organized into groups.
 You can configure reporting of:
 - Font
- - Font name
- - Font size
- - Font attributes
- - Superscripts and subscripts
- - Emphasis
- - Highlighted (Marked) text
- - Style
- - Colours
+  - Font name
+  - Font size
+  - Font attributes
+  - Superscripts and subscripts
+  - Emphasis
+  - Highlighted (Marked) text
+  - Style
+  - Colours
+  -
 - Document information
- - Comments
- - Bookmarks
- - Editor revisions
- - Spelling errors
+  - Comments
+  - Bookmarks
+  - Editor revisions
+  - Spelling errors
+  -
 - Pages and spacing
- - Page numbers
- - Line numbers
- - Line indentation reporting [(Off, Speech, Tones, Both Speech and Tones) #DocumentFormattingSettingsLineIndentation]
- - Ignore blank lines for line indentation reporting
- - Paragraph indentation (e.g. hanging indent, first line indent)
- - Line spacing (single, double, etc.)
- - Alignment
+  - Page numbers
+  - Line numbers
+  - Line indentation reporting [(Off, Speech, Tones, Both Speech and Tones) #DocumentFormattingSettingsLineIndentation]
+  - Ignore blank lines for line indentation reporting
+  - Paragraph indentation (e.g. hanging indent, first line indent)
+  - Line spacing (single, double, etc.)
+  - Alignment
+  -
 - Table information
- - Tables
- - Row/column headers (Off, Rows, Columns, Rows and columns)
- - Cell coordinates
- - Cell borders (Off, Styles, Both Colours and Styles)
+  - Tables
+  - Row/column headers (Off, Rows, Columns, Rows and columns)
+  - Cell coordinates
+  - Cell borders (Off, Styles, Both Colours and Styles)
+  -
 - Elements
- - Headings
- - Links
- - Graphics
- - Lists
- - Block quotes
- - Groupings
- - Landmarks
- - Articles
- - Frames
- - Clickable
- -
+  - Headings
+  - Links
+  - Graphics
+  - Lists
+  - Block quotes
+  - Groupings
+  - Landmarks
+  - Articles
+  - Frames
+  - Clickable
+  -
 -
 
 To toggle these settings from anywhere, please assign custom gestures using the [Input Gestures dialog #InputGestures].
@@ -2635,11 +2638,11 @@ You can also set the level to character; in this case the symbol will not be spo
 This is useful if the symbol causes the synthesizer to pause or change the inflection of the voice.
 For example, a comma causes the synthesizer to pause.
 There are three options:
- - never: Never send the actual symbol to the synthesizer.
- - always: Always send the actual symbol to the synthesizer.
- - only below symbols' level: Send the actual symbol only if the configured speech symbol level is lower than the level set for this symbol.
- For example, you might use this so that a symbol will have its replacement spoken at higher levels without pausing, while still being indicated with a pause at lower levels.
- -
+  - never: Never send the actual symbol to the synthesizer.
+  - always: Always send the actual symbol to the synthesizer.
+  - only below symbols' level: Send the actual symbol only if the configured speech symbol level is lower than the level set for this symbol.
+  For example, you might use this so that a symbol will have its replacement spoken at higher levels without pausing, while still being indicated with a pause at lower levels.
+  -
 -
 
 You can add new symbols by pressing the Add button.
@@ -2678,11 +2681,11 @@ Then, press the key on the keyboard you wish to emulate.
 After that, the key will be available from the Emulated system keyboard keys category and you will be able to assign an input gesture to it as described above.
 
 Note:
- - Emulated keys must have gestures assigned in order to persist when saving / closing the dialog.
- - An input gesture with modifier keys may not be able to be mapped to an emulated gesture without modifier
- keys. For instance, setting the emulated input 'a' and configuring an input gesture of 'ctrl+m', may result
- in the application receiving 'ctrl+a'.
- -
+- Emulated keys must have gestures assigned in order to persist when saving / closing the dialog.
+- An input gesture with modifier keys may not be able to be mapped to an emulated gesture without modifier keys.
+For instance, setting the emulated input ``a`` and configuring an input gesture of ``ctrl+m``, may result
+in the application receiving ``ctrl+a``.
+-
 
 When you are finished making changes, press the OK button to save them or the Cancel button to discard them.
 
@@ -3066,10 +3069,10 @@ These voices can also be used with NVDA.
 To use these voices, you will need to install two components:
 - [Microsoft Speech Platform - Runtime (Version 11), x86 https://www.microsoft.com/download/en/details.aspx?id=27225]
 - [Microsoft Speech Platform - Runtime Languages (Version 11) https://www.microsoft.com/download/en/details.aspx?id=27224]
- - This page includes many files for both speech recognition and text-to-speech.
+  - This page includes many files for both speech recognition and text-to-speech.
  Choose the files containing the TTS data for the desired languages/voices.
  For example, the file MSSpeech_TTS_en-US_ZiraPro.msi is a U.S. English voice.
- -
+  -
 -
 
 ++ Windows OneCore Voices ++[OneCore]
diff --git a/user_docs/th/key commands.txt b/user_docs/th/key commands.txt
