diff --git a/docs/telldus-core.dox b/docs/telldus-core.dox
index b3f7fb73..a34afe64 100644
--- a/docs/telldus-core.dox
+++ b/docs/telldus-core.dox
@@ -210,6 +210,12 @@
  * thread used by the application and some measures must be taken to synchronize
  * it with the main thread.
  *
+ * Many devices (for example motion detectors) resends their messages many times
+ * to ensure that they are received correctly. If a deviceeventcallback or
+ * rawdeviceeventcallback in turn is calling a controlling function, for example tdTurnOn,
+ * it may be neccessary to implement some solution to wait for the device to finish its
+ * resending, before executing the controlling function. See how this can be done in the python example.
+ *
  * \subsection sec_events_callbacks Callbacks
  *
  * telldus-core currently implements three different callback function for
@@ -227,6 +233,8 @@
  * etc.
  * - const char *data - For some methods this contains data. For TELLSTICK_DIM
  * this hold the current value.
+ * - int callbackId - id of callback
+ * - void *context - see "Registering for callbacks" for description
  *
  * \subsubsection sec_events_callbacks_devicechangeevent DeviceChangeEvent
  * This event is fired when the data around a device is changed. It can only be
@@ -247,6 +255,8 @@
  *   - TELLSTICK_CHANGE_NAME - Use tdGetName() to read the new name.
  *   - TELLSTICK_CHANGE_PROTOCOL - Use tdGetProtocol() to read the new value.
  *   - TELLSTICK_CHANGE_MODEL - Use tdGetModel() to read the new value.
+ * - int callbackId - id of callback
+ * - void *context - see "Registering for callbacks" for description
  *
  * \subsubsection sec_events_callbacks_rawdeviceevent RawDeviceEvent
  *
@@ -254,6 +264,12 @@
  * any preprocessing. This can be used to get events from devices not already
  * configured.
  *
+ * Parameters:
+ * - const char *data - raw device data
+ * - int controllerId - id of receiving controller, can identify the TellStick if several exists in the system
+ * - int callbackId - id of callback
+ * - void *context - see "Registering for callbacks" for description
+ *
  * \subsection sec_events_example Example
  *
  * \section sec_other_languages Notes using other languages than C/C++