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