nvda
4721336f - Mark globalVars for deprecation (#14050)

Commit
3 years ago
Mark globalVars for deprecation (#14050) Supersedes #14037 See also #14049 Summary of the issue: #14037 was closed because there was no way to preserve backwards compatibility. This is the case for any module level variable which the NVDA API expects to support assignment (see also #14049). globalVars contains many NVDA state variables which should not be changed by add-on authors. As a result, globalVars should eventually be deprecated, in favour of encapsulation of these variables. This will make retaining backwards compatibility possible in the future. Description of user facing changes None Description of development approach Added a deprecation warning and strategy to the docstring of globalVars. Encapsulated some less used globalVars to provide an example of what the future API should look like. runningAsSource was moved from globalVars as this is an unreleased variable. (#14015) _allowDeprecatedAPI was moved as it is internal code.
Author
Parents
Loading