Mercurial > pidgin
annotate doc/FAQ @ 694:150214f1d48b
[gaim-migrate @ 704]
bah. oscar sucks a fat one.
committer: Tailor Script <tailor@pidgin.im>
author | Eric Warmenhoven <eric@warmenhoven.org> |
---|---|
date | Wed, 16 Aug 2000 01:53:59 +0000 |
parents | 160b4e3ad516 |
children | a9758452f3c4 |
rev | line source |
---|---|
1 | 1 GAIM: The Pimpin' Penguin IM Clone Thats Good For The Soul |
2 | |
3 Here's the FAQ. PLEASE don't bother me about anything on this list. You | |
4 will be ignored or pointed at the FAQ -- I have been extremely short of time | |
5 lately! Feel free to contact any of us with praise or ideas. If you have | |
6 ideas or bug problems, please use email, because I like to keep records of | |
7 that kinda stuff and I don't log all my conversations. Enjoy gaim! | |
8 - Jim Duchek <jimduchek@ou.edu> | |
9 | |
531 | 10 Revision as of 07/17/2000: Please send all reports to |
11 Rob Flynn (rflynn@blueridge.net). Jim Duchek is no longer associated | |
12 with the GAIM Project. | |
13 | |
1 | 14 I. The Protocol |
15 1. Is it the same protocol as the Windows client uses? | |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
16 2. Where can I find info on TOC? |
1 | 17 3. What other clients use this protocol? |
18 4. TCP or UDP? | |
19 5. So the buddy list is stored on the server? | |
20 | |
21 II. The Client | |
22 1. What does 'gaim' stand for? | |
23 2. How do I make multiple groups? | |
24 3. How come there's no file transfer? | |
25 4. Why no AOL logo? | |
26 5. Where are my log files stored? | |
27 6. Can I use my Windows 95 Buddylist with Gaim? | |
28 7. I'm not a native English speaker and I would like a translated | |
29 version of gaim. | |
30 8. I've got a proxy, and I'd like to use GAIM. | |
31 | |
32 III. Problems | |
33 1. WAAAAAH! My sound doesn't work! | |
34 2. My buddy list disappeared! | |
35 3. I click on URLs, but Netscape doesn't popup! | |
36 4. I don't use Netscape. | |
37 5. I'm using the GNOME client. I have a bug. | |
38 6. I have a bug not described here. | |
39 7. I have Mandrake 6.0 and GAIM doesnt work! | |
40 | |
41 IV. Programming | |
42 1. I have a patch for gaim! | |
141 | 43 2. I have a plugin for gaim! |
44 3. Can you teach me how to program GTK? | |
1 | 45 |
46 V. Miscellaneous | |
47 1. Can I talk to you on IM? | |
48 2. I want to write an IM client. Will you help me? | |
49 3. I have money. I need some software written. Can you help? | |
50 4. I have hardware here that's not being used, or money. Can | |
51 you use it? | |
52 5. I would like to send you beer. | |
53 6. Are you going to port this thing to Windows? | |
54 7. Why the GPL? | |
55 8. I use *BSD and I hate the penguin! I want daemon images! | |
56 9. Can I design a logo for you? | |
57 10. What is a wagii? | |
58 11. Speaking of the penguin, I heard a rumour you have a tattoo of | |
59 it. Is that true? | |
60 12. What Window Manager do you use? What distribution do you use? | |
61 What other stupid things can you ask me that don't really matter | |
62 but ya'll ask me anyway? | |
63 13. Is XX a good Harddrive, YY a good monitor and ZZ a good CPU? | |
64 14. Who designed the new logo? | |
65 15. I want to contribute to the effort. Where can I send beer to? | |
66 | |
67 I. The Protocol | |
68 1. Is it the same protocol as the Windows client uses? | |
69 No. The Windows client uses Oscar, which is proprietary | |
70 and undocumented. Some people have used network tools and such to figure | |
71 it mostly out -- Look for 'faim'. We use TOC, which is completely open and | |
72 documented. | |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
73 There is some support for libfaim now, which allows gaim to |
329
e2f9fb72fb92
[gaim-migrate @ 339]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
269
diff
changeset
|
74 use Oscar, and it's even becoming usable. Maybe one day it'll be the default |
e2f9fb72fb92
[gaim-migrate @ 339]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
269
diff
changeset
|
75 protocol, but it doesn't look like that's going to happen soon. |
1 | 76 |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
77 2. Where can I find info on TOC? |
141 | 78 In the document called PROTOCOL. It's the version that was |
79 published with AOL's TiK client version 0.75, which appears to be the last | |
80 one ever published. | |
1 | 81 |
82 3. What other clients use this protocol? | |
141 | 83 There are a few other Unix programs that use it, I think. I |
84 really couldn't tell you though. AOL used to keep a list of them, but no more. | |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
85 I think some of them are Everybuddy and Jabber. Oh yeah, TiK is still around. |
1 | 86 |
87 4. TCP or UDP? | |
88 TCP. | |
89 | |
90 5. So the buddy list is stored on the server? | |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
91 Yep. Fortunately for you, when the server decides to *not* store |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
92 it any more, gaim keeps a cached copy. |
1 | 93 |
94 | |
95 II. The Client | |
96 1. What does 'gaim' stand for? | |
97 It's basically the letter 'g' tacked on to the beginning of | |
98 'AIM' (which is fairly obvious). G stands for all sorts of good things. | |
99 Girls, Godzilla, GTK, graham crackers, whatever. | |
100 | |
101 2. How do I make multiple groups? | |
102 When adding a new buddy, you just type in a new group name. | |
103 Future versions intend to handle this and renaming groups better. | |
104 | |
105 3. How come there's no file transfer? | |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
106 There is, it's just that you can't request for the transfer to |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
107 take place. Only people who use the Oscar protocol can, so you're out of luck |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
108 there. At least you can get and send files. |
1 | 109 |
110 4. Why no AOL logo? | |
111 AOL's legal staff told us no-no. | |
112 | |
113 5. Where are my log files stored? | |
114 After you select `log all conversations' you may be wondering | |
115 where your log files are stored. Well, they are currently, by default, stored | |
116 under $HOME/.gaim/YourScreenName/. If your screen name is Zilding then you | |
117 will find your logs under: $HOME/.gaim/Zilding/. This will eventually become | |
118 configurable. | |
119 | |
120 6. Can I use my Windows 95 buddylist with Gaim? | |
121 Well, you are in luck. As of the 0.9.5 release there is a | |
122 small perl script called 'buddytrans' that is included with the distribution. | |
123 If you installed the RPM copy of GAIM then you can find the script in | |
124 /usr/bin/buddytrans. The correct script syntax is: | |
125 buddytrans buddy.lst gaim.list. You can then import `gaim.list' from inside | |
126 gaim. This will eventually be fully incorporated into GAIM and the script | |
127 will no longer be needed. | |
128 | |
129 7. I'm not a native English speaker and I would like a translated | |
130 version of gaim. | |
131 By all means, IM me at 'Zilding' or email me at | |
132 jimduchek@ou.edu. I'm working on standard GNU locale support for the next | |
133 version of gaim, and I'm going to need translations. If you can do a | |
134 translation for us, I'd greatly appreciate it! Just let me know and I'll | |
135 give you detailed instructions on how to do it. | |
136 | |
137 8. I'm behind a proxy, and I'd like to use GAIM. | |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
138 I *think* HTTP and SOCKS v4 proxy support is completely working. |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
139 But since I don't have a SOCKS proxy to test it on, I really couldn't tell you. |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
140 If it doesn't work, a temporary solution is to try setting the TOC port to 21, |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
141 since a lot of proxies will allow that to pass. |
1 | 142 |
143 | |
144 III. Problems | |
145 1. WAAAAAH! My sound doesn't work! | |
146 ./configure should autodetect whether or not you have ESD | |
147 libraries. If you have them it _WILL_ compile with them, if not it won't. | |
148 If it compiles with them, you don't need to be running the ESD daemon, it'll | |
149 automatically fallback to using /dev/dsp. Make sure that gaim has proper | |
141 | 150 permissions to talk to /dev/dsp and /dev/audio though! |
151 The GNOME client now goes through GNOME for its sounds. If | |
152 sounds aren't playing, make sure you've got them turned on in the GNOME | |
153 control center. (The reason this was done was to make it more easily | |
154 configurable.) | |
1 | 155 |
156 2. My buddy list disappeared! | |
157 You didn't back up your buddy list, did you? You never back | |
158 anything up! Oh well. The TOC server loses lists from time to time, it | |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
159 happens to me as well. (And no, I never have a backup ;). Gaim should have |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
160 kept a cache of your buddy list, though, so you shouldn't have this problem any |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
161 more. |
1 | 162 |
163 3. I click on URLs, but Netscape doesn't popup! | |
164 Netscape either needs to be running on the current display | |
165 (gaim should handle remote netscape windows OK.), or 'netscape' needs to be | |
166 in your path. | |
167 | |
168 4. I don't use Netscape. | |
169 I'm very interested in supporting other web browsers. Do | |
170 send me information on how to send a URL to your browser remotely (or point | |
171 me at the source to the browser, I might be able to figure it out.). | |
172 | |
173 5. I'm using the GNOME client. I have a bug. | |
141 | 174 GNOME bugs should be reported to Eric Warmenhoven (IM: |
175 EWarmenhoven (how original)), who is now maintaining that part of the code. If | |
176 you ask the other guys about it, they'll just point you at him. | |
1 | 177 |
178 6. I have a bug not described here. | |
179 Well, it could be a few things. Firstly, you MUST HAVE GTK+ | |
180 VERSION 1.2.3 installed! Please state in any bug report that you ARE using | |
181 1.2.3, otherwise you have a chance of being ignored. With that said ;) | |
182 email me at jimduchek@ou.edu, I would like to hear your bug reports (but | |
141 | 183 please, not your problems installing GTK). Also, sourceforge.net has a bug |
184 tracking system for us at <http://sourceforge.net/bugs/?group_id=235>. | |
1 | 185 |
186 7. I have Mandrake 6.0 and GAIM doesnt work! | |
187 | |
188 Bob Meyer <meyer_rm@yahoo.com> writes: | |
189 | |
190 Here's the solution: | |
191 * Get esound-0.2.12-4mdk.i586.rpm and | |
192 esound-devel-0.2.12-4mdk.i586.rpm from any Mandrake mirror. | |
193 * rpm --upgrade esound-0.2.12-4mdk.i586.rpm | |
194 * rpm -- upgrade esound-devel-0.2.12-4mdk.i586.rpm | |
195 | |
196 Don't use EVIL 'updates' tool. It's broke.. really bad. | |
197 | |
198 Mandrake 6.1, with its newer libraries, appears to fix this problem. | |
199 | |
200 IV. Programming | |
201 1. I have a patch for gaim! | |
202 Nice. Think about your patch though. First, does it have | |
203 to do with AIM? I won't apply patches for stock tickers, search engines, | |
141 | 204 etc. Rewrite it as a plug-in if you really want bloat like that. |
1 | 205 Second, is it useful? A lot of patches I get are horribly unuseful except |
206 in very specific situations (ie YOUR situation). Thirdly, your code | |
207 will not retain your copyright. All code submitted must be protected by | |
208 the GPL and the copyright will be given to Mark Spencer. If you don't | |
209 like this, don't send me your patches. You will be given authorship credit, | |
210 don't worry -- I just want a homogenous copyright on the program. Lastly, | |
211 does your code match the coding style already present in gaim? I like my | |
212 brackets where I like them. I do NOT like, in fact I positively HATE, I | |
213 DESPISE, with a PASSION, the convention of variablesLikeThis. And | |
214 functionsLikeThis. If you do that, fine. It's great. But guess what? | |
215 This is C. C programmers don't write like that. I don't write like that. | |
216 I don't want to READ code like that. I want a homogenous coding style | |
217 on this program, and it's gonna be MY coding style. :) | |
218 Now, if you've managed to get through all that and I haven't | |
141 | 219 discouraged you entirely, send your patches to Rob Flynn (rob@linuxpimps.com). |
1 | 220 |
141 | 221 2. I have a plugin for gaim! |
222 Cool. Before you release it to anyone though, make sure you | |
223 understand that if it does anything useful, it is necessarily licenced under | |
224 the GPL. It's that whole "code that uses GPL'ed code is thus GPL'ed" clause. | |
225 Also, don't send it to us. It's not that we don't want it, but there are | |
226 better places to put it. Head over to sourceforge.net and submit it there | |
227 <http://sourceforge.net/patch/?group_id=235>. It'll be available more quickly | |
228 that way. | |
229 | |
230 3. Can you teach me how to program GTK? | |
1 | 231 Yes, I can. But no, I'm not going to. There's a really |
232 nice tutorial at http://www.gtk.org. If you're a fairly experienced | |
233 programmer, and you get stuck on something odd, IM me, I'm usually happy to | |
234 help. If you had a little BASIC experience in high school and are having | |
235 trouble making a button widget do anything when you click it, buy a book on | |
236 C and read the damn GTK tutorial, I'm a busy person. | |
237 | |
238 | |
239 V. Miscellaneous | |
240 1. Can I talk to you on IM? | |
241 Sure. My IM name is Zilding. The rest of the crew's IM names | |
242 can be found in various places. Keep in mind though, I'm a very busy person. | |
243 This IM name is used for friends as well as for gaim (I don't just log this | |
244 guy in when I want to talk to gaim people). So please, don't IM me just to | |
245 chat, or to answer various Linux questions. I'd like to be able to answer | |
246 everyone's questions on whatever (I usually do know the answer, or at least | |
247 where to find it!) but I just don't have time. Things like this will | |
248 usually be ignored. Other things to keep in mind when talking to me: Don't | |
249 start off with 'I have a gaim question', 'Can I ask a question?', 'Hello?', | |
250 'Are you there?', 'Is this the gaim guy?', 'gaim doesn't work', 'I can't get | |
251 gaim to compile' or anything else like that. Why? If you'll notice in all | |
252 of the above statements, nothing useful has been said. I'm often away from | |
253 my computer. I suggest if you are having a serious problem or you have a | |
254 question, just ASK THE QUESTION, right off, I don't require any preliminary | |
255 stuff. Simply sending me "gaim segfaults when I do 'blah blah click blah'" | |
256 to start a conversation is fine -- I don't consider it rude, please just ask | |
257 the question. If I don't answer within a few minutes, leave your email | |
258 address, I will get back to you sooner or later. Lastly, do NOT abbreviate | |
259 'you' as 'u', 'are' as 'r', 'to' as '2', 'for' as '4', or any of those other | |
260 annoying AOLisms. They bother me greatly, and as I work long hours and am | |
261 an insomniac (probably because I'm such a mean bastard ;), I'm likely to | |
262 make fun of you, or more likely ignore you completely. I don't require | |
263 perfect English but it'd be nice. | |
264 | |
265 | |
266 2. I want to write an IM client. Will you help me? | |
267 No, unless you're writing one commercially. Email me for | |
268 rates -- I'm not all that expensive. :) | |
269 | |
270 3. I have money. I need some software written. Can you help? | |
271 Oh yes. My email address is jimduchek@ou.edu, my IM is Zilding. | |
272 | |
273 4. I have hardware that's not being used, or money. Can you use it? | |
274 Almost always. I'm a broke college student. We're all | |
275 broke here. Flat busted. Money would always help. If you have some useful | |
276 equipment (or even useless equipment! I like old mainframes and | |
277 workstations ;), do send it to us! I might be able to scratch together | |
278 shipping money even. :) | |
279 | |
280 5. I would like to send you beer. | |
281 OK. | |
282 | |
283 6. Are you going to port this thing to Windows? | |
284 I've been mulling it over and playing with cygwin on the | |
285 tiny Windows partition I do have on my laptop (It's required for school), | |
286 but I'm not sure yet. I actually do have a version of gaim running on it | |
287 now, as of 7/20. However, the Win32 port of GTK has some issues that need | |
288 to be resolved before I can even attempt to release this. Some of my WIN32 | |
289 patches are included in this release, usually under an #ifdef _WIN32 (which | |
290 cygwin and I think other windows compilers set). | |
291 | |
292 7. Why the GPL? | |
293 I like the GPL. | |
294 | |
295 8. I use *BSD and I hate the penguin! I want daemon images! | |
329
e2f9fb72fb92
[gaim-migrate @ 339]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
269
diff
changeset
|
296 Quit your complaining! They're there already! I still don't |
269
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
297 understand why ya'll hate the penguin though, maybe it's just jealousy cause |
46b6b894bc48
[gaim-migrate @ 279]
Eric Warmenhoven <eric@warmenhoven.org>
parents:
141
diff
changeset
|
298 our OS gets all the media attention? I kinda like the daemon :) |
1 | 299 |
300 9. Can I design a logo for you? | |
301 Sure! Do your best. Entries may be emailed to: | |
302 gaimlogo@blueridge.net. After we get a nice supply of entries we'll sort | |
303 through them and pick the winner. | |
304 | |
305 10. What is a wagii? | |
306 Interesting question that you ask, there. `Wagii' is the | |
307 official celebratory cry of gaim. Anytime you are feeling happy or excited, | |
308 just remember all of the hard work that we have done to provide you with | |
309 this wonderful, free piece of software -- as the pure, raw, emotion flows | |
310 through you, maybe you too will let out the cry of -- Wagii. | |
311 Its also the sound a Penguin Samurai makes :) | |
312 | |
313 11. Speaking of the penguin, I heard a rumour you have a tattoo of | |
314 it. Is that true? | |
315 Hehe. Yes, that is true. He's on my left upper arm. If | |
316 you'd like to see a picture, visit <http://www.woodsoup.org/~sbaker/tux/doc/>. | |
317 It's a 'history of Tux' and there's a pic of my tattoo at the bottom. A pic | |
318 of my tattoo is also in the LIMP, and linux.remotepoint.com. There's also a | |
319 picture of the two matching Tux tattoos that a husband and wife have in | |
320 there. I've heard a rumour someone at Red Hat has one as well. BTW -- no, | |
321 it really didn't hurt, and yes, I was sober ;) | |
322 | |
323 12. What Window Manager do you use? What distribution do you use? | |
324 What other stupid things can you ask me that don't really matter | |
325 but ya'll ask me anyway? | |
326 I use WindowMaker, without any GNOME or KDE bits. I don't | |
327 really use a distro, per se, as it used to be a Red Hat distro a long time | |
328 ago, but since then I've custom-installed by hand from one hard drive to | |
329 another, so it really doesn't resemble Red Hat anymore, and I've written | |
330 most of the rc. scripts from scratch. Please don't ask me Red Hat | |
331 questions, also I hate it when people assume that Red Hat == Linux. | |
332 | |
333 13. Is XX a good harddrive, YY a good monitor, and ZZ a good CPU? | |
334 Hmm, we're kinda poor so we cant be positive... if you wanna | |
335 send us some hardware we'll use it though and tell you how good it is *wink* | |
336 | |
337 14. Who designed the new logo? | |
338 A good guy named Naru Sundar. | |
339 | |
340 15. I want to contribute to the effort. Where can I send beer to? | |
341 IM Zilding or email him at jimduchek@ou.edu. |