Browse Source

Merge pull request #5472 from skyace65/ThreadWarning

Add a warning about creating threads at runtime
Max Hilbrunner 3 years ago
parent
commit
8f1df2ed82
1 changed files with 6 additions and 0 deletions
  1. 6 0
      tutorials/performance/using_multiple_threads.rst

+ 6 - 0
tutorials/performance/using_multiple_threads.rst

@@ -53,6 +53,12 @@ Even if the function has returned already, the thread must collect it, so call
 :ref:`Thread.wait_to_finish()<class_Thread_method_wait_to_finish>`, which will
 :ref:`Thread.wait_to_finish()<class_Thread_method_wait_to_finish>`, which will
 wait until the thread is done (if not done yet), then properly dispose of it.
 wait until the thread is done (if not done yet), then properly dispose of it.
 
 
+.. warning::
+
+    Creating threads at run-time is slow on Windows and should be avoided to
+    prevent stuttering. Semaphores, explained later on this page, should be used
+    instead.
+
 Mutexes
 Mutexes
 -------
 -------