Code to hopefully support Flash in Internet Explorer in Windows 8 once the new version of Flash is released.
Unfortunately, I can't actually test this as I don't have access to this new version for Windows 8 IE yet.
I'm merging this code now because it'd be good to have this support in 2013.1, it doesn't make things any worse than they are now and there are significant changes which may affect other versions of Flash which need further testing, though my testing hasn't revealed any problems.
Fixes #2454.

flash vbuf: Support for windowless Flash; i.e. use object ID as the ID.

Simplified Chinese (zh_CN):
  nvda.po matching 99% of main:5788
  from translation svn:7788

Turkish (tr):
  userGuide.t2t matching 5779
  changes.t2t matching 5788
  nvda.po matching 100% of main:5788
  from translation svn:7788

Tamil (ta):
  userGuide.t2t matching 5779
  nvda.po matching 99% of main:5788
  from translation svn:7788

Slovenian (sl):
  userGuide.t2t
  nvda.po matching 99% of main:5788
  from translation svn:7788

Slovak (sk):
  changes.t2t matching 5779
  nvda.po matching 96% of main:5788
  from translation svn:7788

Russian (ru):
  userGuide.t2t
  nvda.po matching 99% of main:5788
  from translation svn:7788

Authors: Beqa Gozalishvili <beqaprogger@gmail.com>, ruslan <ru2020slan@yandex.ru>

Brazilian Portuguese (pt_BR):
  userGuide.t2t matching 5745
  changes.t2t matching 5605
  nvda.po matching 99% of main:5788
  from translation svn:7788

Authors: Cleverson Casarin Uliana <clever92000@yahoo.com.br>, Marlin Rodrigues <marlincgrodrigues@yahoo.com.br>

Polish (pl):
  nvda.po matching 99% of main:5788
  from translation svn:7788

Nepali (ne):
  nvda.po matching 99% of main:5788
  from translation svn:7788

Duch (nl):
  userGuide.t2t matching 5774
  nvda.po matching 99% of main:5788
  from translation svn:7788

Authors: Bart Simons <bart@bartsimons.be>, A Campen <a.campen@wxs.nl>

Norwegian bokmål (nb_NO):
  nvda.po matching 99% of main:5788
  from translation svn:7788

Korean (ko):
  userGuide.t2t matching 5780
  changes.t2t matching 5788
  nvda.po matching 100% of main:5788
  from translation svn:7788

Authors: Joseph Lee <joseph.lee22590@gmail.com>, Chang-Hoan Jang <462356@gmail.com>

Japanese (ja):
  symbols.dic
  nvda.po matching 99% of main:5788
  from translation svn:7788

Italian (it):
  nvda.po matching 99% of main:5788
  from translation svn:7788

Icelandic (is):
  nvda.po matching 69% of main:5788
  userGuide.t2t
  from translation svn:7788

Authors: Birkir R. Gunnarsson <birkir.gunnarsson@gmail.com>, hm.hreinsson@gmail.com

French (fr):
  symbols.dic
  changes.t2t matching 5745
  userGuide.t2t matching 5774
  nvda.po matching 99% of main:5788
  from translation svn:7788

Authors: Patrick ZAJDA <patrick@zajda.fr>, Michel such <michel.such@free.fr>

Finnish (fi):
  userGuide.t2t matching 5779
  changes.t2t matching 5779
  nvda.po matching 99% of main:5788
  from translation svn:7788

Galician (gl):
  userGuide.t2t matching 5779
  changes.t2t matching 5779
  nvda.po matching 99% of main:5788
  from translation svn:7788

Spanish (es):
  userGuide.t2t matching 5779
  changes.t2t matching 5779
  nvda.po matching 99% of main:5788
  from translation svn:7788

German (de):
  userGuide.t2t matching 5774
  changes.t2t matching 5745
  nvda.po matching 98% of main:5788
  from translation svn:7788

Authors: Bernd Dorer <bernd_dorer@yahoo.de>, David Parduhn <xkill85@gmx.net>

Danish (da):
  userGuide.t2t
  nvda.po matching 96% of main:5788
  from translation svn:7788

Aragonese (an):
  nvda.po matching 99% of main:5788
  from translation svn:7788

Arabic (ar):
  userGuide.t2t matching 5745
  changes.t2t matching 5745
  nvda.po matching 97% of main:5788
  from translation svn:7788

flash backend: Allow for OBJID_CLIENT with CHILDID_SELF in events.

flash backend: Handle events for windowless Flash.

Merge main.

In Mozilla browsers, browse mode can again be used when Flash content is focused.
Specifically, this was a problem when Flash protected mode was enabled. It was due to a bug in Flash, but this change works around it.
Fixes #2546.

flash backend: Add support to render windowless Flash, as well as support for retrieving the accessible ID with IAccIdentity where supported.
Rendering is now always done using real IAccessible children, rather than querying the root accessible.
For windowless Flash, the ID is the object ID instead of the child ID.
Where IAccIdentity is supported, we use AccessibleChildren and get the ID from each child. This is more efficient and is the only way to do it for windowless Flash.
The older method of sequentially trying IDs is still supported for versions of Flash which do not support IAccIdentity.

PowerPoint appModule: SlideShowWindow's event_gainFocus: call super before reportNewSlide so that braille shows the current slide as well.

PowerPoint appModule's TextFrameTextInfo's _getTextRange method: don't add an extra '\n' to text when fetching; This breaks braille rather bad. Not to mention I have no memory as to why I added it - certainly doesn't cause errors with it gone now.

getAccId: Still not tested, but it now compiles.

flash backend: Add getAccId method ot get the ID using IAccIdentity. Untested.

Update liblouis braille translator to 2.5.2.
Add Korean grade 1 table.

setup.py: include comInterfaces inside library.zip instead of outside. This used to be a little slow but I don't notice too much.

Converted source/generateComInterfaces.py to an sconscript file (source/comInterfaces_sconscript).

Fix for #2929 (NVDA makes Firefox crash on audioboo.com). Specifically: for IA2LiveRegions code in NVDAHelper: when looping through the variant array from AccessibleChildren, just because a variant was marked as VT_DISPATCH, don't assume that pdispVal is not NULL -- check it first. Also made this change in Gecko VBufBackend, though it was the IA2LiveRegions one that always caused the actual crash.

Fix for #2951 - typing uppercase text into the Filter By field for the elements list in Browse mode now returns case-insenstive results the same as lowercase does, rather than nothing at all.

Added two new options to keyboard settings: interrupt speech for typed characters (on by default), and interrupt speech for Enter key (on by default). Fixes #698.

Support for input of computer braille for braille displays which have a braille keyboard.
Not all drivers implement this yet. Hopefully, they will eventually.
Fixes #808.

Merge main.

Move some module docstrings to the top of the module so they actually show up as module docstrings. There are probably a few more that need fixing.

Fix encoding error that was breaking Epydoc.

Dev docs building changes:
* Exclude nvdaHelper from scons devDocs and instead create a separate devDocs_nvdaHelper target, since this is very complex internal stuff that most developers aren't interested in.
* Add info about Epydoc dependency to the source readme.
Fixes #2421.

Merge main.

papenmeier driver: Correct dn and dn2 keys.
Fixes #2932.

Fixes to Papenmeier serial documentation.

Brazilian Portuguese (pt_BR):
  userGuide.t2t matching 5745
  from translation svn:7546

add Russian contributor.

Fix two spelling mistakes, Translators please ignore.
Fixes #2930.

Turkish (tr):
  userGuide.t2t matching 5745
  changes.t2t matching 5745
  nvda.po matching 100% of main:5745
  from translation svn:7439

Finnish (fi):
  userGuide.t2t matching 5745
  from translation svn:7439

Simplified Chinese (zh_CN):
  nvda.po matching 99% of main:5745
  from translation svn:7428

Russian (ru):
  userGuide.t2t
  nvda.po matching 100% of main:5745
  from translation svn:7428

Authors: Beqa Gozalishvili <beqaprogger@gmail.com>, ruslan <ru2020slan@yandex.ru>

Turkish (tr):
  userGuide.t2t matching 5680
  changes.t2t matching 5729
  nvda.po matching 99% of main:5745
  from translation svn:7428

Tamil (ta):
  userGuide.t2t matching 5745
  nvda.po matching 100% of main:5745
  from translation svn:7428

Slovenian (sl):
  userGuide.t2t
  nvda.po matching 100% of main:5745
  from translation svn:7428

Slovak (sk):
  userGuide.t2t matching 5680
  changes.t2t matching 5729
  nvda.po matching 96% of main:5745
  from translation svn:7428

Portuguese (pt_PT):
  nvda.po matching 97% of main:5745
  from translation svn:7428

Brazilian Portuguese (pt_BR):
  changes.t2t
  nvda.po matching 100% of main:5745
  from translation svn:7428

Authors: Cleverson Casarin Uliana <clever92000@yahoo.com.br>, Marlin Rodrigues <marlincgrodrigues@yahoo.com.br>

Polish (pl):
  nvda.po matching 99% of main:5745
  from translation svn:7428

Norwegian bokmål (nb_NO):
  nvda.po matching 97% of main:5745
  from translation svn:7428

Nepali (ne):
  nvda.po matching 100% of main:5745
  from translation svn:7428

Duch (nl):
  userGuide.t2t matching 5660
  nvda.po matching 100% of main:5745
  from translation svn:7428

Authors: Bart Simons <bart@bartsimons.be>, A Campen <a.campen@wxs.nl>

Korean (ko):
  userGuide.t2t matching 5680
  changes.t2t matching 5739
  nvda.po matching 100% of main:5745
  from translation svn:7428

Authors: Joseph Lee <joseph.lee22590@gmail.com>, Chang-Hoan Jang <462356@gmail.com>

Japanese (ja):
  symbols.dic
  userGuide.t2t matching 5680
  nvda.po matching 100% of main:5745
  from translation svn:7428

Italian (it):
  symbols.dic
  changes.t2t matching 5745
  userGuide.t2t matching 5745
  nvda.po matching 100% of main:5745
  from translation svn:7428

Icelandic (is):
  nvda.po matching 70% of main:5745
  from translation svn:7428

Authors: Birkir R. Gunnarsson <birkir.gunnarsson@gmail.com>, H M. Hreinsson <hm.hreinsson@gmail.com>

French (fr):
  symbols.dic
  changes.t2t matching 5739
  nvda.po matching 100% of main:5745
  from translation svn:7428

Authors: Michel such <michel.such@free.fr>, Patrick ZAJDA <patrick@zajda.fr>

Finnish (fi):
  symbols.dic
  changes.t2t matching 5745
  nvda.po matching 100% of main:5745
  from translation svn:7428

Galician (gl):
  userGuide.t2t matching 5745
  changes.t2t matching 5745
  nvda.po matching 100% of main:5745
  from translation svn:7428

Spanish (es):
  userGuide.t2t matching 5745
  changes.t2t matching 5745
  nvda.po matching 100% of main:5745
  from translation svn:7428

German (de):
  userGuide.t2t matching 5680
  changes.t2t matching 5739
  nvda.po matching 98% of main:5734
  from translation svn:7428

Authors: Bernd Dorer <bernd_dorer@yahoo.de>, David Parduhn <xkill85@gmx.net>

Aragonese (an):
  userGuide.t2t
  nvda.po matching 100% of main:5745
  from translation svn:7428

Arabic (ar):
  userGuide.t2t matching 5680
  changes.t2t matching 5739
  nvda.po matching 98% of main:5745
  from translation svn:7428

Authors: Fatma Mehanna <fatma.mehanna@gmail.com>, Shaimaa Ibrahim <shamse1@gmail.com>

Freedom Scientific driver: only create braille input gesture when only space or dots are pressed (and no other key).

What's New: Add developer info.

Update What's New.

Reword.

User Guide: Add braille input to the braille displays point in the features list. Linguistic fixes to Braille Input/Output Table settings. Add notes to Supported Braille Displays section concerning drivers which don't support braille input.

Support for older 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, Ali-Riza Ciftcioglu <aliminator83@googlemail.com>, James Teh <jamie@jantrid.net>
Fixes #2679.

Update What's New.

English User Guide: Linguistic and syntax fixes. Make command names consistent with the rest of the User Guide. Include in Key Commands.

Whitespace.

Initial import of papenmeier_serial driver.
Authors: Tobias Platen, Halim Sahin, Ali-Riza Ciftcioglu <aliminator83@googlemail.com>

Move one more monkey patch into comtypesMonkeyPatches.

PowerPoint appModule: Listen for COM events from PowerPoint in order to track the selection and slide show transitions, rather than using specific keyboard gestures. This now allows NVDA to report the next slide in a slide show if the slide changes by itself or via user input NVDA did not expect. Also there may have been other user input NVDA did not expect, for moving the selection.
Specifically:
* Implement a COM object that supports the EApplication interface (Powerpoint application object's outgoing interface). This implementation supports WindowSelectionChange and SlideshowNextSlide. These events alert NVDA of changes by calling DocumentWindow NVDAObject's handleSelectionChange etc on the current focus object, but only if the focus window for the current input thread is the same window as what the NVDA focus object is for (i.e. there is no event_gainFocus coming up).
* Subscribe our EApplication event listner to Powerpoint  using comtypes.client._AdviseConnection the first time an object model is successfully retreaved.
* OutlinePane NVDAObject now inherits from PaneClassDC rather than DocumentWindow as it does not need the selection properties, nor should we do anything about selection changes in this window from Powerpoint.
* SlideShowWindow NVDAObject: rename handleNewSlide to reportNewSlide as it doesn't actually set anything up as such. Also convert script_changeSlide into a normal method called handleSlidechange, which just clears any cached slide info and then calls reportNewSlide. This is called from the SlideShowNextSlide APowerpoint event.

Mostly for Powerpoint: monkey patch comtypes.automation.VARIANT so that fetching its value when its a VT_DISPATCH does not use GetBestInterface, rather just dynamic.Dispatch. Variants already got some support for dynamic, but its currently not used for IDispatch_Invoke on comtypes COM server COM objects, which is annoying for PowerPoint. If we were to change comtypes, we could keep this change specifically inside IDispatch_Invoke for COM servers, but monky patching this is not as easy. If we see any regressions from this change, we can either: manually QueryInterface to a suitable interface where needed, or try again at monkey patching further, or of course, patch comtypes itself.

Merge main.

baum driver: Correct the length of the argument for routing key data, which is actually 10 bytes for > 40 cells and 5 bytes for <= 40.
This would probably have been harmless except for debugWarnings.

Add comment.

baum driver: Add support for braille input. Untested, as I don't have a unit with braille input keys.

The HumanWare Brailliant BI/B series braille display driver can now be selected when the display is connected via Bluetooth but has never been connected via USB.

brailliantB driver: Add support for braille input. Untested, as I don't have a unit to test with.

Move all comtypes monkey patches out of core.py into a separate module (comtypesMonkeyPatches) as there are quite a few and soon there will be more.

Add braille input support to the braillenote driver.

Add input table to braille settings documentation and changed translation table to output table.

* Expanded a bit the output table section: we have tables for many languages but also grades and "standards".
* In the braille input table section make clear the feature is only supported in devices with a braille keyboard (obvious but...) and if the driver supports it. Link the braille displays documentation for further details.

Change translation table to output table in braille settings dialog and braille input to table to just input table.

* The config setting is still translation table. I'm not changing it for compatibility reasons.
* It also needs documentation changes.

Add Braille input table selection to settings dialog.

* Added new combo box tthe braille settings dialog
* Add braille.INPUT_TABLES constant to filter input-ready tables (to avoid recomputing it elsewhere).
* Add new ["braille"][inputTable"] setting to config.
* Use config["braille"]["inputTable"] on !brailleInputHandler to back-translate braille dots.