characterProcessing.py, synthDrivers/_espeak.py:
Provide some gettext context strings.

What's New: Add support for several more braille displays to release blurb.

Update liblouis to 2.5.1.
Fixes #2662, #2672.

msimn appModule: fix errors when trying to type with an input method in the to/cc/bcc fields in Outlook Express.

NVDA now announces the IME open status as it changes. This is really only important for Japanese as far as I can tell.

Add translator comments

Added another input composition option: always include a short character description for candidates. If on, a short character description (specifically the first) will be included in the candidate's name (i.e. will be spoken both for auto candidate list reading and for candidate selection changes). The rest of the character descriptions (if any) are still announced as the description on selection changes whether or not this option is on or off. These short character descriptions are provided for each character in a candidate, at the position of the candidate, rather than at the end. This option may be useful for both Krean and Japanese.

userGuide.t2t: fix small typo, heading has 4 equals before and 3 after, make it 4.
Thanks Marlin for noticing this.

More options for input composition:
* Announce Selected Candidate: allows to configure whether or not NVDA should announce the selected candidate when a candidate list appears or when the selection is changed. Note that if this option is turned off the review cursor is still placed on the candidate.
* Report Composition string changes: Allows you to configure whether or not NVDA will announce changes to the composition string.

IME support: delay reporting of a candidate change by re-posting another custom window message and processing it from a getMessage hook. This fixes bugs with Boshiamy where the reporting of the candidate list was very incomplete due to it not being completely shown yet.

Only automatically report all candidates in a candidate list if the candidate list has more than one item. If only 1, it should not be repeated twice. Also place a final comma (,) after the last candidate when automatically reporting to separate it from the further announcement of the actual focused candidate.

Credit Ali-Riza Ciftcioglu by name.

papenmeier: Fix mapping of right rear key.
Fixes #2678.

SpeechSymbolProcessor: Optimise the regular expression by matching all single character symbols in a regexp character set rather than separate expressions separated by the | operator.
This should also allow for more single character symbols.

Add recent code contributors.

papenmeier: Correct reporting of formatting with upper routing row. NVDA needs to be given the chance to update the review position.
Authors: aliminator83@googlemail.com, James Teh <jamie@jantrid.net>
Fixes #2675.

source readme: Note pyserial dependency for other braille display drivers.

Support for newer models of Papenmeier BRAILLEX braille displays.
I've made some changes to the English documentation. German translators will need to update the German documentation accordingly.
Authors: Tobias Platen, Halim Sahin, aliminator83@googlemail.com, James Teh <jamie@jantrid.net>
Fixes #1265.

source readme: Add ftdi Python module dependency.

Update What's New.

English User Guide: Change the title of the Papenmeier section to be consistent with the description in the driver.

German User Guide: Formatting fixes.

User Guide: Move Papenmeier above BRLTTY. BRLTTY is the least preferred option for most users.

English User Guide: Linguistic and formatting fixes. Also change command names to names documented in User Guide.

Initial import of Papenmeier documentation.
Authors: Tobias Platen, Halim Sahin, aliminator83@googlemail.com

Use a non-zero test when checking for non-emptiness of a string instead of calling len().

Add copyright and credit NV Access for changes.

Remove extraneous gesture bindings.

Whitespace.

Use an itertools.cycle for r1next rather than a specific function.

brl_out: Make filling dummy bytes more efficient/readable.

Whitespace.

Initial import of Papenmeier driver.
Authors: Tobias Platen, Halim Sahin, aliminator83@googlemail.com

sysListView32: Arrrg. LVM_GETVIEW isn't supported by comctl32 < 6.0, so check for LVS_REPORT as well.
Hopefully, no one sets LVS_REPORT and then LV_VIEW_ICON, as we can't tell the difference between LV_VIEW_ICON and not supported.
This should fix the list in Protected Storage PassView.
Fixes #2673.

What's New: Add release blurb.

Add Italian 6 dot computer braille, and rename the other italian table from grade 1 to 8 dot computer braille.

If NVDA is installed on the system, directly opening an NVDA add-on package (e.g. from Windows Explorer or after downloading in a web browser) will install it into NVDA.
Fixes #2306.

Update What's New.

can not -> cannot

nvda_slave: Fix typo that was breaking the add-on installation failure message.

nvdaControllerinternal: Declare installAddonPackageFromPath with comm_status and fault_status so it returns error codes instead of raising exceptions, which is consistent with the other functions.

sconstruct: Now that we're using GNU gettext msgfmt, mo files can be built in parallel.

Ignore errors when unregistering the .nvda-addon file association, as it's probably just the first install, in which case the keys won't exist.

Merge main.

Fix errors in po files for af_ZA, ka and sq that were causing builds to fail now that we're using msgfmt from GNU gettext, which is stricter than msgfmt.py.
For af_ZA, there seems to have been an encoding error. I used Google Translate to source a translation for the problematic word, but a translator should verify this and correct it if necessary.
The errors in ka and sq were due to messages not ending in a line feed when they should.

What's New: Correct entry concerning installation of an add-on which is already installed.

sysListView32: Enable multi-column support for owner drawn items if there is a non-empty accDescription, as this means there is valid column content.
Fixes certain lists such as in WinDirStat.
Fixes #2668.

sysListView32: Remove lvAppImageID, as it's not useful, I think it's wrong anyway and it doesn't support 64 bit.

Code doc.

Gettext message contexts are now supported. This allows multiple translations to be defined for a single English message depending on the context.
Fixes #1524.

Use msgfmt from GNU gettext to generate mo files instead of msgfmt.py.
This is needed to support message contexts and possibly other more advanced features.

The NVDA Key Commands Quick Reference document has been renamed to Commands Quick Reference, as it now includes touch commands as well as keyboard commands.

sysListView32.ListItem.name: If IAccessible has a valid name, return that instead of displayText even if the list reports it is owner drawn.
This shoulde fix reporting of the contact list in Zello.
Fixes #2645.

Fix indentation.

Window.devInfo: Add displayText.

devInfo: Move truncation of long string values into a function rather than duplicating the code everywhere. Increase truncation length to 250 chars. Truncate some other potentially long strings.

User Guide: List Windows 8 as a supported operating system. There are still some niggles, but for the most part, it's quite usable with NVDA.

User Guide: Fixes and tweaks to touch documentation.
Fixes #2661.

Forgot to add ticket number for new braille tables.

Add Estonian grade 0, Portuguese 8 computer braille tables.
Switch to using the new Ethiopic table.

What's New: Mention liblouis update.

In Mozilla applications, the value of spin buttons is now correctly reported when it changes.
To fix this, IAccessible's valueChange event now checks whether NVDA determined that the object had editable text instead of just checking for the IAccessibleText interface.
Fixes #2653.

Updated user guide to include a section on touch gestures. Added a Touch column to some of the NVDA command tables so that they now include touch gestures for commands that have them. Mentioned touch when talking about remapping gestures. Changed a few mentions of "key commands" to "NVDA commands" and the like.

utorrent.TorrentContentsListItem.name: Use the new _getColumnLocation method, rather than messing about with the column header IAccessibles.

FocusableUnfocusableContainer: Err, let's not focus on *every* focusable descendant, shall we? Just the first (as intended) is quite enough.

Update to liblouis 2.5.0.

Where a document contains an application, the content of the application is no longer included in browse mode. This prevents unexpectedly moving inside the application when navigating. You can interact with the application in the same way as for embedded objects.
Fixes #990.

Update documentation.

Merge main.

Introduce a FocusableUnfocusableContainer behavior to make unfocusable containers focusable using their first focusable descendant. Use this in IAccessible for unfocusable applications. This makes it possible to work with unfocusable ARIA applications.

VirtualBuffer: Set focus to an application to activate it. Don't focus on applications when navigating.

MSHTML NVDAObject: implement the location property to fetch the coorect location using getBoundingcleitnRect and ClientToScreen so as to not rely on the incorrect MSAA location from an ancestor element. However text leaf nodes  just give None for location as its impossible to get a correct one. this now allows more accurately routing the mouse to objects in IE and such.

MSHTML NVDAObject's kwargsFromSuper: more accurately calculate coordinates for use with ElementFromPoint. This should hopefully make reading with touch in IE metro (win8) more accurate, and seems to  improve accuracy with the mouse for IE in general. Though its still not as high resolution as it used to be as it does use the parent element, not individual text nodes.

RowWithoutCelObjects behavior's _getColumnLocation method is now noted as being optional. _fakeTableCell now catches NotImplementedError in this case.

Some small fixes for list table code:
* SysListview32 NVDAObject's _getColumnLocation method: use the column order array.
* SysListview32 NVDAObject's _getColumnLocationRaw method: remove if check for VirtualAllo9cEx as it raises an exception on errors anyway.
* RowWithoutCellObjects behavior: provide a base _getColumnLocation method that raises NotImplementedError.

mshtml vbuf backend: Don't render descendants of ARIA applications.

TextInfo.getPresentationCategory: Present applications as markers so that their role is spoken when they are encountered.

gecko vbuf backend: Don't render descendants of ARIA applications.

Provide a location for fake table cells for lists (specifically SysListview32 controls). This therefore also allows routing the mouse to the position of these objects. Though it is worth noting that NVDA will only announce the list item as a whole when the mouse moves there as objectFromPoint does not pick it up. But clicking would click in the right place. Fixes #2651.

For SysListview32 controls that are owner drawn, again use displayModel to fetch the text. Though this time  fill in name, not value. Also disable column support for owner drawn SysListview32 controls as although some do get column headers right, there is nothing stopping the app from drawing right across the columns ignoring them (such as in the case of the Sys Internals Auto Runs app). Fixes #2652.

MSHTML: Implement isFocusable.

NVDAObject: Add isFocusable and hasFocus properties.
The base implementation just checks states, but subclasses may wish to override these rather than using states, as fetching all states can be expensive.

What's New: Spelling error: Excell -> Excel.

MSHTML: Add some devInfo.

IAccessible.devInfo: Add accName, accDescription and accValue, as these might be useful if NVDA has overridden them in the abstracted properties.

mozilla: Reinstate mouse transparency (beTransparentToMouse = True) for text leaf nodes.
Fixes mouse tracking in Mozilla applications.
Fixes #2656.

sysListView32: Enable multi-column support for tile view.
Fixes #2657.

sysListView32: Include column headers when reporting the list item if reporting of column headers is enabled.
Fixes #2647.

_FakeTableCell behavior: Arrg. Hackily pull windowControlID from the parent as well to satisfy code which doesn't check for Window objects. We need to fix this properly one day, but for now, this will suffice.

globalCommands: Remove BOM which crept in recently, as it breaks xgettext. Arrrg.
Fixes #2650.

IAccessible.devInfo: Add some IAccessible2 info.

sysListView32: To avoid breaking existing app modules and global plugins, rename ListItem to ListItemWithoutReportView and ListItemWithReportView to ListItem, as the latter is the default behaviour.
This should fix weird "Cannot create a consistent method resolution order (MRO)" TypeErrors in Outlook Express and possibly other plugins.
There are still some cases where this change might cause similar breakage, but they are rare.

sysListView32: A list-view might be in report view even if its default view (as determined using window style) is otherwise, so query the current view using LVM_GETVIEW.
Fixes reading of columns in some lists such as Programs and Features in Windows 7 Control Panel.
Fixes #2646.

Merged touchSupport branch. Adds experimental support for touch screens on Windows 8. This includes reading text directly under your finger when moving it around the screen, gestures for object navigation, text review and other NVDA commands. This may not be feature complete, but should be stable enough and provides at least basic touch screen use.

touchHandler: remove debugging beeps.

Do not import NVDAObject.uia in touchHandler. Not needed and it was causing a critical error on XP.

Mention touch support in changes file.

For now, remove the quicknav touch mode as there were no scripts for this mode so far anyway.

MSHTML MSAATextLeaf NVDAObject: do not set beTransparentToMouse as True anymore as for now the mouse still needs to find these, and so does touch in Metro IE. Also remove some debugging beeps.

Fix possible exception.