merge main

Major refactoring to support addon specific translations.

* Refactored getAvailableAddons and getRunningAddons. Internally addons can be queried by path to facilitate identification of currently calling addon.
* addonHanler.getCodeAddon() retrieves the addon instnace for the calling addon, using stack inspection.
* addonHandler.initTranslation() adds the ettext _ function to the calling module to support addon specific translation (it relies on addonHandler.getCodeAddon internally).
* Many more minor tweaks and corrections.

Merged win8Injection branch. This means that installed releases of NVDA can now hook into metro style apps, enabling features such as speaking typed characters, browse mode for web documents (including full support for metro version of Internet Explorer 10), and displayModel (if GDI is ever used). Please note that this will *only* work if NVDA runs with the uiAccess privilidge, which for now only is installed official releases (not snapshots or any portable copies).
A lot of NVDA's rpc and injection code needed to be rewritten to handle metro style apps. Therefore please watch out for and report any weirdness resulting from this revision (especially on Operating Systems before Windows 8).

update changes file

updateCheck: Why calculate when we don't need to? :)

installerGui:
* Remove the "Installation options" grouping, as it is redundant and creates extraneous verbosity.
* Place the options vertically instead of horizontally.
* Call mainSizer.Fit so that everything actually fits in the window properly.

gui: Move About below Check for update in the Help menu for consistency with most other apps.
Fixes #2251.

Add translator comment for "no navigator object".

Add translator comments for reporting of formatting.

nvdaHelperLocal's startServer:  while we're fiddling with rpc and doing lots of testing, convert this code to use auto-listen interfaces just like nvdaHelperRemote does, rather than having to create a thread to run a specific server.  !. dlls are supposed to do this, and 2. There has always been a chance that our rpc server thread had not yet fully initialized before  the first remote code was run.

nvdaHelperLocal's createRemoteBindingHandle: on versions less win8, the 'AC' sid is unknown therefore ConvertStringSecurityDescriptorToSecurityDescriptor fails. Only try making the security descriptor and calling RpcBindingSetAuthInfoEx if RpcServerRegisterIf3 exists in rpcrt4.dll (i.e. this is Win8 or higher) -- same check as in startServer. This allows correct running on Win7 and Xp (sp3 tested so far).

nvdaHelperRemote: Create the nvdaUnregisteredEvent initially as signaled rather than unsignaled. This means that if there is some kind of error and NVDA never gets to register, then the inproc code will appropriately terminate as soon as it can.

nvdaHelperRemote: Make sure that minhook.dll really gets unloaded properly when apiHooks_terminate is called. This means calling FreeLibrary to match our explicit LoadLibrary in apiHooks_initialize, telling the linker to support delayLoad unloading with /delay:unload, and also by calling __FUnloadDelayLoadedDLL2("minHook.dll") to cleanly unload the delay loaded minHook.dll. Also pass /delay:nobind to the linker as this can speed up loading a bit as we never need to supported pre-bounded dlls, in fact this would be bad for minhook anyway.

Fix a typo in a log call

merged main

Create a addonHandler.getRunningAddons() function to abstract internal tracking of running addons.

Changed runningAddons to _runningAddons to make it "module-private" and a dictionary keyed by addon.path. This would be important for nvda to trac from what addon belongs a specific object (by inspection) so add-on localization for instance can be implemented. This is subject to change though.

Minor code and documentation corrections:

* Use cStringIO to have better performace
* Corrected doc strings
* Hooks system: create a getHookFunction on the Addon class so the calable can be retrived
* Hooks system: when running a hook on all loaded addons return (addon, ret) even if the hook returns None, so callers can check what addons realy implemented the hook.
* Many more small corrections (see #213, comments 37 to 41).

nvdaHelperLocal: replace all the old fprintf calls with LOG_ERROR and also add a few more while we're at it.

Make it possible to log messages from NVDAHelperLocal.
Specific changes:
* move log.h out of nvdaHelper/remote to nvdaHelper/common and change all NVDAHelper remote and vbuf cpp files to include the moved file.
* nvdaHelperLocal.cpp: Implement logMessage which just calls nvdaControllerInternal_logMessage giving a processID of 0 to denote this is local. Note that calling nvdaControllerInternal_logMessage is direct hear, no RPC.
* nvdaHelper.py: If nvdaControllerInternal_logMessage is called with pid of 0 then  make the message's codePath say its from nvdaHelperLocal.

controlTypes.py: improve translator comments for "not selected".

nvdaHelperLocal: Use security descriptors allowing everyone, rather than just authenticated users. Not good but Adobe Reader X seems to need this.

Remove extras/auto run from removable drive, as NVDA can now generate autorun.inf itself.

source readme: Update URL for Handy Tech SDK.

Merged main

Merge Main

Also commit change to readme.txt

We now use the most recent NSIS UAC plug-in (version 0.2.4). Please place uac.nsh and ansi\\uac.dll in the uninstaller directory. Fixes #1661

When NVDA is started with --launcher (including running the launcher executable itself and when NVDA  is performing an update) the current user's installed user config (in appData) is used if it already exists.
      Specific changes:
        * nvda.pyw: set the configPath option by default to None rather than a default path.
        * config.getUserDefaultconfigPath: Add a keyword argument 'useInstalledUserConfigPathIfExists' which if set to true will use the installed userConfig path (appData) if it exists, even if this is not an installed copy.
        * core.main: if configPath is None (was not passed in on the commandline) then use config.getUserDefaultconfigPath setting useInstalledUserconfigPathIfExists to true if --launcher was given.
        * Initialize the config directory in core.main after the configPath hasbeen set, rather than in nvda.pyw.

In Winamp, braille is now correctly updated when you move to a different item in the Playlist Editor.
Fixes #1912.

In browse mode in Adobe Reader, it is now possible to navigate to headings without a level using quick navigation and the Elements List.
Fixes #2181.

Detection of word breaks now works correctly where whitespace is followed by certain punctuation.
Fixes #1656.

controlTypes: Add translator comment for "block quote".

speech: Add translator comment for "not %s".

updateCheck.DonateRequestDialog: Change the label of the Close button to Not now to make its purpose clearer. Morph the Donate button into a Done button after it has been pressed, which then closes the dialog.

Small change to allow "not selected", and "not checked"
to be localized in a better way than concatinating the translation of "not" and "selected/checked".

Fixes #2235.

merged main

installerGui: Remove unnecessary code.

installerGui: Display the error icon in error message boxes.

installerGui: Translator comments.

Create portable copy dialog: The portable directory field is left blank by default. The browse dialog will either start from the typed portable directory or c: if its blank. When pressing continue, A messageBox is now shown if the portable directory is blank, or if the drive the portable directory is on does not exist. Fixes #2208

Turkish (tr):
  symbols.dic
  userGuide.t2t matching 5070
  nvda.po matching 5077

Tamil (ta):
  userGuide.t2t matching 5070
  nvda.po matching 5066

Slovak (sk):
  symbols.dic
  changes.t2t matching 5059
  userGuide.t2t matching 5063
  nvda.po almost matching 5066

Portuguese (pt_PT):
  symbols.dic
  userGuide.t2t matching: insufficient data
  nvda.po matching 5066

Brazilian Portuguese (pt_BR):
  userGuide.t2t matching 5057
  nvda.po matching 5066

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

installer.registerInstallation: correctly create the app path NVDA registry key so that NVDA can be again started from the Run dialog. It needed to be the full path to the exe, and "" should be used instead of "@" to set the default subkey. Fixes #2247

base NVDAObject: add a 'cellCoordsText' property which can be used to override  presentation of row and column numbers with a different format such as A1. Speech: announce cellCoordsText instead of row and column numbers if its implemented. Excel and SOFFICE: Make use of cellCoordsText for spreadsheet cell coordinates. This now means that specifically in these spreadsheets, the cell coordinates will be spoken after the value rather than before. Announcement of cell coordinates can be turned off all together in the document formatting dialog. Note that Braille does not yet seem to present row and column info at all for NVDAObjects yet.

updateCheck, installerGui: Hide the progress dialog before destroying it. For updateCheck, make sure the Python object gets deleted as well.
This seems to fix the crash after updating and the issue where the progress dialog would still show while the message box was being displayed. I'm not sure why this is necessary, but it seems Destroy is delayed somehow.

Polish (pl):
  userGuide.t2t matching 5057
  nvda.po almost matching 5066

Norwegian bokmål (nb_NO):
  nvda.po matching 5070

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

Japanese (ja):
  changes.t2t matching 5053
  nvda.po matching 5077

Authors: Katsutoshi Tsuji <tsuji-katsutoshi@mitsue.co.jp>, Nakamura Kiyochika <nakamura-kiyochika@mitsue.co.jp>

Italian (it):
  userGuide.t2t matching 5057
  changes.t2t matching 5059
  nvda.po matching 5066

French (fr):
  nvda.po matching 5066

Finnish (fi):
  symbols.dic
  changes.t2t matching 5059
  userGuide.t2t matching 5070
  nvda.po matching 5077

Galician (gl):
  userGuide.t2t matching 5063
  changes.t2t matching 5059
  nvda.po matching 5066

Spanish (es):
  userGuide.t2t matching 5063
  changes.t2t matching 5059
  nvda.po matching 5066

German (de):
  userGuide.t2t matching 5070
  changes.t2t matching 5059
  nvda.po matching 5070

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

Danish (da):
  symbols.dic corrections.

Czech (cs):
  nvda.po almost matching 5070

Arabic (ar):
  symbols.dic small correction
  changes.t2t matching 5059
  userGuide.t2t matching 5070
  nvda.po almost matching 5070

merged main

nvdaHelper.nvdaControllerInternal_requestRegistration: use a c_long rather than a c_void_p to hold the bindingHandle as that is what all the other functype definitions expect. Allows displayModel methods to work again.

updateCheck.UpdateDownloader: Display an error message when an error occurs.

cosmetic: Fix indentation.

Add translator comments for the progress bar output options in the Object Presentation settings dialog.

installerGui: Add translator comments.

A bit of a re-write to nvdahelper injection and rpc code to allow NVDA access to inproc rpc interfaces such as virtualBuffers hosted in an appContainer process (e.g. metro app). Assuming NVDA has the UIAccess privilidge, virtualBuffers are now available in metro apps such as Store.
Specific changes:
   * On win8 nvdaHelperLocal registers the nvdaController and nvdaControllerInternal interfaces using the new RpcServerRegisterIf3, allowing the use of a security descriptor which specifically allows access from AppContainer integrity processes. However as the security descriptor overrides any defaults, it also for now allows access from any authenticated users  -- this could be tightened up.
* nvdaInprocUtils now has two new methods: registerNVDAProcess and unregisterNVDAProcess, plus an rundown function for the context handle registerNVDAProcess provides. When injection is all initialized, NVDA can call registerNVDAprocess and when it wants the inproc code to terminate it can call unregisterNVDAProcess, or just break the connection or exit. registerNVDAProcess sets an nvdaUnregisteredEvent to nonSignaled, which the inproc code uses to wait on. UnregisterNVDAProcess (also called by the rundown if the connection breaks) sets this event to signaled to instruct the inproc code to terminate.
* nvdaHelperRemote: remove the injectionDoneEvent and any code that waited on it or the NVDA process. Its no longer needed. Note that this did not work in AppContainer processes anyway unless a specific security descriptor was set for both the NVDA process and the injectionDoneEvent.
* nvdaHelperRemote: When registering its RPC interfaces (nvdaInprocUtils, displayModel and VBuf), use RpcUseProtSeq rather than RpcUseProtSeqEp so as to listen on a dynamic endpoint rather than a well-known one. AppContainer processes mangled the endpoint name anyway. Publish correct dynamic endpoints for each interface along with a generated UUID specific to this instance of the inproc code, using RpcEpRegister, so that NVDA can locate this processes endpoint by using the interface and generated UUID. Finally also call a new nvdaControllerInternal method: requestRegistration to ask NVDA to register with this inproc code before the call returns.
* nvdaHelperLocal: rename createConnection to createRemoteBindingHandle (which is more true) and also set a security descriptor on the created binding handle to allow an AppContainer server to talk back to this client -- could be tightened up. createRemoteBindingHandle also now takes a uuid parameter which it uses when creating the binding handle so its able to locate the correct endpoint.
* nvdaControllerInternal: add a new requestRegistration method, which takes a UUID string which can be used to locate the caller's own inproc rpc interfaces. The implementation of requestRegistration uses the UUID to create a bindingHandle for remote access to the inproc code using createRemoteBindingHandle, storing it on the appModule which it creates if necessary. It also calls registerNVDAProcess so as to retreave a context handle from the inproc code that if broken will force the inproc code to terminate. This is also stored on the appModule.
* AppModule.terminate: If a registrationhandle exists, destroy it with rpcSsDestroyClientContext. If a bindingHandle exists then free it with RpcBindingFree. Destroying both of these is enough to ensure the connection with the inproc code breaks and therefore the rundown for the registration will run and inproc code will be terminated. This is safer than specifically calling unregisterNVDAProcess which could freee or may fail if the remote process is busy or shutting down or is dead etc.
* core.initialize: initialize appModuleHandler before nvdaHelper as nvdahelper.nvdaControllerInternal_requestRegistration, which can happen quite quick, needs the ability to create an appModule.

installerGui: Clean up the Installer and Create Portable NVDA dialogs after performing the action.

installerGui: Make the Continue button the default button in the Installer and Create Portable NVDA dialogs.
Fixes #2225.

Add copyright headers.

user guide: fix error in internaionalization section where Taiwanese mandarin was listed as a language -- it now just says traditional and Simplified Chinese.

gui.installerGui.IndeterminateProgressDialog: Beep every time the indeterminate progress bar is pulsed (every second) to audibly indicate progress.

userGuide.t2t: add a note to say that the report remaining time shortcut in foobar only works with the default status line configuration.

Fixes #2230.

Updating Iven espeak varient to be louder.
------------- This line and the following will be ignored --------------

modified:
  nvdaHelper/espeak/variants/iven

Fixes #2231.

Minor code cleanups.

Merged main

Minor comment changes.

nvdaHelperRemote: mark minHook.dll for delay loading, but in apiHook_inProcess_initialize preload minHook.dll with LoadLibrary using an absolute path. This allows minHook.dll to be loaded by nvdahelperRemote.dll when in a Win8 Metro style app, even though Metro style apps do not allow loading dependency dlls  from places other than system locations.

Remove redundant import.

updateCheck: also fail to import if in secure mode. This is a fix to stop updates happening on secure desktops such as Windows logon.

Since we're oversimplifying our use of English, thrice -> three times for consistency.

userguide: cosmetic change, thrice changed to three times.

This was done previously but this particular instance seems to have been missed.

installer: fix broken explore NVDA User config start menu shortcut. Fixes #2213

English User Guide: NVDA (when written as the name of the software) should always be spelt with all capitals.
Fixes #2217.

updateCheck: Tell the update server whether this is an installed copy.

NVDA can now automatically check for, download and install updates.
Fixes #73.

updateCheck: Handle multiple update URLs from the server.

documentation: Linguistic and spacing fixes, as well as adding a ticket number.

Update documentation.

updateCheck: Don't do automatic update checks if running as the launcher.

Move donate URL into a constant in gui to avoid duplication.

updateCheck: Add a dialog requesting a donation after the user chooses to download an update.

updateCheck: Remove the updater file after installing the update.

updatecheck:
* Update for repackaged.
* For installed copies, give the user the option to automatically download and install the update. Portable copies just open the link via the default browser.

Merge main.

If creation of a portable copy fails, include the exception string in the message box (e.g. if trying to copy to a readonly directory  you will see error 5 access is denied <path>)

Merged repackaged. NVDA is now distributed as one stand-alone executable which provides the ability to install or create a portable copy at any time. Specifically:
* scons launcher will produce one executable that when run  will: start a temporary copy of NVDA, and show a dialog that will allow to install NVDA, create a portable copy, or continue running.
* A portable version of NVDA can now be installed by choosing Install NVDA under Tools in the NVDA menu.
* an installed version of NVDA can create a portable copy by choosing Create Portable Copy under Tools in the NVDA menu.

Updated readme.txt, changes and user guide.

uninstaller: look for uac.dll in the installer dir for now to save people having to move it.

sconstruct: no longer append '_launcher' to the launcher file name.