Document ownership of reference in dbus_connection_send_with_reply()

Signed-off-by: Wiebe Cazemier <wiebe@ytec.nl>

diff --git a/dbus/dbus-connection.c b/dbus/dbus-connection.c
index 13f5085fa038c129f2e00b011e8a2a98fbb39f06..53ca34a8be032e903526f269bc707673589782d0 100644 (file)
--- a/dbus/dbus-connection.c
+++ b/dbus/dbus-connection.c
@@ -3403,7 +3403,8 @@ reply_handler_timeout (void *data)
  * @param pending_return return location for a #DBusPendingCall
  * object, or #NULL if connection is disconnected or when you try to
  * send Unix file descriptors on a connection that does not support
- * them.
+ * them. The caller owns this reference, and is responsible for calling
+ * dbus_pending_call_unref() when it is no longer needed.
  * @param timeout_milliseconds timeout in milliseconds, -1 (or
  *  #DBUS_TIMEOUT_USE_DEFAULT) for default or #DBUS_TIMEOUT_INFINITE for no
  *  timeout