comparison libpurple/connection.h @ 32325:af709c6ab032

Remove PurpleConnectionUiOps.report_disconnect
author Mark Doliner <mark@kingant.net>
date Sun, 21 Aug 2011 07:34:02 +0000
parents 3e5bb4e2334c
children c3ea1711c372
comparison
equal deleted inserted replaced
32324:af176bf6ac4c 32325:af709c6ab032
192 * shipped with libpurple.) 192 * shipped with libpurple.)
193 */ 193 */
194 void (*notice)(PurpleConnection *gc, const char *text); 194 void (*notice)(PurpleConnection *gc, const char *text);
195 195
196 /** 196 /**
197 * Called when an error causes a connection to be disconnected.
198 * Called before #disconnected.
199 * @param text a localized error message.
200 * @see #purple_connection_error
201 * @deprecated in favour of
202 * #PurpleConnectionUiOps.report_disconnect_reason.
203 */
204 void (*report_disconnect)(PurpleConnection *gc, const char *text);
205
206 /**
207 * Called when libpurple discovers that the computer's network 197 * Called when libpurple discovers that the computer's network
208 * connection is active. On Linux, this uses Network Manager if 198 * connection is active. On Linux, this uses Network Manager if
209 * available; on Windows, it uses Win32's network change notification 199 * available; on Windows, it uses Win32's network change notification
210 * infrastructure. 200 * infrastructure.
211 */ 201 */
217 */ 207 */
218 void (*network_disconnected)(void); 208 void (*network_disconnected)(void);
219 209
220 /** 210 /**
221 * Called when an error causes a connection to be disconnected. 211 * Called when an error causes a connection to be disconnected.
222 * Called before #disconnected. This op is intended to replace 212 * Called before #disconnected.
223 * #report_disconnect. If both are implemented, this will be called
224 * first; however, there's no real reason to implement both.
225 * 213 *
226 * @param reason why the connection ended, if known, or 214 * @param reason why the connection ended, if known, or
227 * #PURPLE_CONNECTION_ERROR_OTHER_ERROR, if not. 215 * #PURPLE_CONNECTION_ERROR_OTHER_ERROR, if not.
228 * @param text a localized message describing the disconnection 216 * @param text a localized message describing the disconnection
229 * in more detail to the user. 217 * in more detail to the user.
230 * @see #purple_connection_error_reason 218 * @see #purple_connection_error_reason
231 * 219 *
232 * @since 2.3.0 220 * @since 2.3.0
233 */ 221 */
234 void (*report_disconnect_reason)(PurpleConnection *gc, 222 void (*report_disconnect_reason)(PurpleConnection *gc,
235 PurpleConnectionError reason, 223 PurpleConnectionError reason,
236 const char *text); 224 const char *text);
237 225