Mercurial > pidgin
annotate libfaim/README @ 1739:0ddc5418a0b4
[gaim-migrate @ 1749]
i found this really great game, 3dchess, but it hasn't been hacked (that I know of) since april 1999, two years ago. that's too bad, i like playing it.
some girls try too hard.
committer: Tailor Script <tailor@pidgin.im>
author | Eric Warmenhoven <eric@warmenhoven.org> |
---|---|
date | Sat, 21 Apr 2001 12:24:45 +0000 |
parents | 4c5c2fcb83cd |
children |
rev | line source |
---|---|
2 | 1 |
2 libfaim pre-0.90 or so | |
3 ---------------------- | |
4 | |
5 This is libfaim, the purpose of which is to implement as much as the | |
6 AOL AIM/OSCAR protocol as possible (which should be all of it). After | |
1302
4c5c2fcb83cd
[gaim-migrate @ 1312]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
237
diff
changeset
|
7 over two years of development, its still nowhere close. |
2 | 8 |
9 This is not a full client and never will be. libfaim only implements | |
10 the routines to implement a client (ie, there's no user interface). | |
11 | |
12 Status | |
13 ------ | |
14 | |
15 I would not recommend using this version of libfaim in any form yet. It's | |
16 beta-quality and I know it leaks memory quite badly. It seems fairly | |
237 | 17 stable, however. YMMV, YAYOR, etc. I suppose I should say regardless of |
18 that warning, that several clients use it and people use those clients | |
1302
4c5c2fcb83cd
[gaim-migrate @ 1312]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
237
diff
changeset
|
19 on a daily basis (in particular, me). Also, you're probably reading this |
4c5c2fcb83cd
[gaim-migrate @ 1312]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
237
diff
changeset
|
20 from a CVS version, since I haven't made a release in a very long time. |
4c5c2fcb83cd
[gaim-migrate @ 1312]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
237
diff
changeset
|
21 The CVS version changes fairly rapidly when I'm in the mood, so a version |
4c5c2fcb83cd
[gaim-migrate @ 1312]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
237
diff
changeset
|
22 you checked out an hour ago may be better or worse than a version you |
4c5c2fcb83cd
[gaim-migrate @ 1312]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
237
diff
changeset
|
23 check out now. |
2 | 24 |
25 | |
26 Building | |
27 -------- | |
28 | |
29 Everything in this libfaim dist should build cleanly on any UNIX(-like) | |
30 operating system. Originally developed on Linux+glibc. Past versions | |
237 | 31 known to work on Linux+libc5, FreeBSD, HP/UX, Solaris, Mac OS X Server, |
32 Win32 using VC++ 98/6 and others. | |
2 | 33 |
34 libfaim builds as both libfaim.a and libfaim.so. If your platform for | |
35 some reason does not support dynamic libraries (eg, you get errors when | |
36 building libfaim.so), you'll have to tweak the makefiles a bit to get | |
37 the utils/ directory to build. | |
38 | |
39 Otherwise, just do a 'make'. I don't believe I use any specific features | |
40 GNU make, but if something fails, make sure you have it. And bash too. | |
41 | |
42 | |
43 Accessories | |
44 ----------- | |
45 | |
46 In utils/, you'll find a few things extra: | |
47 | |
48 faimtest: very rudimentary front-end. no user interface, but does | |
49 illustrate the basics of logging in and sending/recieving | |
50 messages and buddy list notifications. Potential front- | |
51 end authors start here. | |
52 | |
53 aimpasswd: utility to change an AIM password without using a full | |
54 client. Note that at the time of this writing, this | |
55 didn't work quite right yet. See the top of the code for | |
56 latest status. | |
57 | |
58 License | |
59 ------- | |
60 | |
61 libfaim is covered under my copyright under the terms of the Lesser GNU | |
62 Public License, as documented in the file COPYING in the top level directory. | |
63 | |
64 | |
65 Documentation | |
66 ------------- | |
67 | |
68 Unfortunatly, there is not currently any documentation on the libfaim API. | |
69 Use the source and utils/faimtest/faimtest.c as a reference when coding | |
70 front-ends. | |
71 | |
237 | 72 Mailing Lists |
73 ------------- | |
74 | |
75 Thanks to Sourceforge, we have our mailing lists back. See: | |
76 http://www.sourceforge.org/mail/?group_id=920 for instructions | |
77 on subscribing to the lists: | |
78 | |
79 libfaim-devel: Discussion of libfaim and its developement. | |
80 libfaim-aim-protocol: Discussion of the finer points of OSCAR hacking | |
81 | |
2 | 82 |
83 Contact Info | |
84 ------------ | |
85 | |
237 | 86 The author (Adam Fritzler), can be reached at mid@auk.cx. |
2 | 87 |
88 Front-end information: | |
89 http://www.auk.cx/faim/ | |
90 Protocol information: | |
91 http://www.auk.cx/faim/protocol/ | |
92 |