doc/connection-signals.dox

Mon, 08 Jun 2009 02:24:49 +0000

author
Elliott Sales de Andrade <qulogic@pidgin.im>
date
Mon, 08 Jun 2009 02:24:49 +0000
changeset 27314
402d25ce01da
parent 23860
53c2e53a3f05
child 27525
579b9d64b364
permissions
-rw-r--r--

Use the JID for adding a chat/buddy because the name is for descriptive
purpose only, and using it will not fill in the Add Chat dialog correctly.
Because the JID is not visible, the user will not know what to actually put
there instead.

6724
e1d416a4a4bc [gaim-migrate @ 7251]
Christian Hammond <chipx86@chipx86.com>
parents: 6611
diff changeset
1 /** @page connection-signals Connection Signals
6611
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
2
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
3 @signals
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
4 @signal signing-on
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
5 @signal signed-on
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
6 @signal signing-off
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
7 @signal signed-off
23860
53c2e53a3f05 A2B in #pidgin noticed that the link was missing
Ka-Hing Cheung <khc@pidgin.im>
parents: 21286
diff changeset
8 @signal connection-error
6611
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
9 @endsignals
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
10
20897
2608e9e07913 Add some links from signal documentation back to the documentation for the
Will Thompson <resiak@pidgin.im>
parents: 16244
diff changeset
11 @see connection.h
2608e9e07913 Add some links from signal documentation back to the documentation for the
Will Thompson <resiak@pidgin.im>
parents: 16244
diff changeset
12
6611
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
13 <hr>
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
14
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
15 @signaldef signing-on
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
16 @signalproto
16244
be35cbf49dfb Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@pidgin.im>
parents: 6724
diff changeset
17 void (*signing_on)(PurpleConnection *gc);
6611
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
18 @endsignalproto
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
19 @signaldesc
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
20 Emitted when a connection is about to sign on.
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
21 @param gc The connection that is about to sign on.
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
22 @endsignaldef
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
23
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
24 @signaldef signed-on
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
25 @signalproto
16244
be35cbf49dfb Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@pidgin.im>
parents: 6724
diff changeset
26 void (*signed_on)(PurpleConnection *gc);
6611
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
27 @endsignalproto
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
28 @signaldesc
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
29 Emitted when a connection has signed on.
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
30 @param gc The connection that has signed on.
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
31 @endsignaldef
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
32
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
33 @signaldef signing-off
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
34 @signalproto
16244
be35cbf49dfb Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@pidgin.im>
parents: 6724
diff changeset
35 void (*signing_off)(PurpleConnection *gc);
6611
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
36 @endsignalproto
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
37 @signaldesc
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
38 Emitted when a connection is about to sign off.
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
39 @param gc The connection that is about to sign off.
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
40 @endsignaldef
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
41
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
42 @signaldef signed-off
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
43 @signalproto
16244
be35cbf49dfb Update the Doxygen signals documentation to match the new struct names.
Richard Laager <rlaager@pidgin.im>
parents: 6724
diff changeset
44 void (*signed_off)(PurpleConnection *gc);
6611
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
45 @endsignalproto
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
46 @signaldesc
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
47 Emitted when a connection has signed off.
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
48 @param gc The connection that has signed off.
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
49 @endsignaldef
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
50
21286
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
51 @signaldef connection-error
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
52 @signalproto
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
53 void (*connection_error)(PurpleConnection *gc, PurpleConnectionError err, const gchar *desc)
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
54 @endsignalproto
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
55 @signaldesc
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
56 Emitted when a connection error occurs, before @ref signed-off.
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
57 @param gc The connection on which the error has occured
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
58 @param err The error that occured
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
59 @param desc A description of the error, giving more information.
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
60 @endsignaldef
759b1949f5ce Document connection-error signal.
Will Thompson <resiak@pidgin.im>
parents: 20897
diff changeset
61
6611
f41aa03e0fba [gaim-migrate @ 7135]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
62 */
20897
2608e9e07913 Add some links from signal documentation back to the documentation for the
Will Thompson <resiak@pidgin.im>
parents: 16244
diff changeset
63 // vim: syntax=c.doxygen tw=75 et

mercurial