changeset 1091:e70e9f412627

cont
author Sebastien Jodogne <s.jodogne@gmail.com>
date Thu, 04 Jul 2024 11:09:41 +0200
parents 9fdd3714efc1
children eb6be558334b
files Sphinx/source/plugins/python.rst
diffstat 1 files changed, 8 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/Sphinx/source/plugins/python.rst	Thu Jul 04 11:02:30 2024 +0200
+++ b/Sphinx/source/plugins/python.rst	Thu Jul 04 11:09:41 2024 +0200
@@ -261,9 +261,14 @@
 the plugin. If set to ``true``, the Python GIL (`Global Interpreter
 Lock <https://en.wikipedia.org/wiki/Global_interpreter_lock>`__) is
 released during the calls to the native SDK. **This allows multiple
-Python threads to simultaneously access the Orthanc core.** However,
-this might concurrency issues: Make sure that your Python code is
-**thread-safe** before enabling this option!
+Python threads to simultaneously access the Orthanc core.**
+Internally, this corresponds to the ``Py_BEGIN_ALLOW_THREADS``
+`construction of Python
+<https://docs.python.org/3/c-api/init.html#releasing-the-gil-from-extension-code>`__. However,
+this could possibly introduce concurrency issues: Make sure that your
+Python code is **thread-safe** before enabling this option! Indeed,
+different threads must not modify the Python objects that are used
+during a call to the SDK of Orthanc.
 
 
 .. warning::