Mercurial > pidgin.yaz

comparison plugins/icq/CHANGES_SINCE_1.0 @ 1432:4c510ca3563f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[gaim-migrate @ 1442] icqlib 1.1.5 committer: Tailor Script <tailor@pidgin.im>
author Eric Warmenhoven <eric@warmenhoven.org>
date Sun, 28 Jan 2001 01:52:27 +0000
parents 0a766047b4fd
children 0ef6603d986e
comparison
equal deleted inserted replaced
1431:0137bacd63c8 1432:4c510ca3563f
1 1
2 This file is intendended to be a list of source incompatable changes have 2 This file is intendended to be a list of source incompatable changes
3 been made since icqlib-1.0.0. 3 that have been made since icqlib-1.0.0.
4 4
5 2000-12-19: ICQLINKs have been reworked. Members that provide no useful 5 2000-12-19: ICQLINKs have been reworked. Members that provide no useful
6 information to the library client have been moved to a private structure 6 information to the library client have been moved to a private structure
7 attached to the public ICQLINK, ICQLINK_private. See icqlib.h. ICQLINK 7 attached to the public ICQLINK, ICQLINK_private. See icqlib.h. ICQLINK
8 memory management now must be performed by the library (which is probably 8 memory management now must be performed by the library (which is probably
15 15
16 2000-12-19: icq_Init and icq_Done have been removed. Use icq_ICQLINKNew 16 2000-12-19: icq_Init and icq_Done have been removed. Use icq_ICQLINKNew
17 and icq_ICQLINKDelete instead. In addition, icq_ICQLINKNew has gained an 17 and icq_ICQLINKDelete instead. In addition, icq_ICQLINKNew has gained an
18 additional parameter: a flag to turn TCP on or off. 18 additional parameter: a flag to turn TCP on or off.
19 19
20 2001-01-16: The chat and file request/session interface has been
21 significantly reworked. icq_RequestNotify now will return
22 ICQ_NOTIFY_SUCCESS as soon as the file or chat *request* is complete, but
23 not before returning a handle to an icq_ChatSession or icq_FileSession.
24 See ICQ_NOTIFY_CHATSESSION and ICQ_NOTIFY_FILESESSION. All future
25 operations on the chat or file session should be performed using this
26 handle and the appropriate icq_ChatSession* or icq_FileSession* functions.
20 27
28 Old function New function
21 29
30 icq_TCPCloseChat icq_ChatSessionClose
31 icq_TCPSendChatData icq_ChatSessionSendData
32 icq_TCPSendChatData_n icq_ChatSessionSendData_n
22 33
34 In addition, notification messages for chat and file sessions come back
35 through two new callbacks: icq_ChatNotify and icq_FileNotify.
36 icq_ChatSession has also been exposed in the public interface, as well as
37 a number of chat status constants.
23 38
39 Old notification New notification
40
41 icq_RequestNotify/ICQ_NOTIFY_CHAT icq_ChatNotify/CHAT_NOTIFY_STATUS
42 icq_RequestNotify/ICQ_NOTIFY_CHATDATA icq_ChatNotify/CHAT_NOTIFY_DATA
43 icq_RequestNotify/ICQ_NOTIFY_SUCCESS icq_ChatNotify/CHAT_NOTIFY_CLOSE
44
45 icq_RequestNotify/ICQ_NOTIFY_FILE icq_FileNotify/FILE_NOTIFY_STATUS
46 icq_RequestNotify/ICQ_NOTIFY_FILEDATA icq_FileNotify/FILE_NOTIFY_DATAPACKET
47 icq_RequestNotify/ICQ_NOTIFY_SUCCESS icq_FileNotify/FILE_NOTIFY_CLOSE
48
49 Finally, some fake file status values now come through seperate
50 FILE_NOTIFY events, and one has been renamed:
51
52 Old status New Notification/Status
53
54 FILE_STATUS_NEW_SPEED icq_FileNotify/FILE_NOTIFY_NEW_SPEED
55 FILE_STATUS_STOP_FILE icq_FileNotify/FILE_NOTIFY_STOP_FILE
56 FILE_STATUS_INITIALIZED FILE_STATUS_INITIALIZING
57
58 2001-01-16: icqlib now reports when it needs read and write ready
59 notifications for sockets through icq_SocketNotify. Install a callback
60 for the icq_SocketNotify function, which takes the following parameters:
61
62 void (*icq_SocketNotify)(int socket, int type, int status);
63
64 socket will be the socket number, type will be either ICQ_SOCKET_READ or
65 ICQ_SOCKET_WRITE, and status will be either true or false, true indicating
66 icqlib now needs notification, and false indicating icqlib no longer needs
67 notification. Your application should use this to install some sort of
68 socket notification object (e.g., in Kicq, we use a QSocketNotifier).
69 When the socket is ready, you should invoke the new
70 icq_HandleReadySocket(socket, type) function.
71
72 This mechanism is completely optional - you can simply set up a timer to
73 call icq_Main every 1/10 of a second or so. This has the disadvantage of
74 wasting CPU cycles and poor TCP file transfer performance, though.
75
76