diff options
| author | Scott James Remnant <scott@ubuntu.com> | 2009-05-11 22:41:20 +0100 |
|---|---|---|
| committer | Colin Walters <walters@verbum.org> | 2009-07-14 15:37:44 -0400 |
| commit | 390aa034403cd28ab03d12ed75ff486872a9fbc9 (patch) | |
| tree | 664d4ea9bc9dbc7a34204e6602848c86a4d1b6d0 | |
| parent | ecea18c7b2f4d26bfd06170695c40c4fd5998c45 (diff) | |
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 <scott@ubuntu.com>
(cherry picked from commit ce0d932d9be5adec22943dd7b268bd4a165ada64)
| -rw-r--r-- | dbus/dbus-connection.c | 10 |
1 files 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. |