Mercurial > pidgin
annotate doc/sound-signals.dox @ 14089:10e8eb6a4910
[gaim-migrate @ 16712]
Pretty large commit here. Basically I got sick of having to verify
that gc is still valid on all the callback functions for
gaim_proxy_connect(). The fix for this for gaim_proxy_connect() to
return something that allows the connection attempt to be canceled.
It's not quite there yet, but this is a good first step. I changed
gaim_proxy_connect() to return a reference to a new
GaimProxyConnectInfo (this used to be called PHB). Eventually this
can be passed to a function that'll cancel the connection attempt.
I also decided to add an error_cb instead of using connect_cb and
passing a file descriptor of -1. And proxy.c will also pass an
error message to callers which should explain the reason that the
connection attempt failed.
Oh, and proxy.c now never calls gaim_connection_error()
committer: Tailor Script <tailor@pidgin.im>
author | Mark Doliner <mark@kingant.net> |
---|---|
date | Sat, 12 Aug 2006 10:12:43 +0000 |
parents | b0582839cd6c |
children | 8cf53d7a0887 |
rev | line source |
---|---|
12292
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
1 /** @page sound-signals Sound Signals |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
2 |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
3 @signals |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
4 @signal playing-sound-event |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
5 @endsignals |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
6 |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
7 <hr> |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
8 |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
9 @signaldef playing-sound-event |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
10 @signalproto |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
11 gboolean (*playing_sound_event)(GaimSoundEventID event, GaimAccount *account); |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
12 @endsignalproto |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
13 @signaldesc |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
14 Emitted when gaim is going to play a sound event. This can be used to cancel playing sound by returning TRUE. |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
15 @param event The event this sound represents. |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
16 @param account The account the sound is being played for. |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
17 @return @c TRUE if the sound should not be played, or @c FALSE otherwise. |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
18 @endsignaldef |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
19 |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
20 */ |
b0582839cd6c
[gaim-migrate @ 14596]
Etan Reisner <pidgin@unreliablesource.net>
parents:
diff
changeset
|
21 // vim: syntax=c tw=75 et |