annotate libfaim/README.gaim @ 741:58a6e6e26695

[gaim-migrate @ 751] oscar logins work better (?), aliases in convo windows. committer: Tailor Script <tailor@pidgin.im>
author Eric Warmenhoven <eric@warmenhoven.org>
date Tue, 22 Aug 2000 23:38:47 +0000
parents 58106806ac2b
children 93f4221b4446
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
237
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
1 Hello, your good friend EW here with a nice little notice that I'm sure will
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
2 affect the ten of you who actually read this.
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
3
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
4 I'm going to start trying to get gaim to use Oscar through libfaim. As far as I
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
5 can tell, the only thing it used to be able to do is sign on and receive IMs. I
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
6 updated libfaim to what's currently in the libfaim CVS on sourceforge. As of
248
cfc73b8501a7 [gaim-migrate @ 258]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 247
diff changeset
7 right now, I've been able to implement most of the features libfaim offers.
237
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
8
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
9 I'm going to try to make as few modifications as possible to the libfaim code.
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
10 The only two modifications I'll probably ever make to it are 1) to make my life
283
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
11 easier or 2) to fix a compilation error. That means that what you're getting
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
12 when you enable oscar is basically faimtest (the very instructional program
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
13 included with the libfaim source on sourceforge) with the Gaim GTK front-end.
519
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
14 So far the changes to libfaim that I've made are:
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
15 - remove mkbuildinfo.sh and put the #defines it creates into Makefile.am
641
e947cb269c9d [gaim-migrate @ 651]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 519
diff changeset
16 - add #if HAVE_GETADDRINFO in aim_ft.c for Solaris people
237
6ced2f1c8b24 [gaim-migrate @ 247]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
diff changeset
17
270
cfa39d39dec6 [gaim-migrate @ 280]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 265
diff changeset
18 And finally, a word of warning. Gaim/Faim is VERY buggy. Please, don't use this
cfa39d39dec6 [gaim-migrate @ 280]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 265
diff changeset
19 for anything other than laughs right now. Hopefully we'll get it working better
cfa39d39dec6 [gaim-migrate @ 280]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 265
diff changeset
20 soon (please help!).
250
c5aa7bf99059 [gaim-migrate @ 260]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 249
diff changeset
21
283
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
22 I think I'm ready to start dealing with bugs being reported against it now
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
23 though. If you're going to report a bug, please check first that a) you're using
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
24 the to-the-second absolute latest CVS version, b) it's not in the unsupported
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
25 features/known issues lists below, c) someone hasn't already reported the bug on
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
26 sourceforge (please check BOTH the open and closed bugs), and finally d) that
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
27 you can reproduce it.
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
28
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
29 Also, please *don't* IM me about a bug, as I have a tendency to forget things
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
30 like that. Reporting it on sourceforge is a much better way of reporting bugs,
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
31 because then other people can see that the bug is already known, and it's harder
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
32 for me to forget.
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
33
247
f6e8ea29b24f [gaim-migrate @ 257]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 237
diff changeset
34 CURRENTLY SUPPORTED FEATURES
f6e8ea29b24f [gaim-migrate @ 257]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 237
diff changeset
35 ============================
f6e8ea29b24f [gaim-migrate @ 257]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 237
diff changeset
36 Signing on
258
1eeece1c7b7b [gaim-migrate @ 268]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 256
diff changeset
37 Receiving IMs
247
f6e8ea29b24f [gaim-migrate @ 257]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 237
diff changeset
38 Sending IMs
258
1eeece1c7b7b [gaim-migrate @ 268]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 256
diff changeset
39 Being idle
247
f6e8ea29b24f [gaim-migrate @ 257]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 237
diff changeset
40 Being away/coming back
f6e8ea29b24f [gaim-migrate @ 257]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 237
diff changeset
41 Setting your info
249
810c595258c8 [gaim-migrate @ 259]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 248
diff changeset
42 Getting users' info
519
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
43 Getting users' away messages
281
7b06ba09ffe2 [gaim-migrate @ 291]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 280
diff changeset
44 Chat:
312
3069be4c291e [gaim-migrate @ 322]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 302
diff changeset
45 - joining rooms
3069be4c291e [gaim-migrate @ 322]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 302
diff changeset
46 - leaving rooms
3069be4c291e [gaim-migrate @ 322]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 302
diff changeset
47 - talking
3069be4c291e [gaim-migrate @ 322]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 302
diff changeset
48 - inviting someone
281
7b06ba09ffe2 [gaim-migrate @ 291]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 280
diff changeset
49 - getting invited
7b06ba09ffe2 [gaim-migrate @ 291]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 280
diff changeset
50 - refreshing the chatlist in the preferences dialog
519
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
51 Direct IM (aka IM Image, for sounds and pictures)
280
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
52
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
53 CURRENTLY UNSUPPORTED FEATURES
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
54 ==============================
707
668b4d544afe [gaim-migrate @ 717]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 679
diff changeset
55 Telling the server who's on your permit/deny lists
280
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
56 Warning users/getting warned
258
1eeece1c7b7b [gaim-migrate @ 268]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 256
diff changeset
57 Chat:
280
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
58 - whispering (this will never happen)
248
cfc73b8501a7 [gaim-migrate @ 258]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 247
diff changeset
59 Getting/setting dir info
cfc73b8501a7 [gaim-migrate @ 258]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 247
diff changeset
60 Changing your password
519
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
61 File Transfer (Get/Send)
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
62 Voice Chat
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
63 Buddy Icon
247
f6e8ea29b24f [gaim-migrate @ 257]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 237
diff changeset
64
248
cfc73b8501a7 [gaim-migrate @ 258]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 247
diff changeset
65 KNOWN ISSUES
cfc73b8501a7 [gaim-migrate @ 258]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 247
diff changeset
66 ============
258
1eeece1c7b7b [gaim-migrate @ 268]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 256
diff changeset
67 - Oscar doesn't do whispering in chat rooms any more (and hasn't for quite a
1eeece1c7b7b [gaim-migrate @ 268]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 256
diff changeset
68 while, evidently). So if you want to "whisper" to someone, just IM them.
1eeece1c7b7b [gaim-migrate @ 268]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 256
diff changeset
69
707
668b4d544afe [gaim-migrate @ 717]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 679
diff changeset
70 - The permit/deny list stuff is really warped. I've commented it out; the code
668b4d544afe [gaim-migrate @ 717]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 679
diff changeset
71 in libfaim is untested and it's causing way too many problems.
283
0f14e6d8a51b [gaim-migrate @ 293]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 281
diff changeset
72
519
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
73 - Gaim/TOC can do some RVOUS actions, and Gaim/Faim can do others. This is not
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
74 because there is any difference in the protocols as far as the actual transfer
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
75 is concerned. The only difference is what has been implemented and what hasn't
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
76 been.
280
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
77
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
78 - What *is* protocol-dependent about the RVOUS stuff is that only Oscar can
519
926ba0807a2d [gaim-migrate @ 529]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 503
diff changeset
79 request RVOUS actions, though both can receive them.
280
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
80
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
81 - Warnings and Dir Info are not in libfaim yet, and so are not in Gaim/Faim yet.
e606585a38bd [gaim-migrate @ 290]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 276
diff changeset
82
370
5842aa11ab78 [gaim-migrate @ 380]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 331
diff changeset
83 - There are also FIXME's scattered about gaim. Grep around for those, figure
250
c5aa7bf99059 [gaim-migrate @ 260]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 249
diff changeset
84 out what needs to be fixed, do that sort of thing. :) (Fixing the things listed
c5aa7bf99059 [gaim-migrate @ 260]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 249
diff changeset
85 in KNOWN ISSUES above, or any other bugs you happen to find, is a very good use
c5aa7bf99059 [gaim-migrate @ 260]
Eric Warmenhoven <eric@warmenhoven.org>
parents: 249
diff changeset
86 of your time.) (You didn't hear that from me.)