Mercurial > pidgin
comparison doc/conversation-signals.dox @ 9587:5e1c76f3d232
[gaim-migrate @ 10430]
" These 2 patches (one or the other, they are mutually
exclusive) fix a slight bug in the
gaim_conv_chat_add_user (it was not emitting the user's
flags in the chat joining/joined signals).
The 1st patch (gaim-0.81cvs-chat-join-signal-fix.patch)
just fixes that bug, and nothing else.
The 2nd patch
(gaim-0.81cvs-chat-join-signal-fix-and-change.patch)
also changes the joining/leaving signals to boolean
signals to allow a plugin to optionally prevent the
display of users joining and leaving chats. This would
allow us to respond to "How do I turn off the display
of users joinging and leaving a chat?" with "Write a
plugin", instead of "You can't"." --Stu Tomlinson - nosnilmot
should we be updating the ChangeLog.API?
committer: Tailor Script <tailor@pidgin.im>
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Sat, 24 Jul 2004 15:26:09 +0000 |
parents | 8b2451878e26 |
children | 60db14d54914 |
comparison
equal
deleted
inserted
replaced
9586:70fe6ef5d3a3 | 9587:5e1c76f3d232 |
---|---|
329 @param conv The IM conversation a buddy is typing in. | 329 @param conv The IM conversation a buddy is typing in. |
330 @endsignaldef | 330 @endsignaldef |
331 | 331 |
332 @signaldef chat-buddy-joining | 332 @signaldef chat-buddy-joining |
333 @signalproto | 333 @signalproto |
334 void (*chat_buddy_joining)(GaimConversation *conv, const char *name, | 334 gboolean (*chat_buddy_joining)(GaimConversation *conv, const char *name, |
335 GaimConvChatBuddyFlags flags); | 335 GaimConvChatBuddyFlags flags); |
336 @endsignalproto | 336 @endsignalproto |
337 @signaldesc | 337 @signaldesc |
338 Emitted when a buddy is joining a chat, before the list of | 338 Emitted when a buddy is joining a chat, before the list of |
339 users in the chat updates to include the new user. | 339 users in the chat updates to include the new user. |
340 @return @c TRUE if the join should be hidden, or @c FALSE otherwise. | |
340 @param conv The chat conversation. | 341 @param conv The chat conversation. |
341 @param name The name of the user that is joining the conversation. | 342 @param name The name of the user that is joining the conversation. |
342 @param flags The flags of the user that is joining the conversation. | 343 @param flags The flags of the user that is joining the conversation. |
343 @endsignaldef | 344 @endsignaldef |
344 | 345 |
368 @param newflags The new flags. | 369 @param newflags The new flags. |
369 @endsignaldef | 370 @endsignaldef |
370 | 371 |
371 @signaldef chat-buddy-leaving | 372 @signaldef chat-buddy-leaving |
372 @signalproto | 373 @signalproto |
373 void (*chat_buddy_leaving)(GaimConversation *conv, const char *name, | 374 gboolean (*chat_buddy_leaving)(GaimConversation *conv, const char *name, |
374 const char *reason); | 375 const char *reason); |
375 @endsignalproto | 376 @endsignalproto |
376 @signaldesc | 377 @signaldesc |
377 Emitted when a user is leaving a chat, before the user list is updated. | 378 Emitted when a user is leaving a chat, before the user list is updated. |
378 This may include an optional reason why the user is leaving. | 379 This may include an optional reason why the user is leaving. |
380 @return @c TRUE if the leave should be hidden, or @c FALSE otherwise. | |
379 @param conv The chat conversation. | 381 @param conv The chat conversation. |
380 @param name The name of the user that is leaving the chat. | 382 @param name The name of the user that is leaving the chat. |
381 @param reason The optional reason why the user is leaving. | 383 @param reason The optional reason why the user is leaving. |
382 @endsignaldef | 384 @endsignaldef |
383 | 385 |