Mercurial > pidgin.yaz
annotate doc/connection-signals.dox @ 31028:e492df53a0f3
ca-certs: Add the Go Daddy Class 2 self-signed root. Fixes #12594
There's another copy of this cert that's a ICA up to ValiCert via
some voodoo X.509 hacks, but I went with the self-signed root version
(if someone can rationally explain to me why people use the same
keying material to make "the same" cert but as an ICA instead
of root, please do)
author | Paul Aurich <paul@darkrain42.org> |
---|---|
date | Sun, 10 Oct 2010 05:31:54 +0000 |
parents | 50729e095c3c |
children | 02a2e8183b1d |
rev | line source |
---|---|
6724
aca39e77db85
[gaim-migrate @ 7251]
Christian Hammond <chipx86@chipx86.com>
parents:
6611
diff
changeset
|
1 /** @page connection-signals Connection Signals |
6611 | 2 |
3 @signals | |
4 @signal signing-on | |
5 @signal signed-on | |
30165
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
6 @signal autojoin |
6611 | 7 @signal signing-off |
8 @signal signed-off | |
23588
95a7d1a72fd9
A2B in #pidgin noticed that the link was missing
Ka-Hing Cheung <khc@hxbc.us>
parents:
21365
diff
changeset
|
9 @signal connection-error |
6611 | 10 @endsignals |
11 | |
20807
e0613cf8c493
Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents:
16183
diff
changeset
|
12 @see connection.h |
e0613cf8c493
Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents:
16183
diff
changeset
|
13 |
6611 | 14 <hr> |
15 | |
16 @signaldef signing-on | |
17 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
6724
diff
changeset
|
18 void (*signing_on)(PurpleConnection *gc); |
6611 | 19 @endsignalproto |
20 @signaldesc | |
21 Emitted when a connection is about to sign on. | |
22 @param gc The connection that is about to sign on. | |
23 @endsignaldef | |
24 | |
25 @signaldef signed-on | |
26 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
6724
diff
changeset
|
27 void (*signed_on)(PurpleConnection *gc); |
6611 | 28 @endsignalproto |
29 @signaldesc | |
30 Emitted when a connection has signed on. | |
31 @param gc The connection that has signed on. | |
32 @endsignaldef | |
33 | |
30165
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
34 @signaldef autojoin |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
35 @signalproto |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
36 gboolean (*autojoin)(PurpleConnection *gc); |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
37 @endsignalproto |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
38 @signaldesc |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
39 Emitted when a connection has signed on, after the signed-on signal, to |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
40 signal UIs to autojoin chats if they wish. UIs should connect to this |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
41 with @c PURPLE_SIGNAL_PRIORITY_HIGHEST to allow plugins to block this |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
42 signal before the UI sees it and then re-emit it later. |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
43 @param gc The connection that has signed on. |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
44 @return @c TRUE if the signal was handled or @c FALSE otherwise. In |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
45 practice, the return value is irrelevant, as it really only |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
46 exists so plugins can block the UI's autojoin. |
30176
50729e095c3c
Add a @since tag for the new autojoin signal
Richard Laager <rlaager@wiktel.com>
parents:
30165
diff
changeset
|
47 @since 2.7.0 |
30165
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
48 @endsignaldef |
378cceb9131d
Add an autojoin connection signal
Richard Laager <rlaager@wiktel.com>
parents:
27366
diff
changeset
|
49 |
6611 | 50 @signaldef signing-off |
51 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
6724
diff
changeset
|
52 void (*signing_off)(PurpleConnection *gc); |
6611 | 53 @endsignalproto |
54 @signaldesc | |
55 Emitted when a connection is about to sign off. | |
56 @param gc The connection that is about to sign off. | |
57 @endsignaldef | |
58 | |
59 @signaldef signed-off | |
60 @signalproto | |
16183
8cf53d7a0887
Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@wiktel.com>
parents:
6724
diff
changeset
|
61 void (*signed_off)(PurpleConnection *gc); |
6611 | 62 @endsignalproto |
63 @signaldesc | |
64 Emitted when a connection has signed off. | |
65 @param gc The connection that has signed off. | |
66 @endsignaldef | |
67 | |
21365
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
68 @signaldef connection-error |
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
69 @signalproto |
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
70 void (*connection_error)(PurpleConnection *gc, PurpleConnectionError err, const gchar *desc) |
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
71 @endsignalproto |
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
72 @signaldesc |
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
73 Emitted when a connection error occurs, before @ref signed-off. |
27366
73c8e1964eef
A semi-random collection of English spelling and grammatical changes.
Elliott Sales de Andrade <qulogic@pidgin.im>
parents:
23588
diff
changeset
|
74 @param gc The connection on which the error has occurred |
73c8e1964eef
A semi-random collection of English spelling and grammatical changes.
Elliott Sales de Andrade <qulogic@pidgin.im>
parents:
23588
diff
changeset
|
75 @param err The error that occurred |
21365
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
76 @param desc A description of the error, giving more information. |
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
77 @endsignaldef |
3a269007711e
Document connection-error signal.
Will Thompson <will.thompson@collabora.co.uk>
parents:
20807
diff
changeset
|
78 |
6611 | 79 */ |
20807
e0613cf8c493
Add some links from signal documentation back to the documentation for the
Will Thompson <will.thompson@collabora.co.uk>
parents:
16183
diff
changeset
|
80 // vim: syntax=c.doxygen tw=75 et |