Files
test/doc/python_api/rst/info_gotcha.rst
Sybren A. Stüvel 58d0b0e4b4 Py Docs: Gotcha chapter on threading
Update the Python API documentation about crashes with multi-threaded
code.

- Move the "threading gotcha" into a file of its own. That way it's
  immediately clear from looking at the Gotcha table of contents that
  threading is not supported.
- Simplify the example code, so that it doesn't access `bpy`.
  Apparently the problem is much wider than just multi-threaded access
  to `bpy`, and involves _all_ Python threads, regardless of what they
  do / access.
- Add some more explanation and move some text from the bottom to the
  top, so that the first-read part (when reading top to bottom) has
  most of the information.

Pull Request: https://projects.blender.org/blender/blender/pulls/139279
2025-05-22 16:23:23 +02:00

20 lines
461 B
ReStructuredText

*******
Gotchas
*******
This document attempts to help you work with the Blender API in areas
that can be troublesome and avoid practices that are known to cause instability.
.. toctree::
:maxdepth: 1
info_gotchas_crashes.rst
info_gotchas_threading.rst
info_gotchas_internal_data_and_python_objects.rst
info_gotchas_operators.rst
info_gotchas_meshes.rst
info_gotchas_armatures_and_bones.rst
info_gotchas_file_paths_and_encoding.rst