Mercurial > pidgin
view doc/blist-signals.dox @ 9584:fe35f55ee984
[gaim-migrate @ 10427]
" When joining a jabber conference many jabber servers
send a recap of the last 20 or so messages. If you
have sounds enabled, this will result in either 20
sounds in row, or worse if mixing is available, a
horrible mix of 20 overlapping sounds. These recap
messages can be identifed be the presence of the
"jabber:x:delay". This patch identifies delayed
messages, passes that information through flags from
the prpl to the core, and then on to the gui. Detailed
changes:
Add GAIM_MESSAGE_DELAYED to GaimMessageFlags to
indicate a delayed message.
Change gtkconv.c to not play sounds when either
GAIM_MESSAGE_DELAYED or GAIM_MESSAGE_SYSTEM are set.
Add GaimConvChatFlags, parallel to GaimConvImFlags, to
pass flags from protocols to core. Currently contains
two flags:
GAIM_CONV_CHAT_WHISPER
GAIM_CONV_CHAT_DELAYED
Change fourth arg of serv_got_chat_in() from "int
whisper" to "GaimConvChatFlags chatflags".
Change jabber prpl to set delayed flag when the
"jabber:x:delay" element is present. Change toc
protocol since it uses the whisper flag." --Nathan Fredrickson
Date: 2004-07-24 00:49
Sender: marv_sfAccepting Donations
Logged In: YES
user_id=790708
I'm not sure I like naming the flags "DELAYED". I mean
that's okay inside jabber since that's what the jabber
protocol refers to it as, but for the the GAIM_*_DELAYED
flags, I think they should be named something else.
I thought about NOSOUND, but I decided that was wrong,
because the flag should say what kind of message it is, not
what to do with it, that's up to the UI to decide.
What's up with not playing sounds on GAIM_MESSAGE_SYSTEM?
This sounds unrelated to this. Are there times when we want
to play sounds on system messages?
Date: 2004-07-24 09:13
Sender: noif
Logged In: YES
user_id=365548
I purposely did not use a name that implied what the UI
should do with the flag. The only characteristic that makes
these messages unique is that they've been stored in the
server for some period of time and are not current. I'm
open to a better flag name than "DELAYED"... I thought about
"RECAP", but that seemed less generalized than "DELAYED".
As for not playing sounds on GAIM_MESSAGE_SYSTEM, that can
be removed if it's controversial. I think I slipped that
in since the setting of the topic was still playing a sound
every time you joined a jabber conference.
I think we can change the flag name ourselves if something else is better.
committer: Tailor Script <tailor@pidgin.im>
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Sat, 24 Jul 2004 15:18:32 +0000 |
parents | 2583056be3a4 |
children | 201617d49573 |
line wrap: on
line source
/** @page blist-signals Buddy List Signals @signals @signal buddy-away @signal buddy-back @signal buddy-idle @signal buddy-unidle @signal buddy-signed-on @signal buddy-signed-off @signal update-idle @signal blist-node-extended-menu @endsignals <hr> @signaldef buddy-away @signalproto void (*buddy_away)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list goes away. @param buddy The buddy that went away. @endsignaldef @signaldef buddy-back @signalproto void (*buddy_back)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list comes back from being away. @param buddy The buddy that came back from being away. @endsignaldef @signaldef buddy-idle @signalproto void (*buddy_idle)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list becomes idle. @param buddy The buddy that became idle. @endsignaldef @signaldef buddy-unidle @signalproto void (*buddy_unidle)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list returns from being idle. @param buddy The buddy that returned from being idle. @endsignaldef @signaldef buddy-idle-updated @signalproto void (*buddy_idle_updated)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy's idle time changes. The exceptions are when the buddy goes from being idle to being unidle, or from unidle to idle. @param buddy The buddy whose idle time changed. @endsignaldef @signaldef buddy-signed-on @signalproto void (*buddy_signed_on)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list signs on. @param buddy The buddy that signed on. @endsignaldef @signaldef buddy-signed-off @signalproto void (*buddy_signed_off)(struct buddy *buddy); @endsignalproto @signaldesc Emitted when a buddy on your buddy list signs off. @param buddy The buddy that signed off. @endsignaldef @signaldef update-idle @signalproto void (*update_idle)(); @endsignalproto @signaldesc Emitted when the buddy list is refreshed and the idle times are updated. @endsignaldef @signaldef blist-node-extended-menu @signalproto void (*blist_node_extended_menu)(GaimBlistNode *node, GList **menu) @endsignalproto @signaldesc Emitted when a buddlist menu is being constructed @a menu is a pointer to a GList of GaimBlistNodeAction's allowing a plugin to add menu items @endsignaldef */ // vim: syntax=c tw=75 et