Documentation fixes.

Update documentation.

Support for braille input and some fixes.

baum driver: Support serial ports.

BrailleDisplayGesture.displayName: For braille input gestures, use BrailleInputGesture.displayName for friendlier output.
Fixes #2981.

Duch (nl):
  userGuide.t2t syntax fix.
  from translation svn:8383

Turkish (tr):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 100% of main:5884
  from translation svn:8381

Tamil (ta):
  userGuide.t2t matching 5899
  nvda.po matching 100% of main:5884
  from translation svn:8381

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

Slovak (sk):
  changes.t2t matching 5894
  nvda.po matching 99% of main:5884
  from translation svn:8381

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

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

Brazilian Portuguese (pt_BR):
  userGuide.t2t matching 5899
  changes.t2t matching 5822
  nvda.po matching 100% of main:5884
  from translation svn:8381

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

Polish (pl):
  userGuide.t2t
  changes.t2t
  nvda.po matching 100% of main:5884
  from translation svn:8381

Duch (nl):
  userGuide.t2t matching 5899
  nvda.po matching 100% of main:5884
  from translation svn:8381

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

Nepali (ne):
  userGuide.t2t matching 5899
  nvda.po matching 100% of main:5884
  from translation svn:8381

Korean (ko):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 100% of main:5884
  from translation svn:8381

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

Japanese (ja):
  userGuide.t2t matching 5899
  nvda.po matching 100% of main:5884
  from translation svn:8381

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

Icelandic (is):
  nvda.po matching 100% of main:5884
  from translation svn:8381

Hungarian (hu):
  nvda.po matching 99% of main:5884
  from translation svn:8381

French (fr):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 100% of main:5884
  from translation svn:8381

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

Finnish (fi):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 100% of main:5884
  from translation svn:8381

Galician (gl):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 100% of main:5884
  from translation svn:8381

Spanish (es):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 100% of main:5884
  from translation svn:8381

German (de):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 99% of main:5884
  from translation svn:8381

Authors: Bernd Dorer <bernd_dorer@yahoo.de>, David Parduhn <xkill85@gmx.net>, Rene Linke <rene.linke@blindzeln.de>

Aragonese (an):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 100% of main:5884
  from translation svn:8345

Arabic (ar):
  userGuide.t2t matching 5899
  changes.t2t matching 5894
  nvda.po matching 100% of main:5884
  from translation svn:8345

Update to iven2 espeak variant.

Chinese simplified New Experience input style: activate the current candidate with space as well as treeting it as a possible page change. Previously only enter used to activate.

user guide: change the note about the text review commands being in a grid to  clearly state that this only applies to the desktop layout. Fixes #3010

Fix crash introduced by 5897. Use ARRAYSIZE not sizeof. #2989.

gdiHooks's fake_StretchBlt: KMPlayer seems to place a graphic over the top of its context menu items using StretchBlt with SRCCOPY (replacing the real text it already put there). Therefore to keep the text accessible, make StretchBlt_helper think the operation was SRCAND rather than SRCCOPY so that any previous text in our display model is not cleared, if blitting to a window DC and that window is a menu (#32768). Fixes #2989.

Support non-unicode text given to ScriptStringAnalyse when tracking text for display models. Fixes #2376.
Specifically:
* Add a charSetToCodePage function which maps from a given charset identifier use in uniscribe and GDI fonts, to a Windows codePage, used in MultibytetoWidechar and friends. It logs an error if it fails, logging the charset.
* ExtTextOutHelper now takes a codePage argument. The unicode version ignores this, but the multibyte version passes this directly to MultiByteToWideChar.
* Our fake_ScriptStringOut looks at the iCharset given to ScriptStringAnalyse. If unicode it just calls the unicode version of ExtTextOutHelper as normal. If not though it converts the iCharset value to a codePage identifier and passes that to the multibyte version of ExtTextOutHelper.

Further work on adding translator comments (#1410)

Signed-off-by: Mesar Hameed <mhameed@src.gnome.org>

Update What's New.

adobeFlash virtualBuffer: don't treet its parent as being a part of the buffer.

Oops. Forgot to catch exception.

flash vbuf: __contains__: The Flash root object has two different object IDs, but Flash doesn't seem to know about the one on which IE fires focus events. Again, always trust IAccIdentity.
Also, in getIdentifierFromNVDAObject (which __contains__ now uses), never use event parameters if they aren't valid.
Fixes recreation of Flash buffers every time you move out and back into Flash content.

PowerPoint appModule: move the SlideShow toggleNotesMode script from the SlideShowWindow NVDAObject onto the SlideShowTreeInterceptor. This fixes the issue where alt tabbing away and back to a running Slide show would cause toggleNotesMode not to refresh content properly as it was manipulating the focus object, rather than the treeInterceptor's rootNVDAObject.

IA2TextTextInfo.getEmbeddedObject:
* Handle return value of -1 from IAccessibleHypertext::hyperlinkIndex according to the spec.
* When falling back to counting embedded objects, raise LookupError if there are none instead of just returning the object itself.

In IBM Lotus Symphony and OpenOffice, moving the caret now moves the review cursor if appropriate.

Work on adding translator comments (#1410)

processed so far:
IAccessibleHandler.py, NVDAHelper.py, appModuleHandler.py,
braille.py, colors.py, controlTypes.py,
core.py, globalCommands.py, installer.py,
keyboardHandler.py, mouseHandler.py, speech.py

Signed-off-by: Mesar Hameed <mhameed@src.gnome.org>

MSCandUI21_menuItem (Chinese Simplified Pinyin new experience): validate that  an item is truly usable (has a number and a candidate string) before setting focus to it both for show events and change page scripts. Stops NVDA from getting stuck in one of these lists in certain sircomstances.

MSCanUI21 menu Item (Chinese Simplified Pinyin new experience input): clear the visibleCandidateItemsText cache when changing candidate list pages. This allows the new list of candidates to be read properly.

PowerPoint appModule: While in a Slide Show, its now possible to switch between the slide content and the speaker notes for that slide, by pressing control+shift+s. Note that this only affects what NVDA reads, not what is presented on screen.

PowerPoint appModule: Rewrite support for Slide show windows so that they use a TreeInterceptor, which allows the selection to be held across focus changes to/from the same window. Speech presentation has been cleaned up a bit here also in that there is no longer a cancelSpeech, rather the original object is fully spoken, and then either a sayAll or the selection or the current line is reported. The slide content also no longer contains its object's name, as this would be redundant.

PowerPoint appModule: allow reading slide show contents while running a slide show in presenter view.
specifically:
* chooseNVDAObjectOverlayClasses: In presenter view the document object model we get is a document window (not a slideshowWindow) that has a broken viewType and activePane.viewType and no view. Therefore, when choosing a SlideshowWindow NVDAObject class, replace the document object model with the real SlideshowWindow object model by grabbing it from presentation.SlideshowWindow.
* chooseNVDAObjectOverlayClasses: cache the viewType and object model correctly on the actual object we're choosing for, not accidentily on the appModule.

Simplified Chinese (zh_CN):
  nvda.po matching 98% of main:5822
  from translation svn:8125

Aragonese (an):
  nvda.po matching 100% of 5822
  from translation svn:8125

Brazilian Portuguese (pt_BR):
  userGuide.t2t matching 5822
  nvda.po matching 100% of main:5822
  from translation svn:8121

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

Turkish (tr):
  changes.t2t matching 5845
  from translation svn:8121

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

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

Slovak (sk):
  userGuide.t2t matching 5822
  changes.t2t matching 5845
  nvda.po matching 97% of main:5822
  from translation svn:8121

Russian (ru):
  userGuide.t2t matching 5606
  nvda.po matching 100% of main:5822
  from translation svn:8121

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

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

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

Italian (it):
  userGuide.t2t matching 5822
  changes.t2t matching 5822
  nvda.po matching 100% of main:5822
  from translation svn:8121

Icelandic (is):
  userGuide.t2t matching 5780
  changes.t2t matching 5788
  nvda.po matching 99% of main:5822
  from translation svn:8121

French (fr):
  changes.t2t matching 5845
  nvda.po matching 100% of main:5822
  from translation svn:8121

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

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

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

Korean (ko):
  userGuide.t2t matching 5822
  nvda.po matching 100% of main:5822
  from translation svn:8121

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

Japanese (ja):
  symbols.dic
  changes.t2t matching 5822
  userGuide.t2t matching 5822
  nvda.po matching 100% of main:5822
  from translation svn:8121

Hungarian (hu):
  nvda.po matching 100% of main:5822
  from translation svn:8121

Galician (gl):
  userGuide.t2t matching 5822
  changes.t2t matching 5845
  nvda.po matching 100% of main:5822
  from translation svn:8121

Spanish (es):
  userGuide.t2t matching 5822
  changes.t2t matching 5845
  nvda.po matching 100% of main:5822
  from translation svn:8121

Finnish (fi):
  userGuide.t2t matching 5822
  changes.t2t matching 5845
  nvda.po matching 100% of main:5822
  from translation svn:8121

German (de):
  userGuide.t2t matching 5822
  changes.t2t matching 5822
  nvda.po matching 98% of main:5822
  from translation svn:8121

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

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

Arabic (ar):
  userGuide.t2t matching 5822
  changes.t2t matching 5845
  nvda.po matching 100% of main:5822
  from translation svn:8121

soffice: When calling IAccessibleHypertext::hyperlinkIndex, handle a return value of -1 as meaning there is no link at that offset according to the spec. Fixes incorrect reporting of links in OpenOffice IA2.

soffice app module: Tiny tweak to work a bit better with the early IAccessible2 support in OpenOffice. This treats OpenOffice like Symphony, since the implementation is very similar.

What's New: Add release blurb.

Aragonese (an):
  symbols.dic
  userGuide.t2t matching 5606
  nvda.po matching of
  from translation svn:7941

Italian gestures.ini, fix for #804.

Hungarian gestures.ini, fix for #804.

Reenable hooking of uniscribe functions for our display models which was accidentilly disabled in 5722.

Reenable the toltipOpened UIA event which was accidentilly disabled in the merge of the newLaptop branch specifically 5614.1.2

braille.TextInfoRegion: When we truncate line endings and add a space, make sure to adjust cursorPos accordingly, as we may have dropped a character.
Fixes inability to scroll to the previous line in standard Edit controls.
Fixes #2971.

BrailleHandler.handlePendingCaretUpdate: Make sure to set region.pendingCaretUpdate to False even if the cursor movement fails.
Ideally, it wouldn't fail, but it does in some cases and we don't want to end up endlessly trying to update the caret.

pt_PT: Add gestures.ini file to handle mouse emulation scripts in Portuguese keyboards (#2970).

Slovak fix for ticket #804, thanks to Ondrej

Fixes #804.

Present line number of syntax error when keyCommandsMaker fails to produce keyCommands.t2t

Fixes #2967.

Update What's New.

gecko vbuf: Map text leaf nodes to ROLE_STATICTEXT, accounting for the fact that they aren't read-only in Firefox >= 15.
Fixes incorrect treatment as editable text in some rare cases.

gecko vbuf backend: IAccessible2FromIdentifier: Return NULL if varChild is not CHILDID_SELF, as IAccessible2 can't be implemented on a simple child.
This shouldn't really happen, but we should protect against it just in case.

Whitespace.

Fix possible memory leak.

Revert previous sysListView32 group support memory leak fix and instead  instruct the BSTRs to free themselves on deletion. The previous atempt by using argtypes was bad as we would loose the return value from getGroupInfo which was needed to check success. Fixes #2969 -- uTorrent works again.

adobeFlash vbuf: Handle windowless Flash appropriately in __contains__.

Spanish fix for ticket #804, thanks to Norrumar

Spanish fix for ticket #804, thanks to Norrumar
Fixes #804.

adobeFlash vbuf backend: Flash seems to return a larger value for accChildCount than it should after some updates. When this happens, AccessibleChildren returns S_FALSE, so handle this as success.
Fixes blank documents after some dynamic updates to Flash content.

adobeFlash vbuf: Trust IAccidentity over event parameters.
This is necessary for Flash 11.6 because the root ID changed to 1 instead of CHILDID_SELF. This makes sure the buffer has the right root ID so that refresh events work.

SysListView32 group support: fix memory leak -- define full ctypes argtypes  for nvdaInProcUtils_sysListview32_getGroupInfo.

French (fr):
  userGuide.t2t matching 5822
  changes.t2t matching 5822
  nvda.po matching 100% of main:5822
  gestures.ini
  from translation svn:7985

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

pt_BR: userGuide.t2t now hopefully without errors.

pt_BR: revert userGuide due to keyCommand errors.

Turkish (tr):
  userGuide.t2t matching 5822
  changes.t2t matching 5822
  nvda.po matching 100% of main:5822
  gestures.ini
  from translation svn:7981

Brazilian Portuguese (pt_BR):
  userGuide.t2t matching 5822
  changes.t2t matching 5822
  nvda.po matching 99% of main:5822
  from translation svn:7979

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