| 96 8.6. Can I remove a buddy from my Jabber roster entirely? |
103 8.6. Can I remove a buddy from my Jabber roster entirely? |
| 97 8.7. What does "Cancel Presence Notification" do? |
104 8.7. What does "Cancel Presence Notification" do? |
| 98 |
105 |
| 99 9. Y!M (Yahoo) Protocol |
106 9. Y!M (Yahoo) Protocol |
| 100 |
107 |
| 101 9.1. I cannot connect to yahoo! |
108 9.1. I cannot connect to Yahoo! and get "Invalid Password" errors, or |
| |
109 I'm using a version of Gaim older than 0.79! |
| |
110 9.2. I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why |
| |
111 doesn't Gaim have Yahoo's "Firewall with no proxy" option? |
| |
112 9.3. I blocked someone, but it doesn't seem to have worked. |
| |
113 9.4. Can I get a list of Yahoo! Chat rooms? What about non-US lists? |
| |
114 9.5. What protocol does Gaim use to connect to Yahoo!? |
| 102 |
115 |
| 103 10. MSN Protocol |
116 10. MSN Protocol |
| 104 |
117 |
| 105 10.1. I'm getting lots of "Already in Opposite list" errors on msn, |
118 10.1. I'm getting lots of "Already in Opposite list" errors on MSN, |
| 106 why? |
119 why? |
| 107 10.2. Is there a way to invite more than one person to an MSN chat? |
120 10.2. Is there a way to invite more than one person to an MSN chat? |
| 108 10.3. Is MSNP9 (MSN6) going to be supported? |
121 10.3. Is MSNP9 (MSN6) going to be supported? |
| 109 10.4. Will I be able to use Gaim for MSN after October 15th 2003? (The |
122 Will I be able to use Gaim for MSN after October 15th 2003? |
| 110 day they're preventing third party clients from connecting) |
123 10.4. (The day they're preventing third party clients from |
| 111 10.5. I just upgraded Gaim and the MSN plugin will not load. Why? |
124 connecting) |
| 112 10.6. The MSN plugin won't load, but I have Mozilla NSS! |
125 10.5. I just upgraded Gaim and the MSN plugin will not load. Why? |
| 113 10.7. What does "MSN: S: 911 3" in the debug window mean when I cannot |
126 10.6. The MSN plugin won't load, but I have Mozilla NSS! |
| 114 connect to msn? |
127 10.7. What does "MSN: S: 911 3" in the debug window mean when I |
| |
128 cannot connect to MSN? |
| |
129 10.8. How do I set an MSN avatar? |
| |
130 10.9. What does "Has you" in the buddy tooltip mean? |
| |
131 10.10. How do I set my MSN Friendly Name (the name other users see)? |
| |
132 10.11. What does "Error reading from switchboard server" mean? |
| 115 |
133 |
| 116 11. Gadu-Gadu Protocol |
134 11. Gadu-Gadu Protocol |
| 117 |
135 |
| 118 11.1. What is Gadu-Gadu? |
136 11.1. What is Gadu-Gadu? |
| 119 11.2. Why doesn't it work right? |
137 11.2. Why doesn't it work right? |
| 120 |
138 |
| 121 12. Zephyr Protocol |
139 12. Zephyr Protocol |
| 122 |
140 |
| 123 12.1. What is Zephyr? |
141 12.1. What is Zephyr? |
| 124 12.2. Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with |
142 12.2. Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with |
| 125 "Couldn't initialize zephyr". |
143 "Couldn't initialize zephyr". |
| 126 12.3. Gaim isn't working, but I never got any other zephyr client |
144 12.3. Gaim isn't working, but I never got any other Zephyr client |
| 127 working on this machine. |
145 working on this machine. |
| 128 |
146 12.4. How do I use Zephyr from behind my firewall, or without |
| 129 13. Trepia Protocol |
147 recompiling with kerberos support if needed? |
| 130 |
148 |
| 131 13.1. I heard Trepia was going to be in 0.65. Where is it? |
149 13. SILC Protocol |
| 132 13.2. Trepia is showing people in Japan, England, etc. on my buddy |
150 |
| 133 list. I thought this was supposed to show people in my area? |
151 13.1. What is SILC? |
| 134 |
152 |
| 135 14. SILC Protocol |
153 14. Novell Protocol |
| 136 |
154 |
| 137 14.1. What is SILC? |
155 14.1. Are there any public servers for Novell? |
| 138 |
156 14.2. I can't seem to get it to work. |
| 139 15. Novell Protocol |
157 |
| 140 |
158 15. Scripts and Plugins |
| 141 15.1. Are there any public servers for Novell? |
159 |
| 142 15.2. I can't seem to get it to work. |
160 15.1. How do I use perl scripts with Gaim? |
| 143 |
161 15.2. How do I compile a plugin for Gaim? |
| 144 16. Scripts and Plugins |
162 15.3. I have a plugin or perl script for Gaim that used to work, but |
| 145 |
163 does not with the current version. |
| 146 16.1. How do I use perl scripts with Gaim? |
164 15.4. Where can I find documentation on writing plugins and Perl |
| 147 16.2. How do I compile a plugin for Gaim? |
|
| 148 16.3. I have a plugin or perl script for Gaim that does not work with |
|
| 149 0.60 or higher. |
|
| 150 16.4. Where can I find documentation on writing plugins and Perl |
|
| 151 scripts? |
165 scripts? |
| 152 |
166 |
| 153 17. Development |
167 16. Development |
| 154 |
168 |
| 155 17.1. Can I help? |
169 16.1. Can I help? |
| 156 17.2. Gaim never leaves a core file. |
170 16.2. Gaim never leaves a core file. |
| 157 17.3. Where should I report bugs? |
171 16.3. Where should I report bugs? |
| 158 17.4. Where should I submit patches? |
172 16.4. Where should I submit patches? |
| 159 17.5. Did you guys reverse engineer it? |
173 16.5. Did you guys reverse engineer it? |
| 160 |
174 |
| 161 18. Misc. Questions |
175 17. Misc. Questions |
| 162 |
176 |
| 163 18.1. Can I IM you guys? |
177 17.1. Can I IM you guys? |
| 164 18.2. Hello? |
178 17.2. Hello? |
| 165 Can I give you money/hardware/other expensive things that can be |
179 Can I give you money/hardware/other expensive things that can be |
| 166 18.3. hocked for cash what with you all being students/ |
180 17.3. hocked for cash what with you all being students/ |
| 167 full-time-workers and helping to produce this wonderful software |
181 full-time-workers and helping to produce this wonderful software |
| 168 instead of studying/sleeping? |
182 instead of studying/sleeping? |
| 169 18.4. Does Gaim support secure instant messaging (encrypted IMs)? |
183 17.4. Does Gaim support secure instant messaging (encrypted IMs)? |
| 170 18.5. Why are the passwords in accounts.xml not encrypted? |
184 17.5. Why are the passwords in accounts.xml not encrypted? |
| 171 18.6. What is gaim-remote? |
185 17.6. What is gaim-remote? |
| 172 18.7. When will the next version of Gaim be released? |
186 17.7. When will the next version of Gaim be released? |
| |
187 17.8. What will the next version be? |
| |
188 17.9. So, can I look forward to mega-sexy super functionality with |
| |
189 Gaim? |
| 173 |
190 |
| 174 +------------------------------------------------------------------------------ |
191 +------------------------------------------------------------------------------ |
| 175 | 1. Compiling and Installing |
192 | 1. Compiling and Installing |
| 176 +------------------------------------------------------------------------------ |
193 +------------------------------------------------------------------------------ |
| 177 |
194 |
| 178 1.1 What does "Gaim" stand for? |
195 1.1 What does "Gaim" stand for? |
| 179 |
196 |
| 180 For freedom! No, seriously, it doesn't stand for anything. It's our name and |
197 For freedom! No, seriously, it doesn't stand for anything. It's our name and |
| 181 we're sticking to it. The two acceptable forms of capitalization are "Gaim" |
198 we're sticking to it. The two acceptable forms of capitalization are "Gaim" |
| 182 and "gaim" (and not "GAIM"). |
199 and "gaim" (and not "GAIM"). |
| 183 |
200 |
| 184 1.2 Why can't I compile Gaim? |
201 1.2 Why can't I compile Gaim? |
| 185 |
202 |
| 186 Make sure you have relatively recent versions of automake, autoconf, and |
203 Make sure you have relatively recent versions of automake, autoconf, and |
| 187 gettext. HOWEVER, generally speaking, having the absolute newest of them is |
204 gettext. HOWEVER, generally speaking, having the absolute newest of them is |
| 188 not as good as having one version short of newest since we might not have |
205 not as good as having one version short of newest since we might not have |
| 189 found work-arounds for the latest set of changes. Also, some versions of |
206 found work-arounds for the latest set of changes. Also, some versions of |
| 190 automake require certain ranges of gettext versions, and we are utterly |
207 automake require certain ranges of gettext versions, and we are utterly |
| 235 /protocols/jabber), and run make from there. Then after you've compiled |
252 /protocols/jabber), and run make from there. Then after you've compiled |
| 236 all of them, change back to src/ and run make gaim. |
253 all of them, change back to src/ and run make gaim. |
| 237 |
254 |
| 238 1.6 I installed a new version of Gaim, but the about window says I'm still |
255 1.6 I installed a new version of Gaim, but the about window says I'm still |
| 239 using the old version. |
256 using the old version. |
| 240 |
257 |
| 241 If you compiled yourself, and you previously had an rpm or a Debian package |
258 If you compiled yourself, and you previously had an RPM or a Debian package |
| 242 installed, you need to remove that first. rpm -e gaim or dpkg -p gaim should |
259 installed, you need to remove that first. rpm -e gaim or dpkg -p gaim should |
| 243 work. |
260 work. |
| 244 |
261 |
| 245 Likewise, if you want to use an RPM or deb and you have previously compiled |
262 Likewise, if you want to use an RPM or deb and you have previously compiled |
| 246 Gaim from source, you need to make uninstall to remove all Gaim files from / |
263 Gaim from source, you need to make uninstall to remove all Gaim files from / |
| 247 usr/local. |
264 usr/local. |
| 248 |
265 |
| 249 1.7 Are the packages signed? If so, by who, and how can I get the key? |
266 1.7 Are the packages signed? If so, by who, and how can I get the key? |
| 250 |
267 |
| 251 Yes, all packages are signed. The signature for the tarball and bzip2 archive |
268 Yes, all packages are signed. The signature for the tarball and bzip2 archive |
| 252 are provided by separate downloads. The RPMs we provide are signed by either |
269 are provided by separate downloads. The RPMs we provide are signed by either |
| 253 Ethan Blanton, Mark Doliner, or Christian Hammond. Usually the Mandrake and |
270 Ethan Blanton, Mark Doliner, or Christian Hammond. Usually the Mandrake and |
| 254 Fedora Core 1 RPMs are signed by Mark Doliner and the Red Hat 8 and 9 RPMs |
271 Fedora Core 1 RPMs are signed by Mark Doliner and the Red Hat 8 and 9 RPMs |
| 255 are signed by Ethan Blanton. The keys can be obtained from any key server. |
272 are signed by Ethan Blanton. The keys can be obtained from any key server. |
| 256 http://pgp.mit.edu/ is popular. |
273 http://pgp.mit.edu/ is popular. |
| 257 |
274 |
| 258 1.8 Can I use Gaim for GTK+1.2? |
275 1.8 Can I use Gaim for GTK+1.2? |
| 259 |
276 |
| 260 As of version 0.60, Gaim has been completely converted to using GTK+2.0. We |
277 As of version 0.60, Gaim has been completely converted to using GTK+2.0. We |
| 261 really really really recommend using the most current version of Gaim and not |
278 really really really recommend using the most current version of Gaim and not |
| 262 a GTK+1.2 version of Gaim. However, if you are living in the '90s, or you're |
279 a GTK+1.2 version of Gaim. However, if you are living in the '90s, or you're |
| 263 afraid GTK+2.0 will insult your mother, you can use Gaim 0.59.9, which is the |
280 afraid GTK+2.0 will insult your mother, you can use Gaim 0.59.9, which is the |
| 264 last version of Gaim that used GTK+1.2. We should warn you though, this |
281 last version of Gaim that used GTK+1.2. We should warn you though, this |
| 265 version of Gaim hasn't had any new features since the middle of 2002, and |
282 version of Gaim hasn't had any new features since the middle of 2002, and |
| 266 some protocols likely do not work. Also, the 0.59.x releases aren't |
283 some protocols likely do not work. Also, the 0.59.x releases aren't |
| 267 breathtakingly beautiful. |
284 breathtakingly beautiful. |
| 268 |
285 |
| 269 1.9 Can I run Gaim on IRIX? |
286 1.9 Can I run Gaim on IRIX? |
| 270 |
287 |
| 271 It has been done before. Please see http://sourceforge.net/forum/forum.php? |
288 It has been done before. Please see http://sourceforge.net/forum/forum.php? |
| 272 thread_id=725839&forum_id=665 at our SourceForge Forum. |
289 thread_id=725839&forum_id=665 at our SourceForge Forum. |
| 273 |
290 |
| 274 1.10 How do I apply the patch "something.diff"? |
291 1.10 Can I run gaim on MacOSX? |
| 275 |
292 |
| |
293 Yes you can, but we do not provide a package for it. The reason being is that |
| |
294 to use gaim on MacOSX, you need to install an X server and gtk, which we are |
| |
295 not prepared to support. You can either compile gaim (and its dependencies) |
| |
296 yourself, or you can use the fink installer available from http://fink.sf.net |
| |
297 . If you would like a native aqua interface or a user-friendly installer, we |
| |
298 suggest trying Adium (http://www.adiumx.com/). |
| |
299 |
| |
300 1.11 How do I apply the patch "something.diff"? |
| |
301 |
| 276 Type patch -p0 < something.diff from inside the gaim directory. If that |
302 Type patch -p0 < something.diff from inside the gaim directory. If that |
| 277 doesn't work, try patch -p1 < something.diff. |
303 doesn't work, try patch -p1 < something.diff. |
| 278 |
304 |
| 279 1.11 Why is gaim crashing when I start it? |
305 1.12 Why is gaim crashing when I start it? |
| 280 |
306 |
| 281 First of all make sure you are using the most recent version of Gaim. If you |
307 First of all make sure you are using the most recent version of Gaim. If you |
| 282 still have problems, try the following: |
308 still have problems, try the following: |
| 283 |
309 |
| 284 * Make sure only one version of Gaim is installed. "whereis gaim" can |
310 • Make sure only one version of Gaim is installed. "whereis gaim" can |
| 285 sometimes be useful for determining this. |
311 sometimes be useful for determining this. |
| 286 * "export GDK_USE_XFT=0" in a terminal and then run Gaim from the same |
312 • "export GDK_USE_XFT=0" in a terminal and then run Gaim from the same |
| 287 terminal. |
313 terminal. |
| 288 * If gaim is not crashing, but is just sitting there not displaying |
314 • If gaim is not crashing, but is just sitting there not displaying |
| 289 anything, try turning off anything else that might be using the sound |
315 anything, try turning off anything else that might be using the sound |
| 290 device (ie xmms) and then starting gaim. If this fixes the problem, it is |
316 device (ie xmms) and then starting gaim. If this fixes the problem, it is |
| 291 a libao issue, not a gaim issue, and can be worked around by the use of |
317 a libao issue, not a gaim issue, and can be worked around by the use of |
| 292 esd or arts. |
318 esd or arts. |
| 293 * Try disabling or deleting any 3rd party plugins, especially anything |
319 • Try disabling or deleting any 3rd party plugins, especially anything |
| 294 related to encryption. |
320 related to encryption. |
| 295 * If you use 0.75 or higher on win32, try deleting tcl.dll. |
321 • If you use 0.75 or higher on win32, try deleting tcl.dll. |
| 296 * If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto |
322 • If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto |
| 297 away preference from -1 to 0. |
323 away preference from -1 to 0. |
| 298 |
324 |
| 299 1.12 Gaim <non-current version> is buggy. Gaim CVS is buggy. Why? |
325 1.13 Gaim <non-current version> is buggy. Gaim CVS is buggy. Why? |
| 300 |
326 |
| 301 Non-current versions have old bugs which may be fixed in the current |
327 Non-current versions have old bugs which may be fixed in the current |
| 302 version--that's why we make new releases. CVS is frequently unusable because |
328 version--that's why we make new releases. CVS is frequently unusable because |
| 303 of changes in the code. Bugs are introduced during the development process |
329 of changes in the code. Bugs are introduced during the development process |
| 304 and are hopefully fixed before a release is made. |
330 and are hopefully fixed before a release is made. |
| 305 |
331 |
| 306 1.13 Why do you always say not to use CVS? |
332 1.14 Why do you always say not to use CVS? |
| 307 |
333 |
| 308 That's a long story. For starters, see the previous question. It is often the |
334 That's a long story. For starters, see the previous question. It is often the |
| 309 case that Gaim CVS exhibits bad behavior due to features and bugfixes which |
335 case that Gaim CVS exhibits bad behavior due to features and bugfixes which |
| 310 are in a transitory state or which are not yet well understood. These bad |
336 are in a transitory state or which are not yet well understood. These bad |
| 311 behaviors range from the harmless (maybe a graphical glitch in a dialog box) |
337 behaviors range from the harmless (maybe a graphical glitch in a dialog box) |
| 312 to the irritating (a particular protocol may not work), to the downright |
338 to the irritating (a particular protocol may not work), to the downright |
| 427 |
453 |
| 428 We are aware that some people feel more comfortable using an interface more |
454 We are aware that some people feel more comfortable using an interface more |
| 429 similar to IM clients they may have used in the past. The 'Big List' can be |
455 similar to IM clients they may have used in the past. The 'Big List' can be |
| 430 disabled by un-checking "Show buddy icons" in the Buddy List preferences. |
456 disabled by un-checking "Show buddy icons" in the Buddy List preferences. |
| 431 |
457 |
| 432 2.7 How do I get sound to work correctly? |
458 2.7 Why do the emblems move around the status icon? |
| 433 |
459 |
| |
460 The four corners of the icon have different precedence. The lower-right is |
| |
461 the highest, lower-left is second-highest, etc. The most important emblem is |
| |
462 in the lower-right, always. When an AOL buddy is not away, the fact that [s] |
| |
463 he's an AOL user is the most important information shown in the icon. The |
| |
464 consistency is that the user can always look in the same place on the icon to |
| |
465 find out what he needs to know. Also, importantly, the lower-right corner |
| |
466 emblem is the only emblem that shows up when "Small list" is on, and only one |
| |
467 emblem would fit. |
| |
468 |
| |
469 2.8 How do I get sound to work correctly? |
| |
470 |
| 434 Gaim uses libao to play sounds. Playing sounds directly through esound or |
471 Gaim uses libao to play sounds. Playing sounds directly through esound or |
| 435 arts is no longer supported. |
472 arts is no longer supported. |
| 436 |
473 |
| 437 Libao is a cross-platform library that allows programs to output PCM audio |
474 `Libao is a cross-platform library that allows programs to output PCM audio |
| 438 data to the native audio devices on a wide variety of platforms. It currently |
475 data to the native audio devices on a wide variety of platforms. It currently |
| 439 supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound |
476 supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound |
| 440 Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts |
477 Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts |
| 441 (Analog Realtime Synthesizer). |
478 (Analog Realtime Synthesizer). ' |
| 442 |
479 |
| 443 To compile Gaim with support for libao you need libao-devel and |
480 To compile Gaim with support for libao you need libao-devel and |
| 444 audiofile-devel. To use libao you need libao and audiofile. If you do not |
481 audiofile-devel. To use libao you need libao and audiofile. If you do not |
| 445 wish to install these packages you can also just change your sound playing |
482 wish to install these packages you can also just change your sound playing |
| 446 method in preferences to Command and use "esdplay %s" or "artsplay %s." |
483 method in preferences to Command and use "esdplay %s" or "artsplay %s." |
| 447 |
484 |
| 448 2.8 How do I make Gaim use ALSA or OSS for playing sounds? What does the |
485 2.9 How do I make Gaim use ALSA or OSS for playing sounds? What does the |
| 449 "Automatic" option do? |
486 "Automatic" option do? |
| 450 |
487 |
| 451 If you choose "Automatic", "ESD", or "Arts", Gaim uses libao to play sounds. |
488 If you choose "Automatic", "ESD", or "Arts", Gaim uses libao to play sounds. |
| 452 Choosing "ESD" or "Arts" forces libao to play sounds using that method, while |
489 Choosing "ESD" or "Arts" forces libao to play sounds using that method, while |
| 453 choosing "Automatic" lets it decide for itself. |
490 choosing "Automatic" lets it decide for itself. |
| 454 |
491 |
| 455 If you choose "Automatic", you can create a file, either /etc/libao.conf or ~ |
492 If you choose "Automatic", you can create a file, either /etc/libao.conf or ~ |
| 456 /.libao, and put one of the following lines in it: |
493 /.libao, and put one of the following lines in it: |
| 457 |
494 |
| |
495 |
| 458 default_driver=alsa |
496 default_driver=alsa |
| 459 |
497 |
| 460 default_driver=oss |
498 default_driver=oss |
| |
499 |
| 461 Other drivers, like alsa09, arts, esd, irix, macosx, and sun might also be |
500 Other drivers, like alsa09, arts, esd, irix, macosx, and sun might also be |
| 462 supported, depending on your platform, and how libao was compiled. See also |
501 supported, depending on your platform, and how libao was compiled. See also |
| 463 'man 5 libao.conf'. |
502 'man 5 libao.conf'. |
| 464 |
503 |
| 465 2.9 Why does Gaim use the same WM_CLASS for every window? It makes it |
504 2.10 Why does Gaim use the same WM_CLASS for every window? It makes it |
| 466 impossible to control window size and placement for the buddy list |
505 impossible to control window size and placement for the buddy list |
| 467 separately from the conversations. |
506 separately from the conversations. |
| 468 |
507 |
| 469 Both strings in the WM_CLASS property are supposed to be the same for all |
508 Both strings in the WM_CLASS property are supposed to be the same for all |
| 470 windows in the same instance of an application. ICCCM states that one is |
509 windows in the same instance of an application. ICCCM states that one is |
| 471 meant to be the same for all instances of the application, the other is meant |
510 meant to be the same for all instances of the application, the other is meant |
| 472 to be unique to that instance of the application. ICCCM also states "If a |
511 to be unique to that instance of the application. ICCCM also states "If a |
| 473 client has multiple windows with identical WM_CLASS and WM_NAME properties, |
512 client has multiple windows with identical WM_CLASS and WM_NAME properties, |
| 491 actions include everything from playing a sound (like an Alert would do) to |
534 actions include everything from playing a sound (like an Alert would do) to |
| 492 sending a message to the person, to executing a command. This action will |
535 sending a message to the person, to executing a command. This action will |
| 493 occur the next time gaim detects the event, ie the next time the person in |
536 occur the next time gaim detects the event, ie the next time the person in |
| 494 your buddy list who you have pounced signs on. |
537 your buddy list who you have pounced signs on. |
| 495 |
538 |
| 496 2.11 Where does gaim store its logs? |
539 2.13 Where does gaim store its logs? |
| 497 |
540 |
| 498 On unix, they are in ~/.gaim/logs, on win32 they are in the $drive\Documents |
541 On unix, they are in ~/.gaim/logs, on win32 they are in the $drive\Documents |
| 499 and Settings\user\Application Data\.gaim\logs directory. In either case, new |
542 and Settings\user\Application Data\.gaim\logs directory. In either case, new |
| 500 logs (new as of 0.73) are in subdirectories that correspond to protocol/ |
543 logs (new as of 0.73) are in subdirectories that correspond to protocol/ |
| 501 yourscreenname/theirscreenname. |
544 yourscreenname/theirscreenname. |
| 502 |
545 |
| 503 2.12 Can I use Gaim for e-mail, blogging, an RSS feed, or something else that |
546 2.14 How can I see my own status with Gaim? |
| |
547 |
| |
548 Currently the only supported method to see your own status is to add yourself |
| |
549 to your buddy list. This works with Aim, ICQ, Y!M, IRC, and some of the |
| |
550 others, and is mimiced by gaim for MSN and Jabber. |
| |
551 |
| |
552 2.15 Can I use Gaim for e-mail, blogging, an RSS feed, or something else that |
| 504 isn't IM-related? |
553 isn't IM-related? |
| 505 |
554 |
| 506 No, you can't. We get requests for this often, but Gaim is indeed a |
555 No, you can't. We get requests for this often, but Gaim is indeed a messaging |
| 507 messenging client. Aside from the capabilities each protocol may support, the |
556 client. Aside from the capabilities each protocol may support, the Gaim |
| 508 Gaim developers have no intention to turn Gaim into a multi-feature Internet |
557 developers have no intention to turn Gaim into a multi-feature Internet |
| 509 client capable of doing everything under the sun. We also won't be helping to |
558 client capable of doing everything under the sun. We also won't be helping to |
| 510 develop plugins to turn it into that. There are many Internet applications |
559 develop plugins to turn it into that. There are many Internet applications |
| 511 available for Linux, Windows, or whatever operating system you use that would |
560 available for Linux, Windows, or whatever operating system you use that would |
| 512 undoubtedly do a better job. |
561 undoubtedly do a better job. |
| 513 |
562 |
| 514 +------------------------------------------------------------------------------ |
563 +------------------------------------------------------------------------------ |
| 515 | 3. Features |
564 | 3. Features |
| 516 +------------------------------------------------------------------------------ |
565 +------------------------------------------------------------------------------ |
| 517 |
566 |
| 518 3.1 Does Gaim support file transfer? |
567 3.1 Does Gaim support file transfer? |
| 519 |
568 |
| 520 Somewhat, yeah. As of 0.79 the following is supported: |
569 Somewhat, yeah. As of 0.79 the following is supported: |
| 521 |
570 |
| 522 * Sending and receiving files on AIM (although it might be a bit buggy) |
571 • Sending and receiving files on AIM (although it might be a bit buggy) |
| 523 * Sending and receiving files on IRC |
572 • Sending and receiving files on IRC |
| 524 * Sending and receiving files on Jabber |
573 • Sending and receiving files on Jabber |
| 525 * Sending and receiving files on MSN |
574 • Sending and receiving files on MSN |
| 526 * Sending and receiving files on SILC |
575 • Sending and receiving files on SILC |
| 527 * Sending and receiving files on Yahoo (sending is limited to 1Mb) |
576 • Sending and receiving files on Yahoo (sending is limited to 1Mb) |
| 528 |
577 |
| 529 Most of the protocols themselves support file transfer, but Gaim has not been |
578 Most of the protocols themselves support file transfer, but Gaim has not been |
| 530 written to support it yet. If you would like file transfer to work better or |
579 written to support it yet. If you would like file transfer to work better or |
| 531 be more complete, get CVS and submit a patch using the generic file transfer |
580 be more complete, get CVS and submit a patch using the generic file transfer |
| 532 API. |
581 API. |
| 533 |
582 |
| 534 3.2 Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or |
583 3.2 Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or |
| 535 something? |
584 something? |
| 536 |
585 |
| 537 Yeah, Gaim supports what is called a system tray icon that conforms to the |
586 Yeah, Gaim supports what is called a system tray icon that conforms to the |
| 538 standards at www.freedesktop.org. This tray icon is supported by Windows, KDE |
587 standards at www.freedesktop.org. This tray icon is supported by Windows, KDE |
| 539 3.1, Gnome 2.2, and Red Hat Gnome 2.0. All you have to do is load the "System |
588 3.1, Gnome 2.2, and Red Hat Gnome 2.0. All you have to do is load the "System |
| 540 Tray Icon" plugin by going to Preferences and then Plugins. |
589 Tray Icon" plugin by going to Preferences and then Plugins. |
| 541 |
590 |
| 548 Due to a flaw in these specs, KDE users may experience trouble with the |
597 Due to a flaw in these specs, KDE users may experience trouble with the |
| 549 background color of the docklet. There is unfortunately nothing we can do |
598 background color of the docklet. There is unfortunately nothing we can do |
| 550 about this. |
599 about this. |
| 551 |
600 |
| 552 3.3 What do those colors in the conversation tab mean? |
601 3.3 What do those colors in the conversation tab mean? |
| 553 |
602 |
| 554 * Red - A message is waiting for you |
603 • Red - A message is waiting for you |
| 555 * Blue - Someone sent a message containing your name |
604 • Blue - Someone sent a message containing your name |
| 556 * Green - The buddy is typing |
605 • Green - The buddy is typing |
| 557 * Yellow - The buddy began typing, and then stopped |
606 • Yellow - The buddy began typing, and then stopped |
| 558 * Gray - There has been a join or a part in that chat, or the buddy has |
607 • Gray - There has been a join or a part in that chat, or the buddy has |
| 559 signed off |
608 signed off |
| 560 |
609 |
| 561 3.4 Will Gaim save my buddy list to the server? |
610 3.4 Will Gaim save my buddy list to the server? |
| 562 |
611 |
| 563 Yes, Gaim saves your buddy list to the server for AIM, ICQ, Jabber, MSN, |
612 Yes, Gaim saves your buddy list to the server for AIM, ICQ, Jabber, MSN, |
| 564 Novell and Yahoo!. |
613 Novell and Yahoo!. |
| 565 |
614 |
| 566 3.5 Can I import or export my buddy list? |
615 3.5 Can I import or export my buddy list? |
| 567 |
616 |
| 568 Sorry, no. Old versions of Gaim supported this, but new versions do not. All |
617 Sorry, no. Old versions of Gaim supported this, but new versions do not. All |
| 569 the code for saving and loading buddy lists was rewritten, and support for |
618 the code for saving and loading buddy lists was rewritten, and support for |
| 570 importing and exporting buddy lists was never re-added. However, with all |
619 importing and exporting buddy lists was never re-added. However, with all |
| 571 major protocols storing their buddy lists on the server, this feature is less |
620 major protocols storing their buddy lists on the server, this feature is less |
| 572 useful today than in the past. |
621 useful today than in the past. |
| 573 |
622 |
| 574 3.6 Does Gaim support animated smileys? |
623 3.6 Does Gaim support animated smileys? |
| 575 |
624 |
| 576 Yes, as of version 0.70 Gaim supports animated smileys. |
625 Yes, as of version 0.70 Gaim supports animated smileys. |
| 577 |
626 |
| 578 3.7 Can I make Gaim group screen names by the person that owns them? You know, |
627 3.7 Can I make Gaim group screen names by the person that owns them? You know, |
| 579 like Trillian's Meta Contacts? |
628 like Trillian's Meta Contacts? |
| 580 |
629 |
| 581 Sure! Right click a buddy on your list and at the bottom of the menu click |
630 Sure! Right click a buddy on your list and at the bottom of the menu click |
| 582 "Expand". Then just drag other screen names to the same person below it. When |
631 "Expand". Then just drag other screen names to the same person below it. When |
| 583 you're done, click on the arrow to collapse them. When the contact is |
632 you're done, click on the arrow to collapse them. When the contact is |
| 584 collapsed, Gaim will select a buddy to display based on the status of the |
633 collapsed, Gaim will select a buddy to display based on the status of the |
| 585 buddies in the contact, and their order. |
634 buddies in the contact, and their order. |
| 586 |
635 |
| |
636 You may need to turn off the preference option to automatically expand |
| |
637 Contacts in order to be able to edit an existing Contact. |
| |
638 |
| 587 3.8 How do I get the old logging back? |
639 3.8 How do I get the old logging back? |
| 588 |
640 |
| 589 The old logging was removed because it was deficient in many ways. There is |
641 The old logging was removed because it was deficient in many ways. There is |
| 590 no way in Gaim itself to revert to the old logging, but the new logging is so |
642 no way in Gaim itself to revert to the old logging, but the new logging is so |
| 591 good you could implement something similar to the old logging as a plugin. |
643 good you could implement something similar to the old logging as a plugin. |
| 592 |
644 |
| 593 3.9 How can I convert my old logs to the new format? |
645 3.9 How can I convert my old logs to the new format? |
| 594 |
646 |
| 595 It's not possible to perfectly convert from the old format to the new format |
647 It's not possible to perfectly convert from the old format to the new format |
| 596 because the old format is missing some information necessary to do that (eg. |
648 because the old format is missing some information necessary to do that (eg. |
| 597 which account the messages were sent from). |
649 which account the messages were sent from). |
| 598 |
650 |
| 599 It shouldn't be too difficult to do a rough conversion using a small script, |
651 It shouldn't be too difficult to do a rough conversion using a small script, |
| 605 +------------------------------------------------------------------------------ |
657 +------------------------------------------------------------------------------ |
| 606 | 4. ICQ Protocol |
658 | 4. ICQ Protocol |
| 607 +------------------------------------------------------------------------------ |
659 +------------------------------------------------------------------------------ |
| 608 |
660 |
| 609 4.1 How do I use ICQ? |
661 4.1 How do I use ICQ? |
| 610 |
662 |
| 611 ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim. To use |
663 ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim. To use |
| 612 it, simply put your account number in the "Screen Name" box and your password |
664 it, simply put your account number in the "Screen Name" box and your password |
| 613 in the "Password" box. Leave the server settings set to the default |
665 in the "Password" box. Leave the server settings set to the default |
| 614 (login.oscar.aol.com and port 5190). |
666 (login.oscar.aol.com and port 5190). |
| 615 |
667 |
| 616 4.2 Can I send SMS messages? |
668 4.2 Can I send SMS messages? |
| 617 |
669 |
| 618 Kind of. See our answer to this for the AIM/ICQ Protocol. |
670 Kind of. See our answer to this for the AIM/ICQ Protocol. |
| 619 |
671 |
| 620 +------------------------------------------------------------------------------ |
672 +------------------------------------------------------------------------------ |
| 621 | 5. TOC Protocol |
673 | 5. TOC Protocol |
| 622 +------------------------------------------------------------------------------ |
674 +------------------------------------------------------------------------------ |
| 623 |
675 |
| 624 5.1 What is the TOC protocol? |
676 5.1 What is the TOC protocol? |
| 625 |
677 |
| 626 It's an AIM protocol used by Quick Buddy and AIM Express. It's recommended |
678 It's an AIM protocol used by Quick Buddy and AIM Express. It's recommended |
| 627 that you don't use it. You should use Gaim's OSCAR (AIM/ICQ) protocol |
679 that you don't use it. You should use Gaim's OSCAR (AIM/ICQ) protocol |
| 628 instead. We keep TOC around in case OSCAR ever stops working. However, we are |
680 instead. We keep TOC around in case OSCAR ever stops working. However, we are |
| 629 not actively supporting this code, and no longer distribute it in binaries. |
681 not actively supporting this code, and no longer distribute it in binaries. |
| 630 |
682 |
| 631 +------------------------------------------------------------------------------ |
683 +------------------------------------------------------------------------------ |
| 632 | 6. AIM/ICQ (OSCAR) Protocol |
684 | 6. AIM/ICQ (OSCAR) Protocol |
| 633 +------------------------------------------------------------------------------ |
685 +------------------------------------------------------------------------------ |
| 634 |
686 |
| 635 6.1 Can I set my profile? |
687 6.1 Can I set my profile? |
| 636 |
688 |
| 637 Yes you can. Go to Tools->Account Actions |
689 Yes you can. Go to Tools->Account Actions |
| 638 |
690 |
| 639 6.2 Can I set a buddy icon? |
691 6.2 Can I set a buddy icon? |
| 640 |
692 |
| 641 Yes. Go to the Account Editor (Tools->Accounts from the buddy list), and |
693 Yes. Go to the Account Editor (Tools->Accounts from the buddy list), and |
| 642 click to "Modify" the AIM/ICQ account you wish to have an icon. Enter the |
694 click to "Modify" the AIM/ICQ account you wish to have an icon. Enter the |
| 643 full path to the image you wish to use in the box labeled "Buddy Icon File." |
695 full path to the image you wish to use in the box labeled "Buddy Icon File." |
| 644 The file must be below 4KB. It can have any dimensions, and can be in any |
696 The file must be below 4KB. It can have any dimensions, and can be in any |
| 645 format. However, if you wish Windows users to see it, it must be in a format |
697 format. However, if you wish Windows users to see it, it must be in a format |
| 646 Windows understands, such as .bmp, .gif, and .jpg. |
698 Windows understands, such as .bmp, .gif, and .jpg. |
| 647 |
699 |
| 648 6.3 Some of my buddies are not showing up as online, why is that? |
700 6.3 Some of my buddies are not showing up as online, why is that? |
| 649 |
701 |
| 650 AOL has set a limit for the maximum number of people you can have in your |
702 AOL has set a limit for the maximum number of people you can have in your |
| 651 buddy list. This number is currently 200. If you don't think you are anywhere |
703 buddy list. This number is currently 200. If you don't think you are anywhere |
| 652 near that limit, it is possible that your server-stored buddy list is |
704 near that limit, it is possible that your server-stored buddy list is |
| 653 corrupt. |
705 corrupt. |
| 654 |
706 |
| 655 If you think this might be the case, you can try signing on with an official |
707 If you think this might be the case, you can try signing on with an official |
| 656 AIM program from AOL. This will usually correct any problems with the list. |
708 AIM program from AOL. This will usually correct any problems with the list. |
| 657 |
709 |
| 658 6.4 Can I use AIM URI's such as "aim:goim?screenname=robflynn"? |
710 6.4 Can I use AIM URI's such as "aim:goim?screenname=robflynn"? |
| 659 |
711 |
| 660 Yes, with Gaim 0.60 and higher, but it can be difficult to set up. You need |
712 Yes, with Gaim 0.60 and higher, but it can be difficult to set up. You need |
| 661 to pass the entire URI to the gaim-remote program (included with gaim). To do |
713 to pass the entire URI to the gaim-remote program (included with gaim). To do |
| 662 this with Gnome 2, run gnome-file-types-properties or "File Types and |
714 this with Gnome 2, run gnome-file-types-properties or "File Types and |
| 663 Programs" from the preferences menu. Add a service with protocol "aim" and |
715 Programs" from the preferences menu. Add a service with protocol "aim" and |
| 664 set the program to gaim-remote uri "%s". This will make AIM URIs work in |
716 set the program to gaim-remote uri "%s". This will make AIM URIs work in |
| 665 Galeon 2. Also, not all types of aim URI's are supported. The ones that are |
717 Galeon 2. Also, not all types of AIM URI's are supported. The ones that are |
| 666 supported are goim, addbuddy, and gochat. |
718 supported are goim, addbuddy, and gochat. |
| 667 |
719 |
| 668 You'll need the "Remote Control" plugin loaded for this to work. |
720 You'll need the "Remote Control" plugin loaded for this to work. |
| 669 |
721 |
| 670 If you use wingaim, this will not work as gaim-remote has not yet been ported |
722 If you use wingaim, this will not work as gaim-remote has not yet been ported |
| 671 over. |
723 over. |
| 672 |
724 |
| 673 6.5 I just changed my buddy icon, and I can't see the new one. |
725 6.5 I just changed my buddy icon, and I can't see the new one. |
| 674 |
726 |
| 675 First, try IMing yourself a few times. Buddy icons are checked when you IM |
727 First, try IMing yourself a few times. Buddy icons are checked when you IM |
| 676 people, so depending on the protocol, that may work. If it still doesn't |
728 people, so depending on the protocol, that may work. If it still doesn't |
| 677 update, check the file size (buddy icons must be smaller than 4kb) and the |
729 update, check the file size (buddy icons must be smaller than 4kb) and the |
| 678 image size (it should be 48x48 or 50x50 in most cases). Also, check the file |
730 image size (it should be 48x48 or 50x50 in most cases). Also, check the file |
| 679 type. GIF or JPEG images are best supported; most other formats do not work |
731 type. GIF or JPEG images are best supported; most other formats do not work |
| 680 at all. If all of that checks out and it still doesn't work, and you're sure |
732 at all. If all of that checks out and it still doesn't work, and you're sure |
| 681 the protocol supports it, try restarting Gaim. |
733 the protocol supports it, try restarting Gaim. |
| 682 |
734 |
| 683 6.6 Does Gaim support DirectIM and IM Image? |
735 6.6 Does Gaim support DirectIM and IM Image? |
| 684 |
736 |
| 685 Yeah, kind of. This tends to be one of the buggier areas of Gaim. If it's not |
737 Yeah, kind of. This tends to be one of the buggier areas of Gaim. If it's not |
| 686 working for you, make sure that at least one person is not behind a firewall. |
738 working for you, make sure that at least one person is not behind a firewall. |
| 687 |
739 |
| 688 6.7 Can I send SMS messages? |
740 6.7 Can I send SMS messages? |
| 689 |
741 |
| 690 Yep, just send an IM to the person's phone number. For example, if the phone |
742 Yep, just send an IM to the person's phone number. For example, if the phone |
| 691 number is (919) 555-1234, you would IM the screen name +19195551234 We think |
743 number is (919) 555-1234, you would IM the screen name +19195551234 We think |
| 692 this should work for countries with a country code of 1 (the United States |
744 this should work for countries with a country code of 1 (the United States |
| 693 and Canada). |
745 and Canada). |
| 694 |
746 |
| 695 Sending SMS messages using "the ICQ method" is not yet supported. |
747 Sending SMS messages using "the ICQ method" is not yet supported. |
| 696 |
748 |
| 697 6.8 Can I add SMS numbers to my buddy list? |
749 6.8 Can I add SMS numbers to my buddy list? |
| 698 |
750 |
| 699 Not currently. This functionality has been broken since around September |
751 Not currently. This functionality has been broken since around September |
| 700 2003. There is no ETA for when it will be fixed. |
752 2003. There is no ETA for when it will be fixed. |
| 701 |
753 |
| 702 6.9 I heard AOL is combining ICQ and AIM, does that mean I can send a message |
754 6.9 I heard AOL is combining ICQ and AIM, does that mean I can send a message |
| 703 from an AIM account to an ICQ account and vice-versa? |
755 from an AIM account to an ICQ account and vice-versa? |
| 704 |
756 |
| 705 Yes, AOL is slowly letting the two messaging networks interoperate with each |
757 Yes, AOL is slowly letting the two messaging networks interoperate with each |
| 706 other. Messaging between the two protocols works as long as the receiver of |
758 other. Messaging between the two protocols works as long as the receiver of |
| 707 the message supports it. Gaim 0.60 supports sending and receiving messages |
759 the message supports it. Gaim 0.60 supports sending and receiving messages |
| 708 between AIM and ICQ, but the person receiving the message must support this. |
760 between AIM and ICQ, but the person receiving the message must support this. |
| 709 Gaim, of course, supports this for both ICQ and AIM accounts. Windows AIM |
761 Gaim, of course, supports this for both ICQ and AIM accounts. Windows AIM |
| 719 network. This means that if you can message an ICQ user from an AIM account, |
771 network. This means that if you can message an ICQ user from an AIM account, |
| 720 then the ICQ user will also show up in your AIM buddy list. So an AIM user |
772 then the ICQ user will also show up in your AIM buddy list. So an AIM user |
| 721 using Windows AIM version 5.2.3139 will show up in an ICQ buddy list. |
773 using Windows AIM version 5.2.3139 will show up in an ICQ buddy list. |
| 722 |
774 |
| 723 6.10 Why can't I connect via either Oscar or TOC? |
775 6.10 Why can't I connect via either Oscar or TOC? |
| 724 |
776 |
| 725 If you are using Linux, your kernel may be using a network option called |
777 If you are using Linux, your kernel may be using a network option called |
| 726 "ECN". It seems that the AOL servers are currently dropping packets marked as |
778 "ECN". It seems that the AOL servers are currently dropping packets marked as |
| 727 "ECN-capable". In order to turn this off, run the command "echo 0 > /proc/sys |
779 "ECN-capable". In order to turn this off, run the command "echo 0 > /proc/sys |
| 728 /net/ipv4/tcp_ecn" as root, or (if your distribution supports it) put the |
780 /net/ipv4/tcp_ecn" as root, or (if your distribution supports it) put the |
| 729 line "net.ipv4.tcp_ecn = 0" in the file /etc/sysctl.conf. |
781 line "net.ipv4.tcp_ecn = 0" in the file /etc/sysctl.conf. |
| 730 |
782 |
| |
783 6.11 English is not my native language, and some of my friends have trouble |
| |
784 seeing my IMs/I have trouble seeing my friends' IMs. How do I use a |
| |
785 native language character set with ICQ? |
| |
786 |
| |
787 Gaim 0.82 and higher allow you to specify a character encoding to use when |
| |
788 conversing with ICQ users. Use the account editor to set this encoding. |
| |
789 |
| 731 +------------------------------------------------------------------------------ |
790 +------------------------------------------------------------------------------ |
| 732 | 7. IRC Protocol |
791 | 7. IRC Protocol |
| 733 +------------------------------------------------------------------------------ |
792 +------------------------------------------------------------------------------ |
| 734 |
793 |
| 735 7.1 How do I join a channel with the IRC plugin? |
794 7.1 How do I join a channel with the IRC plugin? |
| 736 |
795 |
| 737 First create the account, then sign on. After you have signed on, you can use |
796 First create the account, then sign on. After you have signed on, you can use |
| 738 File->Join A Chat on the buddy list to join a channel. In any window, either |
797 File->Join A Chat on the buddy list to join a channel. In any window, either |
| 739 a conversation or a chat, in which your IRC user is the sender, you can also |
798 a conversation or a chat, in which your IRC user is the sender, you can also |
| 740 use /join to connect to a new channel. |
799 use /join to connect to a new channel. |
| 741 |
800 |
| 742 7.2 Is there a way to make Gaim automatically identify me and/or join IRC |
801 7.2 Is there a way to make Gaim automatically identify me and/or join IRC |
| 743 chats on login? |
802 chats on login? |
| 744 |
803 |
| 745 Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it. |
804 Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it. |
| |
805 Do not include "/msg nickserv" as part of the message to send. |
| 746 |
806 |
| 747 In version 0.64 or higher, you can add a chat to your buddy list, right click |
807 In version 0.64 or higher, you can add a chat to your buddy list, right click |
| 748 it, and tell gaim to auto-join it. |
808 it, and tell Gaim to auto-join it. |
| 749 |
809 |
| 750 +------------------------------------------------------------------------------ |
810 +------------------------------------------------------------------------------ |
| 751 | 8. Jabber Protocol |
811 | 8. Jabber Protocol |
| 752 +------------------------------------------------------------------------------ |
812 +------------------------------------------------------------------------------ |
| 753 |
813 |
| 754 8.1 How do I choose which Jabber server to use? |
814 8.1 How do I choose which Jabber server to use? |
| 755 |
815 |
| 756 The Jabber server name is part of your Jabber I.D., such as |
816 The Jabber server name is part of your Jabber I.D., such as |
| 757 somebody@server.name. So when entering your Jabber "screen name", the server |
817 somebody@server.name. So when entering your Jabber "screen name", the server |
| 758 is specified as part of your JID. |
818 is specified as part of your JID. |
| 759 |
819 |
| 760 8.2 How do I change my Jabber resource to be other than the default of "/ |
820 8.2 How do I change my Jabber resource to be other than the default of "/ |
| 761 Gaim"? |
821 Gaim"? |
| 762 |
822 |
| 763 When you create your account in Gaim, simply append the desired resource |
823 When you create your account in Gaim, simply append the desired resource |
| 764 identifier to your Jabber I.D. For example: somebody@server.name/resource |
824 identifier to your Jabber I.D. For example: somebody@server.name/resource |
| 765 |
825 |
| 766 8.3 How do I register a new Jabber account? |
826 8.3 How do I register a new Jabber account? |
| 767 |
827 |
| 768 As of version 0.52 and up: |
828 As of version 0.52 and up: |
| 769 |
829 |
| 770 1. Click "Tools->Accounts->Add" |
830 1. Click "Tools->Accounts->Add" |
| 771 2. Select "Jabber" for the protocol. |
831 2. Select "Jabber" for the protocol. |
| 772 3. Fill in screen name and password as you normally would. THIS IS A |
832 3. Fill in screen name and password as you normally would. THIS IS A |
| 831 |
891 |
| 832 +------------------------------------------------------------------------------ |
892 +------------------------------------------------------------------------------ |
| 833 | 9. Y!M (Yahoo) Protocol |
893 | 9. Y!M (Yahoo) Protocol |
| 834 +------------------------------------------------------------------------------ |
894 +------------------------------------------------------------------------------ |
| 835 |
895 |
| 836 9.1 I cannot connect to yahoo! |
896 9.1 I cannot connect to Yahoo! and get "Invalid Password" errors, or I'm using |
| 837 |
897 a version of Gaim older than 0.79! |
| |
898 |
| 838 Make sure you have at least 0.79. |
899 Make sure you have at least 0.79. |
| 839 |
900 |
| |
901 9.2 I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why doesn't |
| |
902 Gaim have Yahoo's "Firewall with no proxy" option? |
| |
903 |
| |
904 Yahoo!'s firewall with no proxy option connects to Yahoo! by wrapping the |
| |
905 YMSG protocol inside HTTP. Gaim currently doesn't support doing this. |
| |
906 |
| |
907 Gaim does support changing the port it connects to. Try changing the |
| |
908 Pager Port in the Account editor under "Show more options". Ports known to |
| |
909 work are: 20, 23, 25, 80, 119, 5050, 8001, and 8002. While this doesn't work |
| |
910 for as many people as actually tunneling through the HTTP protocol would, it |
| |
911 helps many users. |
| |
912 |
| |
913 9.3 I blocked someone, but it doesn't seem to have worked. |
| |
914 |
| |
915 As of 0.81, this is a known bug in our Yahoo code. We're not sure what |
| |
916 exactly is wrong, but it seems to fail most often when automatically removing |
| |
917 the buddy from your buddy list at the same time it blocks them. It also |
| |
918 always seems to fail if Gaim already thinks the buddy is blocked, and you try |
| |
919 to block them again. |
| |
920 |
| |
921 We suggest manually removing Yahoo! buddies before attempting to block them. |
| |
922 For buddies which Gaim reports are blocked but which are not, unblocking them |
| |
923 and reblocking them from the Tools->Privacy dialog will often get things |
| |
924 working. |
| |
925 |
| |
926 9.4 Can I get a list of Yahoo! Chat rooms? What about non-US lists? |
| |
927 |
| |
928 Tools->Room List will let you list available Yahoo! Chat rooms. Yahoo! does |
| |
929 support hidden and invite-only rooms. If you know the name of the room you |
| |
930 wish to join, and it's not invite only, you can join it via Buddies->Join a |
| |
931 Chat. You can also create a chat room this way, although we don't support |
| |
932 setting the hidden or invite-only type settings. |
| |
933 |
| |
934 To get a non-US room list, you'll need to change the Chat Room List Url in |
| |
935 the account editor, under "Show more options". By default this field contains |
| |
936 "http://insider.msg.yahoo.com/ycontent/". You can add a country code prefix |
| |
937 to the url to fetch the list for another country. For example, for the German |
| |
938 list, you would use "http://de.insider.msg.yahoo.com/ycontent/". |
| |
939 |
| |
940 The list of known country codes for this url is: |
| |
941 |
| |
942 aa => Asia |
| |
943 ar => Argentina |
| |
944 au => Australia |
| |
945 br => Brazil |
| |
946 ca => Canada |
| |
947 cf => Central African Republic |
| |
948 cn => China |
| |
949 de => Germany |
| |
950 dk => Denmark |
| |
951 es => Spain |
| |
952 fr => France |
| |
953 hk => Hong Kong |
| |
954 in => India |
| |
955 it => Italy |
| |
956 kr => Korea, Republic of |
| |
957 mx => Mexico |
| |
958 no => Norway |
| |
959 se => Sweden |
| |
960 sg => Singapore |
| |
961 tw => Taiwan |
| |
962 uk => United Kingdom |
| |
963 |
| |
964 9.5 What protocol does Gaim use to connect to Yahoo!? |
| |
965 |
| |
966 Normally Gaim uses the YMSG protocol, which is the same protocol that the |
| |
967 official Yahoo! clients use. If an attempt to login returns the "Invalid |
| |
968 Password" error code, Gaim automatically tries to log in using the "Web |
| |
969 Messenger" method. This method still uses the YMSG protocol, but |
| |
970 authenticates differently, and connects to a different server. |
| |
971 |
| |
972 While in Web Messenger mode, several things work differently or not at all. |
| |
973 Adding, moving, and removing buddies doesn't work, and the only available |
| |
974 statuses are "Available" and "Invisible". In addition, the Yahoo! server |
| |
975 seems to ignore all Yahoo! Chat related packets. For this reason, we use the |
| |
976 YCHT protocol to join Yahoo! Chat rooms while connected using the Web |
| |
977 Messenger method. |
| |
978 |
| 840 +------------------------------------------------------------------------------ |
979 +------------------------------------------------------------------------------ |
| 841 | 10. MSN Protocol |
980 | 10. MSN Protocol |
| 842 +------------------------------------------------------------------------------ |
981 +------------------------------------------------------------------------------ |
| 843 |
982 |
| 844 10.1 I'm getting lots of "Already in Opposite list" errors on msn, why? |
983 10.1 I'm getting lots of "Already in Opposite list" errors on MSN, why? |
| 845 |
984 |
| 846 The reason this happens is because you have a screen name in both your permit |
985 The reason this happens is because you have a screen name in both your permit |
| 847 list and your deny list. There are two ways to fix this: the correct way and |
986 list and your deny list. There are two ways to fix this: the correct way and |
| 848 the quick way. The correct way is to go to tools->preferences (tools->privacy |
987 the quick way. The correct way is to go to Tools->Privacy, and manually scan |
| 849 in 0.60 or later), and manually scan the list and remove the duplicate |
988 the list and remove the duplicate entries. The quick way is to remove the |
| 850 entries. The quick way is to remove the msn .blist file from the ~/.gaim |
989 blist.xml file from the ~/.gaim directory. Be aware that this contains your |
| 851 directory. This will have a side effect: the msn server stores the screen |
990 buddy list for all accounts, and also stores the "Contact" grouping of |
| 852 names of your contacts, but does not store what group they are in, so you |
991 Buddies. Also, the MSN server stores the screen names of your contacts, but |
| 853 will have to re-sort your msn contacts into the appropriate groups. The buddy |
992 does not store what group they are in, so you will have to re-sort your MSN |
| 854 list is ~/.gaim/blist.xml in 0.60 and later, but be aware that this contains |
993 contacts into the appropriate groups. |
| 855 your buddy list for all accounts, and also stores the "Contact" grouping of |
|
| 856 Buddies. |
|
| 857 |
994 |
| 858 10.2 Is there a way to invite more than one person to an MSN chat? |
995 10.2 Is there a way to invite more than one person to an MSN chat? |
| 859 |
996 |
| 860 Not at this time. When the conversation framework gets another rewrite, it is |
997 Not at this time. When the conversation framework gets another rewrite, it is |
| 861 possible that it will be worked on. Until that time, sorry. :) |
998 possible that it will be worked on. Until that time, sorry. :) |
| 862 |
999 |
| 863 10.3 Is MSNP9 (MSN6) going to be supported? |
1000 10.3 Is MSNP9 (MSN6) going to be supported? |
| 864 |
1001 |
| 865 MSNP9 support has existed in Gaim since 0.69. However, at this point, |
1002 MSNP9 support has existed in Gaim since 0.69. However, at this point, |
| 866 features such as custom smileys and buddy icons aren't yet implemented. |
1003 features such as custom smileys aren't yet implemented. |
| 867 |
1004 |
| 868 10.4 Will I be able to use Gaim for MSN after October 15th 2003? (The day |
1005 10.4 Will I be able to use Gaim for MSN after October 15th 2003? (The day |
| 869 they're preventing third party clients from connecting) |
1006 they're preventing third party clients from connecting) |
| 870 |
1007 |
| 871 Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is supported |
1008 Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is supported |
| 872 after October 15th 2003. |
1009 after October 15th 2003. |
| 873 |
1010 |
| 874 10.5 I just upgraded Gaim and the MSN plugin will not load. Why? |
1011 10.5 I just upgraded Gaim and the MSN plugin will not load. Why? |
| 875 |
1012 |
| 876 You did not compile with SSL support, or the SSL plugin failed to load. As of |
1013 You did not compile with SSL support, or the SSL plugin failed to load. As of |
| 877 protocol version 9, the MSN protocol requires the use of SSL, which gaim |
1014 protocol version 9, the MSN protocol requires the use of SSL, which Gaim |
| 878 provides by either GnuTLS or the combination of NSS and NSPR from the Mozilla |
1015 provides by either GnuTLS or the combination of NSS and NSPR from the Mozilla |
| 879 project. Install one or both of these and recompile Gaim, and see the next |
1016 project. Install one or both of these and recompile Gaim, and see the next |
| 880 question. |
1017 question. |
| 881 |
1018 |
| 882 10.6 The MSN plugin won't load, but I have Mozilla NSS! |
1019 10.6 The MSN plugin won't load, but I have Mozilla NSS! |
| 883 |
1020 |
| 884 Some distributions, including Slackware, install Mozilla NSS to a |
1021 Some distributions, including Slackware, install Mozilla NSS to a |
| 885 non-standard directory. The fix is simple. Edit /etc/ld.so.conf and add /usr/ |
1022 non-standard directory. The fix is simple. Edit /etc/ld.so.conf and add /usr/ |
| 886 lib/mozilla-1.4 (or whatever version you're using, but it's usually 1.4) to |
1023 lib/mozilla-1.4 (or whatever version you're using, but it's usually 1.4) to |
| 887 the file, and run ldconfig as root. Then re-run configure and recompile Gaim. |
1024 the file, and run ldconfig as root. Then re-run configure and recompile Gaim. |
| 888 You may also need to specify where the include file are for NSS and NSPR, see |
1025 You may also need to specify where the include file are for NSS and NSPR, see |
| 889 ./configure --help for the options. |
1026 ./configure --help for the options. |
| 890 |
1027 |
| 891 Mozilla 1.5 has a broken .pc file and does not install the necessary .h |
1028 Mozilla 1.5 has a broken .pc file and does not install the necessary .h |
| 892 files, and so will not be detected. |
1029 files, and so will not be detected. |
| 893 |
1030 |
| 894 See http://gaim.sf.net/faq-ssl.php on getting SSL to work with gaim. |
1031 See http://gaim.sf.net/faq-ssl.php on getting SSL to work with Gaim. |
| 895 |
1032 |
| 896 10.7 What does "MSN: S: 911 3" in the debug window mean when I cannot connect |
1033 10.7 What does "MSN: S: 911 3" in the debug window mean when I cannot connect |
| 897 to msn? |
1034 to MSN? |
| 898 |
1035 |
| 899 See http://gaim.sf.net/911.txt. |
1036 See http://gaim.sf.net/911.txt. |
| 900 |
1037 |
| |
1038 10.8 How do I set an MSN avatar? |
| |
1039 |
| |
1040 Gaim calls these Buddy Icons. Go to Tools->Accounts and click to Modify your |
| |
1041 MSN account. You can drag and drop a file to the resulting dialog, or use the |
| |
1042 Open button. |
| |
1043 |
| |
1044 10.9 What does "Has you" in the buddy tooltip mean? |
| |
1045 |
| |
1046 It shows you if that MSN user has added you to his/her buddy list. "Has you: |
| |
1047 No" does not mean you can't talk to that person. |
| |
1048 |
| |
1049 10.10 How do I set my MSN Friendly Name (the name other users see)? |
| |
1050 |
| |
1051 In the Buddy List window, go to Tools->Account Actions->account->Set Friendly |
| |
1052 Name. |
| |
1053 |
| |
1054 10.11 What does "Error reading from switchboard server" mean? |
| |
1055 |
| |
1056 We haven't fully figured that out yet, but even Microsoft's client seems to |
| |
1057 get similar errors, although with less frequency than we do. See Bug 1060205 |
| |
1058 for further information. |
| |
1059 |
| 901 +------------------------------------------------------------------------------ |
1060 +------------------------------------------------------------------------------ |
| 902 | 11. Gadu-Gadu Protocol |
1061 | 11. Gadu-Gadu Protocol |
| 903 +------------------------------------------------------------------------------ |
1062 +------------------------------------------------------------------------------ |
| 904 |
1063 |
| 905 11.1 What is Gadu-Gadu? |
1064 11.1 What is Gadu-Gadu? |
| 906 |
1065 |
| 907 Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at |
1066 Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at |
| 908 www.gadu-gadu.pl (website in Polish). |
1067 www.gadu-gadu.pl (website in Polish). |
| 909 |
1068 |
| 910 11.2 Why doesn't it work right? |
1069 11.2 Why doesn't it work right? |
| 911 |
1070 |
| 912 We have not had a Gadu-Gadu maintainer in some time and are currently |
1071 We have not had a Gadu-Gadu maintainer in some time and are currently |
| 913 struggling to keep this protocol functional. If you have any problems, you |
1072 struggling to keep this protocol functional. If you have any problems, you |
| 914 will need to submit a patch for them, as we are unlikely to have much luck |
1073 will need to submit a patch for them, as we are unlikely to have much luck |
| 915 fixing it. If things get too bad, we will be forced to remove this protocol |
1074 fixing it. If things get too bad, we will be forced to remove this protocol |
| 916 from the default builds. |
1075 from the default builds. |
| 918 +------------------------------------------------------------------------------ |
1077 +------------------------------------------------------------------------------ |
| 919 | 12. Zephyr Protocol |
1078 | 12. Zephyr Protocol |
| 920 +------------------------------------------------------------------------------ |
1079 +------------------------------------------------------------------------------ |
| 921 |
1080 |
| 922 12.1 What is Zephyr? |
1081 12.1 What is Zephyr? |
| 923 |
1082 |
| 924 Zephyr is an IM protocol developed at MIT for use with Project Athena. Its |
1083 Zephyr is an IM protocol developed at MIT for use with Project Athena. Its |
| 925 features include Kerberos IV authentication, multi-level chats (aka |
1084 features include Kerberos IV authentication, multi-level chats (aka |
| 926 "subscriptions"). You're probably using this because your college/employer/ |
1085 "subscriptions"). You're probably using this because your college/employer/ |
| 927 organization uses it as a local IM/chat system. If not, you probably don't |
1086 organization uses it as a local IM/chat system. If not, you probably don't |
| 928 have a server to connect to. |
1087 have a server to connect to. |
| 929 |
1088 |
| 930 12.2 Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with "Couldn't |
1089 12.2 Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with "Couldn't |
| 931 initialize zephyr". |
1090 initialize zephyr". |
| 932 |
1091 |
| 933 Your site might require the use of Kerberos 4 for authentication, though few |
1092 Your site might require the use of Kerberos 4 for authentication, though few |
| 934 (if any) prepackaged gaim binaries compile it with Kerberos support. The |
1093 prepackaged Gaim binaries use Kerberos. One solution is to compile Gaim with |
| 935 solution is to compile gaim with the --with-krb4 flag to point to the |
1094 the --with-krb4 flag to point to the location of your Kerberos 4 devel files, |
| 936 location of your Kerberos 4 devel files, usually one of /usr, /usr/local, or |
1095 usually one of /usr, /usr/local, or /usr/athena , e.g. ./configure |
| 937 /usr/athena , e.g. ./configure --with-krb4=/path/to/kerberosIV |
1096 --with-krb4=/path/to/kerberosIV |
| 938 |
1097 |
| 939 12.3 Gaim isn't working, but I never got any other zephyr client working on |
1098 12.3 Gaim isn't working, but I never got any other Zephyr client working on |
| 940 this machine. |
1099 this machine. |
| 941 |
1100 |
| 942 You need to have zhm (which comes with the standard zephyr distribution) |
1101 You need to have zhm (which comes with the standard Zephyr distribution) |
| 943 installed, and running, and pointed at your zephyr servers. e.g. |
1102 installed, and running, and pointed at your Zephyr servers. e.g. |
| 944 |
1103 |
| 945 zhm z1.example.com z2.example.com z3.example.com |
1104 zhm z1.example.com z2.example.com z3.example.com |
| 946 |
1105 |
| 947 Alternatively, there might be a firewall or a NAT between you and the zephyr |
1106 Alternatively, there might be a firewall or a NAT between you and the Zephyr |
| 948 servers. Zephyr doesn't work in an environment where incoming connections |
1107 servers. Zephyr generally doesn't work in an environment where incoming |
| 949 cannot be made to arbitrary UDP ports. |
1108 connections cannot be made to arbitrary UDP ports. |
| 950 |
1109 |
| 951 +------------------------------------------------------------------------------ |
1110 12.4 How do I use Zephyr from behind my firewall, or without recompiling with |
| 952 | 13. Trepia Protocol |
1111 kerberos support if needed? |
| 953 +------------------------------------------------------------------------------ |
1112 |
| 954 |
1113 You can use tzc, "Trivial Zephyr Client" and ssh to run Zephyr from a machine |
| 955 13.1 I heard Trepia was going to be in 0.65. Where is it? |
1114 that is behind a firewall or NAT. First, make sure that tzc is installed and |
| 956 |
1115 working on the remote machine. The best version of tzc to use can be found |
| 957 Support for the Trepia protocol was removed right before 0.65's release. It |
1116 http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/ |
| 958 may make it into a future version, but we're not sure yet. |
1117 tzc-cclub_001-3.tar.gz. Second, make sure that you can make a passwordless |
| 959 |
1118 ssh connection to the remote machine and get kerberos 4 tickets. Then, click |
| 960 13.2 Trepia is showing people in Japan, England, etc. on my buddy list. I |
1119 on "Show more options", enable "Use tzc", and set the tzc command to |
| 961 thought this was supposed to show people in my area? |
1120 |
| 962 |
1121 /path/to/ssh username@hostname /path/to/tzc -e "%s" |
| 963 We believe this to be the fault of protocol, not Gaim. As Trepia continues to |
1122 |
| 964 update and refine their protocol, it will become more accurate. If we find |
1123 Alternately, if you have tzc working on your machine, you can enable "Use |
| 965 out otherwise, we will attempt to incorporate the changes necessary to act |
1124 tzc", and set the tzc command to |
| 966 like the official client. |
1125 |
| 967 |
1126 /path/to/tzc -e "%s" |
| 968 +------------------------------------------------------------------------------ |
1127 |
| 969 | 14. SILC Protocol |
1128 +------------------------------------------------------------------------------ |
| 970 +------------------------------------------------------------------------------ |
1129 | 13. SILC Protocol |
| 971 |
1130 +------------------------------------------------------------------------------ |
| 972 14.1 What is SILC? |
1131 |
| 973 |
1132 13.1 What is SILC? |
| |
1133 |
| 974 SILC is an open protocol designed from the ground up with security in mind. |
1134 SILC is an open protocol designed from the ground up with security in mind. |
| 975 It is, or should be, the protocol of choice for the paranoid. See http:// |
1135 It is, or should be, the protocol of choice for the paranoid. See http:// |
| 976 www.silcnet.org for more details. |
1136 www.silcnet.org for more details. |
| 977 |
1137 |
| 978 +------------------------------------------------------------------------------ |
1138 +------------------------------------------------------------------------------ |
| 979 | 15. Novell Protocol |
1139 | 14. Novell Protocol |
| 980 +------------------------------------------------------------------------------ |
1140 +------------------------------------------------------------------------------ |
| 981 |
1141 |
| 982 15.1 Are there any public servers for Novell? |
1142 14.1 Are there any public servers for Novell? |
| 983 |
1143 |
| 984 Not really. This protocol is designed to connect to a Novell GroupWise server |
1144 Not really. This protocol is designed to connect to a Novell GroupWise server |
| 985 running on a corporate LAN. |
1145 running on a corporate LAN. |
| 986 |
1146 |
| 987 15.2 I can't seem to get it to work. |
1147 14.2 I can't seem to get it to work. |
| 988 |
1148 |
| 989 Novell tells us that this protocol plugin will only work with either the |
1149 Novell tells us that this protocol plugin will only work with either the |
| 990 GroupWise Messenger for Linux server or the GroupWise Messenger SP2 (or |
1150 GroupWise Messenger for Linux server or the GroupWise Messenger SP2 (or |
| 991 higher) server for NetWare and Windows. In addition, the server must be |
1151 higher) server for NetWare and Windows. In addition, the server must be |
| 992 secure (SSL enabled). If you have any trouble, see the FAQ question about |
1152 secure (SSL enabled). If you have any trouble, see the FAQ question about |
| 993 submitting bugs, and they will be forwarded to Novell, who have been kind |
1153 submitting bugs, and they will be forwarded to Novell, who have been kind |
| 994 enough to continue active maintenance to the protocol plugin code they |
1154 enough to continue active maintenance to the protocol plugin code they |
| 995 provided us. |
1155 provided us. |
| 996 |
1156 |
| 997 +------------------------------------------------------------------------------ |
1157 +------------------------------------------------------------------------------ |
| 998 | 16. Scripts and Plugins |
1158 | 15. Scripts and Plugins |
| 999 +------------------------------------------------------------------------------ |
1159 +------------------------------------------------------------------------------ |
| 1000 |
1160 |
| 1001 16.1 How do I use perl scripts with Gaim? |
1161 15.1 How do I use perl scripts with Gaim? |
| 1002 |
1162 |
| 1003 Save the perl script to ~/.gaim/plugins/ or $prefix/lib/gaim/, restart Gaim, |
1163 Save the perl script to ~/.gaim/plugins/ or $prefix/lib/gaim/, restart Gaim, |
| 1004 and load the perl script by checking the check box next to its name on the |
1164 and load the perl script by checking the check box next to its name on the |
| 1005 Plugins page in preferences. |
1165 Plugins page in preferences. |
| 1006 |
1166 |
| 1007 16.2 How do I compile a plugin for Gaim? |
1167 15.2 How do I compile a plugin for Gaim? |
| 1008 |
1168 |
| 1009 To compile a plugin for Gaim, you must have Gaim's source code. To download |
1169 To compile a plugin for Gaim, you must have Gaim's source code. To download |
| 1010 Gaim's source code, get the most recent tarball from http:// |
1170 Gaim's source code, get the most recent tarball from http:// |
| 1011 gaim.sourceforge.net/downloads.php (http://gaim.sf.net/downloads.php) and |
1171 gaim.sourceforge.net/downloads.php (http://gaim.sf.net/downloads.php) and |
| 1012 untar it with the command: |
1172 untar it with the command: |
| |
1173 |
| 1013 tar zxvf filename |
1174 tar zxvf filename |
| |
1175 |
| 1014 where filename is the file you downloaded. |
1176 where filename is the file you downloaded. |
| 1015 |
1177 |
| 1016 After you have a Gaim source code tree: |
1178 After you have a Gaim source code tree: |
| 1017 |
1179 |
| 1018 1. Change to the resulting directory and run the command: |
1180 1. Change to the resulting directory and run the command: |
| |
1181 |
| 1019 ./configure |
1182 ./configure |
| |
1183 |
| 1020 This will create the necessary make files. |
1184 This will create the necessary make files. |
| 1021 2. Move the plugin you wish to compile into the plugins/ directory in the |
1185 2. Move the plugin you wish to compile into the plugins/ directory in the |
| 1022 Gaim source code tree. |
1186 Gaim source code tree. |
| 1023 3. Change to the plugins/ directory. |
1187 3. Change to the plugins/ directory. |
| 1024 4. Type: |
1188 4. On Unix/Linux Type: |
| |
1189 |
| 1025 make name.so |
1190 make name.so |
| |
1191 |
| |
1192 where the name of the file you wish to compile is name.c. |
| |
1193 |
| |
1194 On Win32 Type: |
| |
1195 |
| |
1196 make -f Makefile.mingw name.dll |
| |
1197 |
| 1026 where the name of the file you wish to compile is name.c. |
1198 where the name of the file you wish to compile is name.c. |
| 1027 |
1199 |
| 1028 Note well the difference in the extensions. If you type make name.c |
1200 Note well the difference in the extensions. If you type make name.c |
| 1029 instead of name.so, it won't work. |
1201 instead of name.so, it won't work. |
| 1030 |
1202 |
| 1031 5. After make finishes, you can move the plugin to a place that is more |
1203 5. After make finishes, you can move the plugin to a place that is more |
| 1032 convenient. $prefix/lib/gaim is suggested. If you installed Gaim by |
1204 convenient. $prefix/lib/gaim is suggested. If you installed Gaim by |
| 1033 compiling it yourself, $prefix is /usr/local by default. Otherwise, |
1205 compiling it yourself, $prefix is /usr/local by default. Otherwise, |
| 1034 $prefix is /usr. |
1206 $prefix is /usr. |
| 1035 |
1207 |
| 1036 16.3 I have a plugin or perl script for Gaim that does not work with 0.60 or |
1208 15.3 I have a plugin or perl script for Gaim that used to work, but does not |
| 1037 higher. |
1209 with the current version. |
| 1038 |
1210 |
| 1039 The plugin and perl script API has changed in 0.60, which means plugins and |
1211 The plugin and perl script API has changed several times, which means plugins |
| 1040 perl scripts must be modified in order to work. The plugin or perl script |
1212 and perl scripts must be modified in order to work. The plugin or perl script |
| 1041 must be located in $prefix/lib/gaim/ or in ~/.gaim/plugins/, and must |
1213 must be located in $prefix/lib/gaim/ or in ~/.gaim/plugins/, and must |
| 1042 implement the new API, as documented in the HOWTO file in the plugins |
1214 implement the new API, as documented by the make docs command from the root |
| 1043 directory. Plugins and perl scripts are now controlled from preferences. |
1215 of the Gaim source code tree. This will generated html documentation in the |
| 1044 |
1216 doc/html directory. Also note that plugins and perl scripts are now |
| 1045 16.4 Where can I find documentation on writing plugins and Perl scripts? |
1217 controlled from preferences. |
| 1046 |
1218 |
| |
1219 15.4 Where can I find documentation on writing plugins and Perl scripts? |
| |
1220 |
| 1047 If you look in the plugins/ directory in the Gaim source, you should see a |
1221 If you look in the plugins/ directory in the Gaim source, you should see a |
| 1048 HOWTO file with some details for C plugins. Also be sure to check out our |
1222 HOWTO file with some details for C plugins. Also be sure to check out our |
| 1049 online documentation (http://gaim.sf.net/api/index.html). Be especially sure |
1223 online documentation (http://gaim.sf.net/api/index.html). Be especially sure |
| 1050 to look at the Related Pages, which lists all of Gaim's signals, as well as a |
1224 to look at the Related Pages, which lists all of Gaim's signals, as well as a |
| 1051 nice perl script HOWTO. |
1225 nice perl script HOWTO. |
| 1052 |
1226 |
| 1053 This documentation can be generated directly from the Gaim source by running |
1227 This documentation can be generated directly from the Gaim source by running |
| 1054 make docs. You will need doxygen and graphviz dot installed for this to work. |
1228 make docs. You will need doxygen and graphviz dot installed for this to work. |
| 1055 |
1229 |
| 1056 +------------------------------------------------------------------------------ |
1230 +------------------------------------------------------------------------------ |
| 1057 | 17. Development |
1231 | 16. Development |
| 1058 +------------------------------------------------------------------------------ |
1232 +------------------------------------------------------------------------------ |
| 1059 |
1233 |
| 1060 17.1 Can I help? |
1234 16.1 Can I help? |
| 1061 |
1235 |
| 1062 But of course. Just find something that's bugging you and fix it. There are a |
1236 But of course. Just find something that's bugging you and fix it. There are a |
| 1063 slew of a bug reports in Gaim's bug report tracker - you could pick one and |
1237 slew of a bug reports in Gaim's bug report tracker - you could pick one and |
| 1064 try to tackle it and submit a patch. You could also help with general bug |
1238 try to tackle it and submit a patch. You could also help with general bug |
| 1065 triage by going through the bug reports and leaving comments such as "this |
1239 triage by going through the bug reports and leaving comments such as "this |
| 1066 has been fixed" or "this is a duplicate of bug #12345." As always, make sure |
1240 has been fixed" or "this is a duplicate of bug #12345." As always, make sure |
| 1067 you follow the same coding style used in Gaim, and make sure you don't break |
1241 you follow the same coding style used in Gaim, and make sure you don't break |
| 1068 the core/UI split. |
1242 the core/UI split. |
| 1069 |
1243 |
| 1070 17.2 Gaim never leaves a core file. |
1244 16.2 Gaim never leaves a core file. |
| 1071 |
1245 |
| 1072 On most installs core files are limited in size to 0 bytes, and are therefore |
1246 On most installs core files are limited in size to 0 bytes, and are therefore |
| 1073 not created. To rectify this situation, add ulimit -c unlimited to your |
1247 not created. To rectify this situation, add ulimit -c unlimited to your |
| 1074 startup scripts (~/.bash_profile is a good place) or run it manually in a |
1248 startup scripts (~/.bash_profile is a good place) or run it manually in a |
| 1075 terminal before starting gaim from that terminal. You can also run Gaim |
1249 terminal before starting Gaim from that terminal. You can also run Gaim |
| 1076 directly in gdb with gdb gaim. |
1250 directly in gdb with gdb gaim. |
| 1077 |
1251 |
| 1078 17.3 Where should I report bugs? |
1252 16.3 Where should I report bugs? |
| 1079 |
1253 |
| 1080 http://gaim.sf.net/". |
1254 http://gaim.sf.net/bug.php. |
| 1081 |
1255 |
| 1082 17.4 Where should I submit patches? |
1256 16.4 Where should I submit patches? |
| 1083 |
1257 |
| 1084 http://gaim.sf.net/". |
1258 http://gaim.sf.net/patches.php. |
| 1085 |
1259 |
| 1086 17.5 Did you guys reverse engineer it? |
1260 16.5 Did you guys reverse engineer it? |
| 1087 |
1261 |
| 1088 TOC, Jabber, MSN, Napster, and IRC are published protocols, so we didn't have |
1262 TOC, Jabber, MSN, Napster, and IRC are published protocols, so we didn't have |
| 1089 to reverse engineer those. Oscar, ICQ, and Yahoo are not published, and were |
1263 to reverse engineer those. Oscar, ICQ, and Yahoo are not published, and were |
| 1090 reverse engineered by other people. Novell was provided by Novell, and SILC |
1264 reverse engineered by other people. Novell was provided by Novell, and SILC |
| 1091 was written by one of the protocol's developers. |
1265 was written by one of the protocol's developers. |
| 1092 |
1266 |
| 1093 +------------------------------------------------------------------------------ |
1267 +------------------------------------------------------------------------------ |
| 1094 | 18. Misc. Questions |
1268 | 17. Misc. Questions |
| 1095 +------------------------------------------------------------------------------ |
1269 +------------------------------------------------------------------------------ |
| 1096 |
1270 |
| 1097 18.1 Can I IM you guys? |
1271 17.1 Can I IM you guys? |
| 1098 |
1272 |
| 1099 Sure! Look at the Contact Information (http://gaim.sf.net/contactinfo.php) |
1273 Sure! Look at the Contact Information (http://gaim.sf.net/contactinfo.php) |
| 1100 page! |
1274 page! |
| 1101 |
1275 |
| 1102 18.2 Hello? |
1276 17.2 Hello? |
| 1103 |
1277 |
| 1104 We don't know how to answer this question. Stop asking it. |
1278 We don't know how to answer this question. Stop asking it. |
| 1105 |
1279 |
| 1106 18.3 Can I give you money/hardware/other expensive things that can be hocked |
1280 17.3 Can I give you money/hardware/other expensive things that can be hocked |
| 1107 for cash what with you all being students/full-time-workers and helping |
1281 for cash what with you all being students/full-time-workers and helping |
| 1108 to produce this wonderful software instead of studying/sleeping? |
1282 to produce this wonderful software instead of studying/sleeping? |
| 1109 |
1283 |
| 1110 No. We're completely fool-hardy and won't accept any gratuities with no |
1284 No. We're completely fool-hardy and won't accept any gratuities with no |
| 1111 strings attached for just being good guys. That and we'd have to share with |
1285 strings attached for just being good guys. That and we'd have to share with |
| 1112 everyone who has submitted patches. ;-) |
1286 everyone who has submitted patches. ;-) |
| 1113 |
1287 |
| 1114 18.4 Does Gaim support secure instant messaging (encrypted IMs)? |
1288 17.4 Does Gaim support secure instant messaging (encrypted IMs)? |
| 1115 |
1289 |
| 1116 Short answer: Yes, use the SILC protocol. Long Answer(for other protocols): |
1290 Short answer: Yes, use the SILC protocol. |
| 1117 Not natively. Doing secure instant messaging right is a big deal and |
1291 Long Answer(for other protocols): Not natively. Doing secure instant |
| 1118 requires, among other things, an authentication scheme. Simply encrypting |
1292 messaging right is a big deal and requires, among other things, an |
| 1119 your data stream without verifying the party with whom you are chatting is |
1293 authentication scheme. Simply encrypting your data stream without verifying |
| 1120 not secure in any way; some other clients offer options like this, but we |
1294 the party with whom you are chatting is not secure in any way; some other |
| 1121 feel that such measures instill a false sense of security that is more |
1295 clients offer options like this, but we feel that such measures instill a |
| 1122 harmful than helpful. |
1296 false sense of security that is more harmful than helpful. |
| 1123 |
1297 |
| 1124 There are a number of 3rd party plugin developers working on developing a |
1298 There are a number of 3rd party plugin developers working on developing a |
| 1125 secure IM framework, the better ones using the GnuPG and the OpenPGP trust |
1299 secure IM framework, the better ones using the GnuPG and the OpenPGP trust |
| 1126 model for authentication. If you are serious about secure instant messaging, |
1300 model for authentication. If you are serious about secure instant messaging, |
| 1127 read the documentation on the "web of trust" model available at www.gnupg.org |
1301 read the documentation on the "web of trust" model available at www.gnupg.org |
| 1128 and try out one of these. |
1302 and try out one of these. |
| 1129 |
1303 |
| 1130 18.5 Why are the passwords in accounts.xml not encrypted? |
1304 17.5 Why are the passwords in accounts.xml not encrypted? |
| 1131 |
1305 |
| 1132 This is a case of a really long answer to a short question. Read our |
1306 This is a case of a really long answer to a short question. Read our |
| 1133 explanation at http://gaim.sf.net/plaintextpasswords.txt. |
1307 explanation at http://gaim.sf.net/plaintextpasswords.txt. |
| 1134 |
1308 |
| 1135 18.6 What is gaim-remote? |
1309 17.6 What is gaim-remote? |
| 1136 |
1310 |
| 1137 gaim-remote is a second executable included with Gaim starting with 0.60. It |
1311 gaim-remote is a second executable included with Gaim starting with 0.60. It |
| 1138 allows you to perform some actions to control/manipulate an existing Gaim |
1312 allows you to perform some actions to control/manipulate an existing Gaim |
| 1139 process from the command line. Run gaim-remote --help to get an idea of what |
1313 process from the command line. Run gaim-remote --help to get an idea of what |
| 1140 we currently envision it doing. |
1314 we currently envision it doing. |
| 1141 |
1315 |
| 1142 18.7 When will the next version of Gaim be released? |
1316 17.7 When will the next version of Gaim be released? |
| 1143 |
1317 |
| 1144 The schedule for releases is every third Thursday. However, a new version |
1318 The schedule for releases is every third Thursday. However, a new version |
| 1145 will only be released if it meets a certain standard of quality (i.e., it |
1319 will only be released if it meets a certain standard of quality (i.e., it |
| 1146 will not be released if it still has a large number of serious bugs). |
1320 will not be released if it still has a large number of serious bugs). |
| 1147 Therefore, some releases will take longer than others. Major rewrites means |
1321 Therefore, some releases will take longer than others. Major rewrites means |
| 1148 lots of new bugs to work out. The new version will be released as soon as it |
1322 lots of new bugs to work out. The new version will be released as soon as it |
| 1149 is possible to do so. |
1323 is possible to do so. |
| 1150 |
1324 |
| |
1325 17.8 What will the next version be? |
| |
1326 |
| |
1327 Starting with version 1.0.0, Gaim version numbers have 3 parts to them. The |
| |
1328 format is major.minor.micro. If we change something internally in Gaim such |
| |
1329 that some plugins won't work with the newer version, we will increment the |
| |
1330 major version number. If we don't increment the major version number, and |
| |
1331 we've added things to the Gaim API that won't break any older stuff, we will |
| |
1332 increment the minor version number. In any other cases, we will increment the |
| |
1333 micro version number. Even and odd numbers have nothing to do with stability, |
| |
1334 and you should always be running the latest release of Gaim to get new |
| |
1335 features and bug fixes. |
| |
1336 |
| |
1337 17.9 So, can I look forward to mega-sexy super functionality with Gaim? |
| |
1338 |
| |
1339 Yes, that is the intended idea. In fact, there have been quite a number of |
| |
1340 unpopular geeks who have made the switch to gaim. In a matter of days, the |
| |
1341 number of dates and awesomeness points received by the geek increased ten |
| |
1342 fold! You, too, can have an exciting life with Gaim. Get Gaim. Get the babes. |
| |
1343 Get uhh... hmm. |
| |
1344 |