Merge 2011.1.

characterProcessing.getCharacterDescription: For now remove the code that uses unicodedata if there is no english character description available. Although this was very useful for English, it caused problems in other locales as it eclipsed data in characterSymbols. In future we may consider a better way to handle this, but for now its gone.

What's New: Add 2011.1.1 release blurb.

accordence -> accordance

Added finnish characters descriptions,
Updated finnish user guide and changes,
Added german characters descriptions,
Updated turkish language file,ä

Added croatian characters descriptions.

Added turkish characters descriptions.

Added czech and slovak characters descriptions

Added Russian character descriptions from wikipedia.

Some cosmetic fixes for czechh changes,
Updated slovak changes.

Added Japanese character descriptions

Merged character descriptions branch (#55). This implements support in NVDA to hear a description or examples of a given character. Pressing review current character twice will provide a description of the character under the review cursor. Pressing review current word or review current line three times will spell the word or line but using descriptions.  So far descriptions for english, french and traditional Chinese (Taiwan) have been added. Descriptions are chosen based on NVDA's current locale and or the English locale. In future we may consider tying this to the synth's current language. This implementation is especially important to Asian languages as it now provides them with a way to have example phraises spoken for a given symbol, as for in Chinese, many symbols can sound the same but have different meanings.

Update english changes file

Update english changes and user guide files to mention character descriptions

characterProcessing.getCharacterDescription:
* If locale data cannot be found for a particular locale and its not english, fall back to English by calling getCharacterDescription this time with 'en'.
* If a character description can not be found in the locale data for a given locale, and its not english, fall back to English by calling getCharacterDescription with 'en'.
* If a character description can not be found in the english locale, instead look up the name in the unicode database. The unicode database is only available in english, however I think it is a useful fall back when there is nothing else to say.
* Finally if absolutely nothing can be found, then None is returned, which means that NVDA will just use the character itself.

setup.py: include *.dic files in locale directories.

Added characterDescriptions.dic for French

Merged main

Merged releases/2011.1 branch

Merged fix for #1425 as the user guide states it works this way.

Updated czech changes.

NVDAObjects.window.edit.EditTextInfo._getWordOffsets: re-implement word offset support for standard edit controls (pre  richEdit) by following  the Microsoft documented rule of only breaking on spaces. This code replaces the extremely problematic implementation that used to move the caret by sending key presses, in order to calculate the word offsets.
 This implementation of course is much faster, and should no longer cause problems for braille or other code that may want to expand to word during typing.
Microsoft KB article: http://support.microsoft.com/kb/109551

Fix for 1425 (NVDA should make it easier to discover unbound gestures): now when in input help mode, all gestures are logged whether or not they are bound to a script. If bound to a script, then that information is also appended to the log message.

Added a Traditional Chinese (Taiwan) characterDescriptions.dic which provides examples for many traditional Chinese characters. Based on data from the libchewingdata project: libchewingdata.openfoundry.org/

Added an English characterDescriptions.dic which provides the standard English phonetic alphabet.

Updated czech changes,
Updated finnish user guide.

Merged main

characterProcessing.CharacterDescriptions.getCharacterDescription:  better handle the case where there are no descriptions for the given character. Now returns None, rather than raising an exception.

characterProcessing: Added a LocaleDataMap class, which can handle the dynamic loading and storage and lookup of data objects for particular locales. The reason for this abstraction is that symbol Framework can hopefully make use of this also. Also added CharacterDescriptions, which is a class  when instanciated with a locale, loads characters and their descriptions from a file and allows lookup. Based on code by Timothy Lee. Finally the module-level getCharacterDescriptions makes use of all this completing its implementation. Note though that LocaleDataMap could be improved to do timed caching (removing old objects to save memory).

speech: for now only use NVDA's locale for character descriptions, the synth language can still not be entirely trusted yet.

speech: No longer handle character descriptions in processSymbol, instead handle it directly in _speakSpellingGen. This means that processSymbol again only takes a character, no longer locale or useCharacterDescriptions. Fixes bugs where certain symbols were no longer being spoken when moving by word or selecting text etc.
Also, force characters to lowercase when looking up their description.

* speech.speakSpelling, speech._speakSpellingGen and speech.processSymbol now all take a locale argument and a useCharacterDescriptions argument. In the case of speakSpelling both of these are optional, but for the other internal functions these are manditory.  SpeakSpelling if locale is not provided defaults to either the current synth's language if it has one, or instead NVDA's current locale. SpeakSpelling's useCharacterDescriptions by default is false.
* speech.processSymbol: if useCharacterDescriptions is True, then characterProcessing.getCharacterDescription is used to fetch a character description, and if it finds one, it is returned straight away. If it does not find one, or character descriptions were not requested, then the function stays as is.

* script_review_current{word|Line} scripts  now pass useCharacterDescriptions as true to speech.speakSpelling if the script has been executed more than twice (i.e. pressed three times). So, once says the string as is, twice spells the string, three times or more spells with character descriptions.
* GlobalCommands.script_review_currentCharacter: pressing twice now announces the character with character descriptions, and three times now speaks the hex representation.

Fix syntax error

Added a characterProcessing module, which so far contains  a getCharacterDescription function. This function takes alocale and a character, and returns a description for the given character in the given locale. For now the descritpion returned is hardcoded as the locale + the character, just for testing.

Updated japanese language file,
Updated french changes.

Updated italian language file and changes,
Updated finnish changes,
Updated czech user guide.

arabic changes for 2011.1.1,

Updated danish language file

Merge 2011.1.

arabic changes for 2011.1.1, small modifications to userguide, critical small changes to interface, and the new changes.

Added turkish braille table into the braille settings dialog.

Updated danish user guide

Updated slovak changes.

No longer register for UIA textChange and textSelectionChange automation events, as this was causing major performance issues in WPF applications using .net 3.5 [apparently]. Certainly for one particular wpf app (#1205) no longer registering makes the app now quite usable.  However, due to no longer receiving textSelectionChange, NVDA must use EditableTextWithoutAutoSelectDetection for UIA editable text controls. May partially fix #1205 and #1437, though no testing on XP as yet.

Update version string.

nvda.pyw: duplicate getInputDesktopName from nvda_service so that it does not have to be imporated (it pulls in too much unrelated code).

nvda.pyw: protect against multiple instances of NVDA being accidentilly started by using a mutex. The mutex name is specific to the desktop and session (hopefully).  This new feature should be tested well with the service on secure desktops.

What's New: Add entry for moveToParentTreeInterceptor fix.

Updated finnish language file, user guide, language strings for the NVDA installer and changes,
Updated slovak changes.

Merge 2011.1.

What's New: Minor tweak.

Disable logging on secure Windows screens, as this is a security risk.
Fixes #1435.

NVDAHelper.RemoteLoader64: The file descriptors returned by the fileno() method of Python file objects are not file handles. Therefore, when duplicating the nul file handle for the loader process, query the file handle with msvcrt.get_osfhandle().
This never caused a problem because there always seemed to be a file handle with the same number as the file descriptor we were supplying, though it's very possible it was the wrong one. However, once we have no log file, this fails with an invalid handle error.
In any case, this was *very* incorrect. I'm surprised it hasn't caused us problems before this.

developerGuide: remove double spacing at the beginning of each line via postProc as txt2tags seems to place two spaces before ach line of preformatted text (i.e. our code samples).

Report space pressed with modifiers other than shift as a command key.
Fixes #1424.

Don't report shifted characters as command keys.
Fixes #1422.

NVDAObjects.IAccessible.IAccessible.findOverlayClasses: when checking if GeckoPluginWindow should be used, also make sure the childID is 0.

Fix for #1429 (Firefox 4: Can't escape embedded objects using moveToParentTreeInterceptor script):
* NVDAObjects.IAccessible.adobeFlash.Root NVDAObject's parent property: ass accParent is broken on the Adobe Flash root client, instead override it to properly return its window root IAccessible.
* IAccessibleHandler: add NAVRELATION_EMBEDS Mozilla Gecko constant.
* NVDAObjects.IAccessible.mozilla: add a GeckoPluginWindowRoot overlay NVDAObject, which should be used on the window root IAccessible NVDAObject for GeckoPlugin windows (the newer plugin window class in Firefox). This NvDAObject overrides the parent property to appropriately return the document this plugin is embedded in. It does this by fetching the original parent, checking to see if it has a Gecko version, and in deed if its not version 1 (therefore 2 or higher) and then using Mozilla's NAVRELATION_EMBEDS to fetch the active document.
* NVDAObjects.IAccessible.IAccessible.findOverlayClasses: if the window class is GeckoPluginWindow and the object's MSAA objectID is 0 (window root) then use the mozilla.GeckoPluginWindowRoot overlay class.
* globalCommands.GlobalCommands.script_moveToParentTreeInterceptor: rather than just using eventHandler.executeEvent directly to fake the focus event, instead use wx.CallLater to run the executeEvent call  50 ms in to the future. This is needed for Firefox 4 to get around the issue where a focus event is fired on the top window after focus moves back to the document.

Fix for #837 (merge move caret script in to double press of move focus

Merged releases/2011.1 branch

Updated czech language file and fixed a problem which caused czech quick command keys not to be generated for the official version.

api.copyToClip(): Catch exceptions from OpenClipboard and return False as callers expect.
Fixes exception when using review_copy script in secure mode.

nvdaHelper: allow nvdaHelperRemoteLoader to compile again by fixing the argument to injection_initialize... oops missed this.

Update changes file to mention clipboard fix.

Do not allow copy/paste  at all inside NVDA's UI while in secure mode (e.g. when NVDA is running on the secure desktop -- lock screen -- windows logon). To do this, Only in the NVDA process itself, and only in secure mode, nvdaHelperRemote hooks the OpenClipboard Windows API function and forces it to return false, and does not call the original OpenClipboard. This simply denies access to the clipboard for NVDA's process. Fixes #1421.

Don't include the Donate menu item in secure mode, as this is a security risk.
Fixes #1419.

NVDAHelper gdiHooks.cpp: remove all comments from fake functions refering to keeping NVDAHelperRemote from unloading. This code was taken out a long time ago therefore the comments are not valid.

nvdaHelper fake_createCompatibleDc: don't create a new displayModel if the real_createCompatibleDc returns NULL. Very rare, but could happen.

Report space pressed with modifiers other than shift as a command key.
Returning early for space was causing any key press including space to be treated as a non-command key.
Fixes #1424.

Don't report shifted characters as command keys.
I seem to have forgotten that generalizedModifiers includes the extended flag as well as the VK code. Oops.
Fixes #1422.

Don't include the Donate menu item in secure mode, as this is a security risk.
Fixes #1419.

Update version string.

Updated Russian language strings for the NVDA installer

Update Russian language file and changes, update contributors.

Updated dutch language file and added user guide in dutch.

Merge

Updated Dutch translation

Added Dutch translation of the user guide

Updated japanese language file.

Updated simplified chinese user guide and the language strings for the NVDA installer.

Updated traditional chinese language file and user guide,
Updated simplified chinese language file.

Updated finnish user guide and changes.

Updated croatian language file.

sconstruct: instead of copying nvdaHelper docs to the devDocs directory, move it. Also make sure that when cleaning devDocs, the output/devDocs directory is totally removed.

sconstruct: developerGuide.html is now placed in output/devDocs. scons devDocs is now an alias simply for output/devDocs, which means that scons devDocs will now build anything that ends up there, not just nvdaHelper docs.

Updated contributers file,

Updated italian language file, user guide and changes.

Updated contributers file, Arabic translation team 2011.1

Update What's New.

mshtml and gecko_ia2 vbuf backends: Treat inline-block elements as inline elements instead of block elements; i.e. make them appear on the same line instead of separate lines.
Partial fix for #1378.

Typo and linguistic fixes.

API documentation in html can now be generated for nvdaHelper. You will need doxygen: see the readme.txt for where to get it. To generate the documentation, run the command: scons devDocs
Specific changes:
* Added a doxygen scons tool, based on the tool from the SCons wiki, with various changes by me. Major changes were auto-detection of doxygen using Windows registry, and some fixes to the way it generates its scons target nodes -- they were relative to the wrong directory.
* Updated nvdaHelper/doxyfile,  it still said Virtual Buffer Library 2.0!
* sconstruct: build documentation using nvdaHelper/doxyfile, and copy it to output/devDocs/nvdaHelper.  The devDocs alias can be used to build this. More documentation such as epydoc for NVDA itself will also be added at a later stage.

Updated hungarian user guide and changes,
Updated galician language file and user guide.

userGuide: Fixed a typo (thx Aron)

Updated Arabic locale, (userguide, changes ...

Updated Arabic locale, (userguide, changes and nvda.po).

Added changes in polish,
Updated polish language file, language strings for the NVDA installer, user guide,
Updated german language file, user guide and changes,
Updated danish language file,
Updated czech language file, language strings for the NVDA installer and user guide,
Updated slovak user guide and changes.

vkCodes: fixed a typo which in turn fixes anouncement of left control key press in the NVDA's user language.

Collapsing a combo box in a virtual buffer when focus mode has been forced with NVDA+space no longer auto-switches back to browse mode. Fixes #1386

English User Guide: Remapping Key Assignments...: Clarify that each entry key can only occur once per section. Note that gesture identifiers ending in a comma must be enclosed in quotes.