Link to issue number:

None - one of the prerequisites for eventual further work on #12971

Summary of the issue:

When trying to generate developer documentation various modules cannot be imported, and as a result it is impossible to generate any documentation from their docstrings.
In most cases this is caused by the fact that they try to import various com interfaces from our comInterfaces package, which cannot work since we set its path in a particular way at runtime.
The example error for one of the modules is as follows:

WARNING: autodoc: failed to import module 'IAccessibleHandler'; the following exception was raised:
cannot import name '_CE3F726E_D1D3_44FE_B995_FF1DB3B48B2B_0_1_3' from 'comtypes.gen' (D:\my_repos\nvda\.venv\lib\site-packages\comtypes\gen\__init__.py)

Description of user facing changes

None

Description of development approach

During developer documentation build our com interfaces directory is appended to the comtypes.gen search path, to match the behavior at runtime.

Testing strategy:

Generated developer documentation - made sure that there are no errors similar to the one shown in the problem description. Checked count of warnings before and after this change - their amount decreased from 532 to 484.

Known issues with pull request:

Since we now generate documentation for some modules which previously weren't importable this PR almost certainly introduces some new warnings. In my opinion any attempt at fixing warnings automatically or making note of which warnings are present and which are new should wait until all our modules can be imported successfully during build of the developer documentation, which is not yet the case.

Change log entries:

None needed

Code Review Checklist:

• Pull Request description:
  • description is up to date
  • change log entries
• Testing:
  • Unit tests
  • System (end to end) tests
  • Manual testing
• API is compatible with existing add-ons.
• Documentation:
  • User Documentation
  • Developer / Technical Documentation
  • Context sensitive help for GUI changes
• UX of all users considered:
  • Speech
  • Braille
  • Low Vision
  • Different web browsers
  • Localization in other languages / culture than English