# HG changeset patch
# User Sebastien Jodogne <s.jodogne@gmail.com>
# Date 1536822219 -7200
# Node ID 1b6497e412e409f362ac58f1ee944d446204b409
# Parent  a47938d99dfaab388a827dbe1036286c79ed3f12
doc

diff -r a47938d99dfa -r 1b6497e412e4 Plugins/Include/orthanc/OrthancCPlugin.h
--- a/Plugins/Include/orthanc/OrthancCPlugin.h	Wed Sep 12 17:52:28 2018 +0200
+++ b/Plugins/Include/orthanc/OrthancCPlugin.h	Thu Sep 13 09:03:39 2018 +0200
@@ -1353,11 +1353,6 @@
    * this method, as long as it returns
    * OrthancPluginJobStepStatus_Continue.
    *
-   * Orthanc starts one dedicated thread per custom job that is
-   * running. It is guaranteed that this method will only be called
-   * from this dedicated thread: As a consequence, it is *not*
-   * mandatory to protect this method by mutexes.
-   *
    * @param job The job of interest.
    * @return The status of execution.
    * @ingroup Toolbox
@@ -6201,6 +6196,16 @@
    *
    * This function creates a custom job to be run by the jobs engine
    * of Orthanc.
+   * 
+   * Orthanc starts one dedicated thread per custom job that is
+   * running. It is guaranteed that all the callbacks will only be
+   * called from this single dedicated thread, in mutual exclusion: As
+   * a consequence, it is *not* mandatory to protect the various
+   * callbacks by mutexes.
+   * 
+   * The custom job can nonetheless launch its own processing threads
+   * on the first call to the "step()" callback, and stop them once
+   * the "stop()" callback is called.
    *
    * @param context The Orthanc plugin context, as received by OrthancPluginInitialize().
    * @param job The job to be executed.