# HG changeset patch
# User Sebastien Jodogne <s.jodogne@gmail.com>
# Date 1443008340 -7200
# Node ID 0669d05b6de12797cec12d434d1bf1043eb606bf
# Parent  4e56b5a206b76dcd484b16730349e00f74d723bd
warning about OrthancPluginRegisterOnChangeCallback

diff -r 4e56b5a206b7 -r 0669d05b6de1 Plugins/Include/orthanc/OrthancCPlugin.h
--- a/Plugins/Include/orthanc/OrthancCPlugin.h	Wed Sep 23 12:43:05 2015 +0200
+++ b/Plugins/Include/orthanc/OrthancCPlugin.h	Wed Sep 23 13:39:00 2015 +0200
@@ -2167,6 +2167,12 @@
    *
    * This function registers a callback function that is called
    * whenever a change happens to some DICOM resource.
+   *
+   * @warning If your change callback has to call the REST API of
+   * Orthanc, you should make these calls in a separate thread (with
+   * the events passing through a message queue). Otherwise, this
+   * could result in deadlocks in the presence of other plugins or Lua
+   * script.
    * 
    * @param context The Orthanc plugin context, as received by OrthancPluginInitialize().
    * @param callback The callback function.