Powerpoint appModule: provide fetching of formatting from shape text ranges. Includes font name, font size, bold, italic, underline, superscript/subscript and text color. This code will always work at the review cursor, but you can also turn on formatting after cursor to get all format changes within a chunk reported automatically. However, this does get a bit slow if there are many format runs. This code will eventually be replaced with in-process code.

Powerpoint appModule: Include the title in the label for slides if they have them (#2905). Also report position info (x of y) when selecting slides in Slide sorter and thumbnails views.
Specifically:
* Split out some base features from the Slide NVDAObject into a SlideBase NVDAObject.
* Slide NVDAObject: include the text of the 'title' shape of the slide in brackets after the slide number if it exists.
* Slide NVDAObject: implement positionInfo property so that for selected slides (in Thumbnails and slide sorter) x of y is announced.
* Add a Master NVDAObject for master slides, that just uses the Master object's name as the NVDAObject's name -- Masters do not have slide numbers or meaningful slide titles.
* SlideBase NVDAObject: implement a findOverlayClasses that selects either Slide or Master depending on the view.
* All other code now instanciates SlideBase instead of Slide so that either Slide or Master will be automatically chosen at runtime.

MS Powerpoint 2003 throws a COMError for textRange.parent instead of returning None when it can't be retreaved. Catch this error.

A big restructure to the Powerpoint appModule based on findings while implementing in the last week. Provides partial support for Outline view via display model, slightly beter support for slide sorter view. Fixes to object navigation, and always possible to review a slide in slide view with display model.
Specific changes:
* appModule.chooseNVDAObjectOverlayClasses is now used again to choose PaneClassDC, DocumentWindow, SlideShowWindow etc, rather than AppModule.event_gainFocus / PaneClassDC.findOverlayClasses. PaneClassDC now has an event_gainFocus which handles the app switching to fix fetching of the object model. This allows object navigation to pick up a working PaneClassDC if its the focused pane at least.
* DocumentWindow now contains the slide's name in its name if the document's view has a slide. (Most panes do have a slide, such as slide view, notes page, outline view etc).
* Moved ppActivePaneViewType, ppDocumentViewType properties from PaneClassDC to DocumentWindow as they're only now needed here.
* DocumentWindow.selection: a slide is only returned if its truely selected. For example, in Slide view a slide is no longer returned as the current slide's name is in the panes name anyway. But in Slide sorter or Thumbnails view a slide could be returned as these views are for specifically selecting slides.
* Moved handleSelectionChange and script_selectionChange, and all related key bindings from PpObject/Shape/Slide NVDAObjects onto the DocumentWindow NVDAObject. Script_selectionChange now has canPropagate set to true. In short DocumentWindow now totally manages selection of shapes / slides/textFrames. PpObject NVDAObject however still keeps a script_selectionChange which simply calls DocumentWindow's one, so that subClasses of PpObject can still bind in certain situations, such as for pressing tab when editing in a tableCell text frame.
* PaneClassDC has a DisplayModelTextInfo as its TextInfo so that its possible to review display content for any view.
* Added an OutlinePane NVDAObject to represent Outline view, which  inherits from EditableText and DocumentWindow, and uses an EditableTextDisplayModelTextInfo so that display model is used to track the caret in this view. A little flaky still but better than nothing.
* Shape NVDAObject's parent property now always returns the DocumentWindow (pane its in) rather than a Slide NVDAObject. The slide is not necessary as the pane is specifically for the slide anyway.
* Removed children and childCount properties from Slide and Shape NVDAObjects as they're not used or needed.
* Implement firstChild on DocumentWindow NVDAObjects to return selection property. This is so its possible to get back after navigating to parent.

Merged main

Allow scons launcher to build properlty again. I made a mistake in 5725 -- forgot the equals sign.

Fix for #2904 (IAccessible window objects treeted as layout when unavailable).
Specifically:
* IAccessible NVDAObject's presentationType property: remove all mentions of window objects and implement a new presentationType property on WindowRoot IAccessible NVDAObjects that returns unavailable if unavailable or invisible is in states, layout if the window does not have any extra IAccessibles, and at the very end, content.
* Move the windowHasExtraIAccessibles method onto the WindowRoot IAccessible NVDAObject.
* IAccessible NVDAObject's isPresentableFocusAncestor: remove any mention of window objects and  put a isPresentableFocusAncestor property on GenericWindow IAccessible NVDAObjects that is set to False.

Merge main

powerpoint appModule: Rewrite PaneClassDC NVDAObject's selection property to better handle the notes page in normal view. In Powerpoint 2007 and below it doesn't correctly report that text can be selected, so override this. Also allow selection tracking of slides in the slide sorter view.

uninstall and launcher NSI scripts: set Outfile with an OutFile command in the script that takes a quoted define, rather than the OutFile command being passed in on the commandline. This allows NVDA to be built  when there are spaces in the path.

setup.py: Don't explicitly include ftdi2. I don't know why I thought it wouldn't be included implicitly, since brailleDisplayDrivers have been bundled for a while now.
This means that a user who doesn't need this can still build successfully.

Powerpoint appModule: DocumentWindow NVDAObject: make use of Powerpoint's activePane.viewType to correctly label the currently active pane. MS Office 2003 does not automatically label its pane windows at all.

Powerpoint appModule: make the PaneClassDC NVDAObject have a presentation type of content and a role of pane so that its name is announced on the focus ancestors as that is what tells you whether its notes, or slide master etc. Also give Slide NVDAObjects a presentation type of content so that  if moving focus to Powerpoint and it straight away landes on a shape, NVDA will announce the slide in the focus ancestry.

Powerpoint appModule: again generate a slide's name from its slide number if it has one, otherwize (for masters, use the name). The name can't be used for normal slides as the auto-generated powerpoint names do not make sense when the slides are deleted or reorded.

Add support for all the master views in PowerPoint (title master, slide master, notes master etc):
* Slide NVDAObject's name property: don't make up the name ourselves, just use the PowerPoint Slide object's name property instead. The name is already unique, and for slides by default does contain the number. This also allows this to work for master slides which don't have a number.
* Slide NVDAObject's _isEqual method: don't use slideID for comparison as master slides don't implement this property. Instead use the name property as this is guaranteed to be unique and both slides and masters contain this.

nvdaHelperLocal.cancellableSendMessageTimeout: don't foreceably remove SMTO_BLOCK as it can freeze Powerpoint #2900. Lets see how this goes for now...

Allow Powerpoint appModule to work with Powerpoint 2007 and 2003:
* Use the PaneClassDC NVDAObject with the IAccessible client (objid_client) of PaneClassDC windows, rather than checking for PaneClassDC windows with a role of pane (roles seem to change between Office versions).
* Catch exceptions around another use of shape.title which I missed.

Powerpoint appModule: refactor the way we switch apps to fix object model registration so that it doesn't cause infinit switching if the object model always fails.
Specifically:
* PaneClassDC.ppObjectModel no longer is in charge of switching apps if it fails, it simply tries to fetch it or returns None if it fails.
* PaneClassDC: allow initializing with a keyword argument of ppObjectModel, which overrides  its ppObjectModel getter with a pre existing Powerpoint object model instance.
* the appModule's event_gainFocus: If this a PaneClassDC window, specifically fetch the powerpoint object model first and if successful, pass it to the PaneClassDC NVDAObject when initializing.
If it fails to get the object model, then if it hasn't tried switching apps once, do it and return.

Powerpoint appModule: handle the end of a slide show (no slide is currently being viewed.

Powerpoint appModule: fix bug that stopped NVDA from being able to provide access to Powerpoint when it first opens with out either waiting 10 seconds or having the user alt tab away and back again. Although a better implementation may be possible in future, for now quickly flash up a temporary NVDA dialog if fetching the Powerpoint object model fails the first time. Fixes #2896

Powerpoint appModule: better detection of Slide Show vs Document window:
* PaneClassDC NVDAObject: implement a FindOverlayClasses which chooses DocumentWindow or SlideShowWindow if available, by looking at the object given back by fetching the Powerpoint object model.
* Rather than using the appModule's chooseNVDAObjectOverLayClass, use the appModule's event_gainFocus and instanciate a new PaneClassDC instance and bounce focus there.

Powerpoint: report bullets and numbering when editing text and when reading slide shows.

Powerpoint 2003 Shape objects do not have a title property so catch COMError.

Merged main

Powerpoint Slide Show view: detect slide changes when space is pressed.

DisplayModel_t::copyRectangle: refuse to copy if the source or destination rectangle is collapsed vertically or horizontally. This is a pointless copy and it could cause zero division errors. Possible fix for #2885.

Add very basic support for reading running Slide Shows in Powerpoint. Currently just collects text from text frames, alt text and titles from all shapes (recursing into groups and tables as it goes) and caching this text on NVDAObject.basicText. Very simple and bad implementation, but good as a prototype. No formatting or real type information provided. Focusing on the slide show, or changing slides in the slide show refereshes the content and starts a say all. Arrows can be used to navigate text.

Added an appModule providing initial support for MS Powerpoint. So far support only covers navigating and editing slides in 'normal' mode. 'reading mode' (slide show) is not yet supported. Also no formatting announced yet.

displayModel.cpp: remove some debugging code

Better handling of the raster codes for BitBlt/StretchBlt, now properly supporting things like whether the code is saying that the copy should be opaque, the source or destination colors should be inverted etc.

Hook gdiTransparentBlt

Turkish (TR):
Added changes.t2t.

Traditional Chinese Taiwan (zh_TW):
  nvda.po matching 98% of main:5687
  from translation svn:7022

Authors: wangjanli@gmail.com, maro.zhang@gmail.com, Aaron Wu <waaron2000@gmail.com>

Traditional Chinese Hong Kong (zh_HK):
  nvda.po matching 98% of main:5687
  from translation svn:7022

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

Turkish (tr):
  userGuide.t2t matching 5660
  nvda.po matching 100% of main:5687
  from translation svn:7022

Tamil (ta):
  userGuide.t2t matching 5680
  nvda.po matching 100% of main:5687
  from translation svn:7022

Slovenian (sl):
  symbols.dic
  nvda.po matching 98% of main:5347
  from translation svn:7022

Slovak (sk):
  userGuide.t2t matching 5660
  changes.t2t matching 5667
  nvda.po matching 99% of main:5687
  from translation svn:7022

Authors: Ondrej Rosik <ondrej.rosik@gmail.com>, Peter Vagner <peter.v@datagate.sk>

Russian (ru):
  symbols.dic
  userGuide.t2t matching 5606
  nvda.po matching 100% of main:5687
  from translation svn:7022

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

Portuguese (pt_PT):
  nvda.po matching 100% of main:5687
  from translation svn:7022

Authors: Diogo Costa <diogojoca@gmail.com>, Rui Batista <ruiandrebatista@gmail.com>, Rui Fontes <rui.fontes@tiflotecnia.com>

Brazilian Portuguese (pt_BR):
  userGuide.t2t matching 5605
  changes.t2t matching 5605
  nvda.po matching 100% of main:5687
  from translation svn:7022

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

Polish (pl):
  nvda.po matching 98% of main:5687
  from translation svn:7022

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

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

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

Norwegian bokmål (nb_NO):
  nvda.po matching 98% of main:5687
  from translation svn:7022

Authors: David Hole <balubathebrave@gmail.com>, Bjornar Seppola <bjornar@seppola.net>

Korean (ko):
  userGuide.t2t matching 5680
  changes.t2t matching 5692
  nvda.po matching 100% of main:5687
  from translation svn:7022

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

Japanese (ja):
  userGuide.t2t matching 5606
  nvda.po matching 100% of main:5687
  from translation svn:7022

Italian (it):
  userGuide.t2t matching 5660
  changes.t2t matching 5692
  nvda.po matching 100% of main:5687
  from translation svn:7022

Hungarian (hu):
  nvda.po matching 98% of main:5687
  from translation svn:7022

Galician (gl):
  userGuide.t2t matching 5680
  changes.t2t matching 5683
  nvda.po matching 100% of main:5687
  from translation svn:7022

French (fr):
  userGuide.t2t matching 5680
  changes.t2t matching 5683
  nvda.po matching 100% of main:5687
  from translation svn:7022

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

Finnish (fi):
  userGuide.t2t matching 5680
  changes.t2t matching 5692
  nvda.po matching 100% of main:5687
  from translation svn:7022

Spanish (es):
  userGuide.t2t matching 5680
  changes.t2t matching 5683
  nvda.po matching 100% of main:5687
  from translation svn:7022

German (de):
  userGuide.t2t matching 5660
  changes.t2t matching 5661
  nvda.po matching 98% of main:5687
  from translation svn:7022

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

Danish (da):
  userGuide.t2t matching 5610
  nvda.po matching 98% of main:5687
  from translation svn:7022

Authors: Daniel K. Gartmann <kontakt@nvda.dk>, Nicolai Svendsen <chojiro1990@gmail.com>

Czech (cs):
  nvda.po matching 100% of main:5687
  from translation svn:7022

Authors: Radek zalud <radek.zalud@seznam.cz>, Martina Letochova <letochova@seznam.cz>

Arabic (ar):
  userGuide.t2t matching 5660
  changes.t2t matching 5667
  nvda.po matching 100% of main:5687
  from translation svn:7022

Aragonese (an):
  symbols.dic
  nvda.po matching 100% of main:5689
  from translation svn:7022

Support for StretchBlt in the display model code. This allows NVDA to see tab labels in DropBox's preferences dialog, and perhaps other things.
Specifically:
* DisplayModel_t::copyRectangle: rather than only taking x and y coordinates for the destination, take a complete destination rectangle instead.
* DisplayModel_t::copyRectangle: Apart from shifting (transposing) coordinates of copied chunks to be positioned in the destination rectangle, also scale all the coordinates so that the chunk is now the correct size relative to the destination rectangle.
  *GDIHooks: split out most of the BitBlt code into a helper function so it can be used also by a hook for StretchBlt.
*GDIHooks: hook StretchBlt.

Add comments.

brailleNote: Use MAC address range to detect Apex via Bluetooth, as the name can be completely customised.
Fixes #2857.

Merge 2012.3.

Bump version to 2012.3.1.

Merged 2012.3

languageHandler.getLanguageDescription: hard-coded map: Add translator comments, as poedit and possibly other apps don't see the context string in the UI. Change the context string to "languageName" to be consistent with other context strings.

Slovenian (sl):
  symbols.dic
  nvda.po matching 97% of main:5347
  from translation svn:6917

Fix for #2858: If Windows / Python fails to convert an ISO language code in to a locale identifier, or Windows fails to find a description for a locale identifier, fall back to a static map of ISO language codes to language descriptions. This map contains descriptions for am,an,ar,ne,sr.

installer._deleteKeyAndSubkeys: Don't close the handle before deleting the key. Otherwise, the key can't be deleted.
This means that these keys are now actually removed during uninstallation.
Also, refactored the loop to be a bit more Pythonic and stopped catching exceptions. It should be up to the caller to decide whether failed deletion is a problem.
Fixes #2859.

CandidateListItem behavior: gracefully handle the situation where there is no actual candidate, rather than raising an error when trying to generate its description.

addonHandler: don't make NVDA fail on restart if an addon cannot be removed because its directory is currently in use by another application. Fixes #2860.
Specifically:
* Addon.completeRemove: always rename the directory to a temp directory with a delete sufix before trying to actually remove the directory. If the rename does not work, then there's nothing we can do for now. Just raise an error.
* CompletePendingAddonRemovals: When walking through the set of add-ons, copy the list so that the set can be mutated while walking. Catch an error from Addon.completeRemove and just skip over it. Remove the addonName from the pendingRemoves set for each addon, as long as no error occured when calling Addon.completeRemove. This keeps addons that failed removal and couldn't be renamed for deletion in the pendingRemove state meaning that the GUI will reflect this, and on a subsiquent restart it will try to be removed again.

When disabling automatic checking for updates, NVDA no longer has to be restarted in order for the change to fully take effect.
Previously, updateCheck.terminate() tried to dispose of autoChecker, but the timer creates a circular reference, so it would still run for the next check. The timer needs to be explicitly discarded to prevent this.

Linguistic fix.

Add support for manual port selection in braille display drivers. Add BrailleNote driver and allow for selection of automatic/USB/bluetooth ports for Freedom Scientific displays.
Fixes #426, #2012.

Aragonese (an):
  symbols.dic
  nvda.po matching 100% of main:5672
  from translation svn:6890

Merge main.

Remove debugging code. :)

hwPortUtils.getToshibaBluetoothPortInfo: Oops. Don't fail when encountering a bluetooth item which isn't a serial port.

Merge main.

When custom symbol pronunciation information is saved, the advanced preserve field is no longer removed.
Fixes #2852.

hwPortUtils: Restrict Toshiba bluetooth hardware ID check, as it's always exactly the same string for all ports.

hwPortUtils: Make spelling of ID consistent.

hwPortUtils: Add support for the Toshiba bluetooth stack.
This allows NVDA to detect braille displays connected via bluetooth on a computer running this stack.
Fixes #2419.

vbuf utils: isWhitespace: Treat line feed as whitespace.
This means that a node containing only a line feed (and perhaps other whitespace) will be treated as not having useful content, which allows the mshtml and gecko backends to use the name instead.
This fixes rendering of the links on the Wordpress Dashboard and probably other cases as well.

gecko vbuf backend: If the name should be the content, as well as rendering the name if no content was rendered, render it if the content consisted only of a small amount of whitespace, as this content isn't useful.

vbuf: Move code which checks for useful content (i.e. not empty or not just a small amount of whitespace) into a nodeHasUsefulContent utility function so it can be used by other backends.

Replace all translatable strings with ambiguous positional arguments with appropriate named arguments in the nwer format syntax. scons pot noo longer complains about incorrect usage of positional arguments.

Fix a missed VBufRemote call where node is now an out param rather than return.

Update What's New.

SecureCRT: Add another window class name to support version 7.0.x.

User Guide: Linguistic and syntax fixes.

brailleNote: Change description to include "HumanWare".

What's New: Remove general mention of support for serial displays, as this is only really relevant to specific displays as far as the user is concerned. Instead, add info to developer changes regarding port selection.
Also, minor linguistic fixes.

Braillenote driver:: remove unused variable and update docstring.

What's new: Add serial display support, fs port selection and brailleNote display support.

Merged main.

Userguide: Add documentation about Braillenote terminal display support. Minor language corrections on Freedom scientific displays documentation.

Braillnote driver: corrected small typo on gesture bindings for home key.

merge 2012.3

zh_CN: updated symbols.dic and characterDescriptions.dic.