From 390aa034403cd28ab03d12ed75ff486872a9fbc9 Mon Sep 17 00:00:00 2001 From: Scott James Remnant Date: Mon, 11 May 2009 22:41:20 +0100 Subject: Update documentation now that INT_MAX means no timeout. * dbus/dbus-connection.c (dbus_connection_send_with_reply): Fix documentation now that INT_MAX will not be clamped. (dbus_connection_send_with_reply_and_block): Update documentation too. Signed-off-by: Scott James Remnant (cherry picked from commit ce0d932d9be5adec22943dd7b268bd4a165ada64) --- dbus/dbus-connection.c | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/dbus/dbus-connection.c b/dbus/dbus-connection.c index 53d63070..31a1d99d 100644 --- a/dbus/dbus-connection.c +++ b/dbus/dbus-connection.c @@ -3201,10 +3201,8 @@ reply_handler_timeout (void *data) * * If -1 is passed for the timeout, a sane default timeout is used. -1 * is typically the best value for the timeout for this reason, unless - * you want a very short or very long timeout. There is no way to - * avoid a timeout entirely, other than passing INT_MAX for the - * timeout to mean "very long timeout." libdbus clamps an INT_MAX - * timeout down to a few hours timeout though. + * you want a very short or very long timeout. If INT_MAX is passed for + * the timeout, no timeout will be set and the call will block forever. * * @warning if the connection is disconnected, the #DBusPendingCall * will be set to #NULL, so be careful with this. @@ -3212,7 +3210,7 @@ reply_handler_timeout (void *data) * @param connection the connection * @param message the message to send * @param pending_return return location for a #DBusPendingCall object, or #NULL if connection is disconnected - * @param timeout_milliseconds timeout in milliseconds or -1 for default + * @param timeout_milliseconds timeout in milliseconds, -1 for default or INT_MAX for no timeout * @returns #FALSE if no memory, #TRUE otherwise. * */ @@ -3330,7 +3328,7 @@ dbus_connection_send_with_reply (DBusConnection *connection, * * @param connection the connection * @param message the message to send - * @param timeout_milliseconds timeout in milliseconds or -1 for default + * @param timeout_milliseconds timeout in milliseconds, -1 for default or INT_MAX for no timeout. * @param error return location for error message * @returns the message that is the reply or #NULL with an error code if the * function fails. -- cgit v1.2.3