comparison doc/FAQ @ 8736:374477c0dd76

[gaim-migrate @ 9491] (21:37:35) nosnilmot: LSchiere: do you want this? http://nosnilmot.com/patches/gaim-0.77cvs-doclove.patch (21:38:43) LSchiere: oh wow (21:38:44) LSchiere: sure (21:38:56) nosnilmot: oh crap, does that spelling nonsense conflict with it? (21:40:22) nosnilmot: LSchiere: apparently the spelling police avoided doc/ , so that patch should still apply (21:40:29) KingAnt: :-) (21:40:31) LSchiere: nosnilmot: commit message? (21:40:44) KingAnt: "Dr. Love" (21:40:54) nosnilmot: "I never knew EvilDennisR did anything, now I do" (21:41:05) LSchiere: and the serious commit message? but apparently we aren't being serious tonight. committer: Tailor Script <tailor@pidgin.im>
author Luke Schierer <lschiere@pidgin.im>
date Wed, 21 Apr 2004 01:43:16 +0000
parents 9227553c97dd
children 3b25c1042973
comparison
equal deleted inserted replaced
8735:92cbf9713795 8736:374477c0dd76
3 1. Compiling and Installing 3 1. Compiling and Installing
4 4
5 1.1. Why can't I compile Gaim? 5 1.1. Why can't I compile Gaim?
6 1.2. I'm trying to install Gaim, but it complains that I don't have 6 1.2. I'm trying to install Gaim, but it complains that I don't have
7 libgtkspell.so.0, from where can I get this? 7 libgtkspell.so.0, from where can I get this?
8 1.3. How do I get sound to work correctly? 8 1.3. Is there some way I can compile just Gaim, without all of these
9 1.4. Is there some way I can compile just Gaim, without all of these
10 protocols? 9 protocols?
11 1.5. I compiled Gaim, but when I restart, it did not update. 10 1.4. I installed a new version of Gaim, but the about window says I'm
12 1.6. I have a question about GTK1.2. 11 still using the old version.
13 1.7. I'd like to use Gaim on IRIX. 12 1.5. Can I use Gaim for GTK+1.2?
14 1.8. How do I apply the xxxx patch (name.diff)? 13 1.6. Can I run Gaim on IRIX?
14 1.7. How do I apply the xxxx patch (name.diff)?
15 1.8. Why is gaim crashing when I start it?
16 1.9. Gaim CVS is buggy. Gaim <non-current version> is buggy.
15 17
16 2. Using Gaim 18 2. Using Gaim
17 19
18 2.1. How do I register for a new account? 20 2.1. How do I register for a new account?
19 2.2. How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu(GG), Napster, or 21 2.2. How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu(GG), Napster, or
20 Zephyr? 22 Zephyr?
21 2.3. How do I make gaim use emacs-like keybindings? 23 2.3. How do I make gaim use emacs-like keybindings?
22 2.4. How do I change the font Gaim uses? 24 2.4. How do I change the font Gaim uses?
23 2.5. How do I use smiley themes? 25 2.5. How do I use smiley themes?
24 2.6. Why are the status icons so big? 26 2.6. Why are the status icons so big?
25 2.7. Why is Gaim crashing when somebody sends me an IM? 27 2.7. How do I get sound to work correctly?
26 2.8. Why is gaim crashing when I start it? 28 2.8. How do I make Gaim use ALSA or OSS for playing sounds? What does
29 the "Automatic" option do?
27 2.9. I just changed my buddy icon, and I can't see the new one. 30 2.9. I just changed my buddy icon, and I can't see the new one.
28 2.10. Why is everything at such small/large font sizes? 31 2.10. Why is everything at such small/large font sizes?
29 2.11. Gaim CVS is buggy. Gaim <non-current version> is buggy. 32 Why does Gaim use the same WM_CLASS for every window? It makes
33 2.11. it impossible to control window size and placement for the buddy
34 list separately from the conversations.
30 2.12. Why is the toggle to disable tabs not working? 35 2.12. Why is the toggle to disable tabs not working?
31 2.13. What is a "Buddy Pounce"? 36 2.13. What is a "Buddy Pounce"?
32 2.14. How do I get rid of the buddy icons in the taskbar? 37 2.14. Where does gaim store its logs?
38 2.15. Can I use Gaim for e-mail, blogging, an RSS feed, or something
39 else that isn't IM-related?
33 40
34 3. Features 41 3. Features
35 42
36 3.1. Can Gaim send files? 43 3.1. Does Gaim support file transfer?
37 3.2. When will file transfer be supported? Is it being worked on? 44 3.2. Is there a Gaim tray icon, or docklet, or gnome applet, or panel
38 3.3. File Transfer for xxxx doesn't seem to be working.
39 3.4. Is there a Gaim tray icon, or docklet, or gnome applet, or panel
40 icon, or something? 45 icon, or something?
41 3.5. What do those colors in the conversation tab mean? 46 3.3. What do those colors in the conversation tab mean?
42 3.6. Will Gaim save my buddy list to the server? 47 3.4. Will Gaim save my buddy list to the server?
43 3.7. How come there's no Export Buddy List? 48 3.5. Can I import or export my buddy list?
44 3.8. Can Gaim import my buddy list? 49 3.6. Does Gaim support animated smileys?
45 3.9. Does Gaim support animated smileys? 50 3.7. Can I make Gaim group screen names by the person that owns them?
46 3.10. Can I make Gaim group screen names by the person that owns them? 51 You know, like Trillian's Meta Contacts?
52 3.8. How do I get the old logging back?
53 3.9. How can I convert my old logs to the new format?
54 3.10. Where has the system log gone?
47 55
48 4. ICQ Protocol 56 4. ICQ Protocol
49 57
50 4.1. How do I use ICQ? 58 4.1. How do I use ICQ?
51 4.2. ICQ doesn't work. 59 4.2. Can I send SMS messages?
52 4.3. Gaim 0.60 pops up a bunch of authorization request Dialogs.
53 60
54 5. TOC Protocol 61 5. TOC Protocol
55 62
56 5.1. What is the TOC protocol? 63 5.1. What is the TOC protocol?
57 64
58 6. AIM/ICQ (Oscar) Protocol 65 6. AIM/ICQ (OSCAR) Protocol
59 66
60 6.1. Can I set a buddy icon? 67 6.1. Can I set my profile?
61 6.2. Some of my buddies are not showing up as online, why is that? 68 6.2. Can I set a buddy icon?
62 6.3. Can I use AIM URI's such as "aim:goim?screenname=robflynn"? 69 6.3. Some of my buddies are not showing up as online, why is that?
63 6.4. IM Image doesn't work, why? 70 6.4. Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
64 6.5. I sent an IM Image, but only a blank line shows up, why? 71 6.5. Does Gaim support DirectIM and IM Image?
65 6.6. Can I add SMS numbers to my buddy list? 72 6.6. Can I send SMS messages?
66 6.7. I heard AOL is combining ICQ and AIM, does that mean I can send a 73 6.7. Can I add SMS numbers to my buddy list?
74 6.8. I heard AOL is combining ICQ and AIM, does that mean I can send a
67 message from an AIM account to an ICQ account and vice-versa? 75 message from an AIM account to an ICQ account and vice-versa?
68 6.8. Why can't I connect via either Oscar or TOC? 76 6.9. Why can't I connect via either Oscar or TOC?
69 77
70 7. IRC Protocol 78 7. IRC Protocol
71 79
72 7.1. Why am I getting disconnected when I try to connect to IRC? 80 7.1. Why am I getting disconnected when I try to connect to IRC?
73 7.2. How do I join a channel with the IRC plugin? 81 7.2. How do I join a channel with the IRC plugin?
76 84
77 8. Jabber Protocol 85 8. Jabber Protocol
78 86
79 8.1. How do I choose which Jabber server to use? 87 8.1. How do I choose which Jabber server to use?
80 8.2. How do I change my Jabber resource to be other than the default 88 8.2. How do I change my Jabber resource to be other than the default
81 of "/GAIM"? 89 of "/Gaim"?
82 8.3. How do I register a new Jabber account? 90 8.3. How do I register a new Jabber account?
83 8.4. How do I use invisibility? 91 8.4. How do I use invisibility?
84 I've a buddy that I keep removing from my buddy list but the 92 I've a buddy that I keep removing from my buddy list but the
85 8.5. entry keeps coming back every time I log in again! How can I stop 93 8.5. entry keeps coming back every time I log in again! How can I stop
86 this? 94 this?
87 8.6. Can I remove a buddy from my Jabber roster entirely? 95 8.6. Can I remove a buddy from my Jabber roster entirely?
88 8.7. What does "Cancel Presence Notification" do? 96 8.7. What does "Cancel Presence Notification" do?
89 97
90 9. Y!M (yahoo) Protocol 98 9. Y!M (Yahoo) Protocol
91 99
92 9.1. I cannot connect to yahoo! 100 9.1. I cannot connect to yahoo!
93 101
94 10. MSN Protocol 102 10. MSN Protocol
95 103
96 10.1. I'm getting lots of "Already in Opposite list" errors on msn, 104 10.1. I'm getting lots of "Already in Opposite list" errors on msn,
97 why? 105 why?
98 10.2. I'm getting an "Invalid User" popop whenever I sign on. How can 106 10.2. I'm getting an "Invalid User" popup whenever I sign on. How can
99 I make this go away? 107 I make this go away?
100 10.3. Is there a way to invite more than one person to an MSN chat? 108 10.3. Is there a way to invite more than one person to an MSN chat?
101 10.4. Is MSNP9 (MSN6) going to be supported? 109 10.4. Is MSNP9 (MSN6) going to be supported?
102 10.5. Will I be able to use Gaim for MSN after October 15th? (The day 110 10.5. Will I be able to use Gaim for MSN after October 15th 2003? (The
103 they're preventing third party clients from connecting) 111 day they're preventing third party clients from connecting)
104 10.6. I just upgraded Gaim and the MSN plugin will not load. Why? 112 10.6. I just upgraded Gaim and the MSN plugin will not load. Why?
105 10.7. The MSN plugin won't load, but I have Mozilla NSS! 113 10.7. The MSN plugin won't load, but I have Mozilla NSS!
114 10.8. What does "MSN: S: 911 3" in the debug window mean when I cannot
115 connect to msn?
106 116
107 11. Gadu-Gadu Protocol 117 11. Gadu-Gadu Protocol
108 118
109 11.1. What is Gadu-Gadu? 119 11.1. What is Gadu-Gadu?
110 120
111 12. Trepia Protocol 121 12. Zephyr Protocol
112 122
113 12.1. I heard Trepia was going to be in 0.65. Where is it? 123 12.1. What is Zephyr?
114 12.2. Trepia is showing people in Japan, England, etc. on my buddy 124 12.2. Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with
125 "Couldn't initialize zephyr".
126 12.3. Gaim isn't working, but I never got any other zephyr client
127 working on this machine.
128
129 13. Trepia Protocol
130
131 13.1. I heard Trepia was going to be in 0.65. Where is it?
132 13.2. Trepia is showing people in Japan, England, etc. on my buddy
115 list. I thought this was supposed to show people in my area? 133 list. I thought this was supposed to show people in my area?
116 134
117 13. Scripts and Plugins 135 14. Scripts and Plugins
118 136
119 13.1. How do I use perl scripts with Gaim? 137 14.1. How do I use perl scripts with Gaim?
120 13.2. How do I compile a plugin for Gaim? 138 14.2. How do I compile a plugin for Gaim?
121 13.3. I have a plugin or perl script for Gaim that does not work with 139 14.3. I have a plugin or perl script for Gaim that does not work with
122 0.60 or higher. 140 0.60 or higher.
123 13.4. Where can I find documentation on writing plugins and Perl 141 14.4. Where can I find documentation on writing plugins and Perl
124 scripts? 142 scripts?
125 143
126 14. Development 144 15. Development
127 145
128 14.1. Where should I report bugs? 146 15.1. Can I help?
129 14.2. Gaim never leaves a core file. 147 15.2. Gaim never leaves a core file.
130 14.3. Where should I submit patches? 148 15.3. Where should I report bugs?
131 14.4. Did you guys reverse engineer it? 149 15.4. Where should I submit patches?
132 14.5. Will Gaim be ported to Windows 95/98/Me/2000/XP? 150 15.5. Did you guys reverse engineer it?
133 151
134 15. Misc. Questions 152 16. Misc. Questions
135 153
136 15.1. Does AOL's attempts at blocking Trillian affect Gaim? 154 16.1. Can I IM you guys?
137 15.2. Is Gaim affected by the vulnerability found in Windows AIM or 155 16.2. Hello?
138 Yahoo Instant Messenger clients?
139 15.3. Can I IM you guys?
140 15.4. Hello?
141 Can I give you money/hardware/other expensive things that can be 156 Can I give you money/hardware/other expensive things that can be
142 15.5. hocked for cash what with you all being students/ 157 16.3. hocked for cash what with you all being students/
143 full-time-workers and helping to produce this wonderful software 158 full-time-workers and helping to produce this wonderful software
144 instead of studying/sleeping? 159 instead of studying/sleeping?
145 15.6. Does Gaim support secure instant messaging (encrypted IMs)? 160 16.4. Does Gaim support secure instant messaging (encrypted IMs)?
146 15.7. Why are the passwords in accounts.xml not encrypted? 161 16.5. Why are the passwords in accounts.xml not encrypted?
147 15.8. What is gaim-remote? 162 16.6. What is gaim-remote?
148 15.9. When will the next version of Gaim be released? 163 16.7. When will the next version of Gaim be released?
149 164
150 +------------------------------------------------------------------------------ 165 +------------------------------------------------------------------------------
151 | 1. Compiling and Installing 166 | 1. Compiling and Installing
152 +------------------------------------------------------------------------------ 167 +------------------------------------------------------------------------------
153 168
154 1.1 Why can't I compile Gaim? 169 1.1 Why can't I compile Gaim?
155 170
156 Make sure you have gettext <= 0.10.40 or gettext >= 0.11.3, autoconf 2.11 or 171 Make sure you have relatively recent versions of automake, autoconf, and
157 >= 2.53, and automake >= 1.4px (tested up to automake 1.6.3). If you are 172 gettext. HOWEVER, generally speaking, having the absolute newest of them is
158 still having problems, make sure that your gettext package includes the 173 not as good as having one version short of newest since we might not have
159 program gettextize (for gettext <= 0.10.40) or autopoint (for gettext >= 174 found work-arounds for the latest set of changes. Also, some versions of
160 0.11.3). If it does not, look for another package. 175 automake require certain ranges of gettext versions, and we are utterly
161 176 unable to keep track of what versions will work with what other versions.
162 We don't support gettext 0.11.0 through 0.11.2 or 0.12.1. It may work for 177
163 you, but we make no promises. 178 If you have Slackware < 9.1, you need to get non-slack packages for autoconf,
164
165 If you are using autoconf 2.50+, do not use a version of gettext lower than
166 0.11.3. You will get errors in the po/ directory.
167
168 If you have Slackware, you need to get non-slack packages for autoconf,
169 automake, gettext, and libtool. You also have to copy the contents of /usr/ 179 automake, gettext, and libtool. You also have to copy the contents of /usr/
170 local/share/aclocal to /usr/share/aclocal. This is due to bugs in Slackware 180 local/share/aclocal to /usr/share/aclocal. This is due to bugs in Slackware
171 and the auto* packages. 181 and the auto* packages.
172 182
173 *BSD users may also have problems with libtool and will also have to remove 183 *BSD users may also have problems with libtool and will also have to remove
174 the --no-verify from the configure script. 184 the --no-verify from the configure script.
175 185
186 Having problems getting SSL and MSN working? See http://gaim.sf.net/
187 faq-ssl.php for distribution specific hints.
188
176 1.2 I'm trying to install Gaim, but it complains that I don't have 189 1.2 I'm trying to install Gaim, but it complains that I don't have
177 libgtkspell.so.0, from where can I get this? 190 libgtkspell.so.0, from where can I get this?
178 191
179 libtgtkspell.so.0 is provided by gtkspell. This library is used by Gaim to 192 libtgtkspell.so.0 is provided by gtkspell. This library is used by Gaim to
180 provide the "Highlight misspelled words" feature. You can find an RPM of 193 provide the "Highlight misspelled words" feature. You can find an RPM of
181 gtkspell at freshrpms.net. You can find the source and a non-Red Hat specific 194 gtkspell at freshrpms.net. You can find the source and a non-Red Hat specific
182 RPM at gtkspell.sourceforge.net. 195 RPM at gtkspell.sourceforge.net.
183 196
184 1.3 How do I get sound to work correctly? 197 1.3 Is there some way I can compile just Gaim, without all of these protocols?
185 198
186 Gaim 0.60 and higher support playing sounds via libao. Playing sounds 199 Yeah. There are actually three ways to do it.
187 directly through esound or arts is no longer supported.
188
189 `Libao is a cross-platform library that allows programs to output PCM audio
190 data to the native audio devices on a wide variety of platforms. It currently
191 supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound
192 Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts
193 (Analog Realtime Synthesizer). '
194
195 To compile Gaim with support for libao you need libao-devel and
196 audiofile-devel. To use libao you need libao and audiofile. If you do not
197 wish to install these packages you can also just change your sound playing
198 method in preferences to Command and use "esdplay %s" or "artsplay %s."
199
200 1.4 Is there some way I can compile just Gaim, without all of these protocols?
201
202 Sort of, yeah. There are actually two ways to do it.
203 200
204 1. Use the --with-static-prpls option to ./configure along with 201 1. Use the --with-static-prpls option to ./configure along with
205 --disable-plugins. This will let you choose which protocols are compiled 202 --disable-plugins. This will let you choose which protocols are compiled
206 in with Gaim, but you will not be able to use any other protocols or 203 in with Gaim, but you will not be able to use any other protocols or
207 plugins. 204 plugins.
208 205
209 You'll need to compile any protocols that you specified in 206 You'll need to compile any protocols that you specified in
210 --with-static-prpls. Oscar and TOC are defaults. 207 --with-static-prpls. Oscar and TOC are defaults.
211 208
212 2. Change to the directories for the protocols you want to compile (e.g. src 209 2. Use the --with-dynamic-prpls option to ./configure
210
211 3. Change to the directories for the protocols you want to compile (e.g. src
213 /protocols/jabber), and run make from there. Then after you've compiled 212 /protocols/jabber), and run make from there. Then after you've compiled
214 all of them, change back to src/ and run make gaim. 213 all of them, change back to src/ and run make gaim.
215 214
216 The static prpls option is broke in 0.64 and higher. 215 1.4 I installed a new version of Gaim, but the about window says I'm still
217 216 using the old version.
218 1.5 I compiled Gaim, but when I restart, it did not update. 217
219 218 If you compiled yourself, and you previously had an rpm or a Debian package
220 If you previously had an rpm or a Debian package installed, you need to 219 installed, you need to remove that first. rpm -e gaim or dpkg -p gaim should
221 remove that first. rpm -e gaim or dpkg -p gaim should work. If you are using 220 work.
222 0.59.x or lower, you will receive some errors about your plugins when you
223 restart Gaim. This is normal. Simply go into the Plugins dialog (Tools->
224 Plugins) and reload them. These errors will only happen once.
225 221
226 Likewise, if you want to use an RPM or deb and you have previously compiled 222 Likewise, if you want to use an RPM or deb and you have previously compiled
227 Gaim from source, you need to make uninstall to remove all Gaim files from / 223 Gaim from source, you need to make uninstall to remove all Gaim files from /
228 usr/local. 224 usr/local.
229 225
230 1.6 I have a question about GTK1.2. 226 1.5 Can I use Gaim for GTK+1.2?
231 227
232 Our GTK2 port is now complete, the 0.59.x release series uses only GTK1.2, 228 As of version 0.60, Gaim has been completely converted to using GTK+2.0. We
233 and it is also entirely devoid of new features. 0.60 is the first release 229 really really really recommend using the most current version of Gaim and not
234 with GTK2 support. 0.60 and all future Gaim versions will no longer support 230 a GTK+1.2 version of Gaim. However, if you are living in the '90s, or you're
235 GTK1.2. With the release of 0.60, the gtk1-stable tree that the 0.59.x 231 afraid GTK+2.0 will insult your mother, you can use Gaim 0.59.x, which is
236 releases were from has been discontinued. If you want anything new in that 232 GTK+1.2 based. We should warn you though, the 0.59.x releases haven't had new
237 tree, you will have to maintain it yourself. 233 features since the middle of 2002. Also, the 0.59.x releases aren't
238 234 breathtakingly beautiful.
239 1.7 I'd like to use Gaim on IRIX. 235
240 236 1.6 Can I run Gaim on IRIX?
241 Please see http://sourceforge.net/forum/forum.php?thread_id=725839&forum_id= 237
242 665 at our SourceForge Forum. 238 It has been done before. Please see http://sourceforge.net/forum/forum.php?
243 239 thread_id=725839&forum_id=665 at our SourceForge Forum.
244 1.8 How do I apply the xxxx patch (name.diff)? 240
245 241 1.7 How do I apply the xxxx patch (name.diff)?
242
246 Type patch -p0 < name.diff from inside the gaim directory. If that doesn't 243 Type patch -p0 < name.diff from inside the gaim directory. If that doesn't
247 work, try patch -p1 < name.diff. 244 work, try patch -p1 < name.diff.
248 245
246 1.8 Why is gaim crashing when I start it?
247
248 First of all make sure you are using the most recent version of Gaim. If you
249 still have problems, try the things in the following list:
250
251 * Try running gaim with GDK_USE_XFT=0 set (type that in a terminal and then
252 run Gaim from the same terminal).
253 * If gaim is not crashing, but is just sitting there not displaying
254 anything, try turning off anything else that might be using the sound
255 device (ie xmms) and then starting gaim. If this fixes the problem, it is
256 a libao issue, not a gaim issue, and can be worked around by the use of
257 esd or arts.
258 * Try disabling or deleting any 3rd party plugins, especially anything
259 related to encryption.
260 * If you use 0.75 on win32, try deleting tcl.dll.
261 * If you use 0.70 or lower, make sure only one version of Gaim is
262 installed.
263 * If you use 0.67 and do not have yourself on your buddy list, upgrade.
264 * If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto
265 away preference from -1 to 0.
266 * If you use MSN, and have a version 0.64, downgrade to 0.63 or upgrade to
267 0.65.
268
269 1.9 Gaim CVS is buggy. Gaim <non-current version> is buggy.
270
271 Yes, it is! CVS is often unsupported by Gaim, as are non-current versions.
272 This is because non-current versions have old bugs which may be fixed in the
273 current version, and CVS is frequently unusable because of the changes in the
274 code (and it has new bugs). If you are using either and have a problem,
275 upgrade/install the current stable version of Gaim before posting a bug or
276 asking for help in Gaim's IRC channel. If the bug does not exist in the
277 current version, then please do not ask for help.
278
249 +------------------------------------------------------------------------------ 279 +------------------------------------------------------------------------------
250 | 2. Using Gaim 280 | 2. Using Gaim
251 +------------------------------------------------------------------------------ 281 +------------------------------------------------------------------------------
252 282
253 2.1 How do I register for a new account? 283 2.1 How do I register for a new account?
254 284
255 This depends on the protocol. 285 This depends on the protocol.
256 286
257 AIM: Go to http://my.screenname.aol.com/_cqr/login/login.psp?siteId= 287 AIM: Go to http://my.screenname.aol.com/_cqr/login/login.psp?siteId=
258 snshomepage&authLev=1&mcState=initialized&createSn=1. 288 snshomepage&authLev=1&mcState=initialized&createSn=1.
259 289
260 ICQ: Go to http://web.icq.com/register. 290 ICQ: Go to http://web.icq.com/register.
261 291
262 Yahoo: Go to http://edit.yahoo.com/config/eval_register. 292 Yahoo: Go to http://edit.yahoo.com/config/eval_register.
263 293
264 MSN: Go to http://registernet.passport.com. 294 MSN (including hotmail email): Go to http://registernet.passport.com/.
295
296 MSN (using your own email address): Go to this website
265 297
266 Gadu-Gadu: Use the official client to create an account. 298 Gadu-Gadu: Use the official client to create an account.
267 299
268 Jabber: See the question How do I register a new Jabber account? below. 300 Jabber: See the question How do I register a new Jabber account? below.
269 301
270 2.2 How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu(GG), Napster, or Zephyr? 302 2.2 How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu(GG), Napster, or Zephyr?
271 303
272 In Gaim 0.60 and higher, use the Account Editor (Tools->Accounts, or the 304 Use the Account Editor (Tools->Accounts, or the Accounts button on the start
273 Accounts button on the start screen) to add the account. The appropriate 305 screen) to add the account of the appropriate messaging service. The protocol
274 protocol plugin is loaded automatically. 306 plugin is loaded automatically.
275
276 In Gaim 0.59 and lower, you must first load the protocol plugin for the
277 protocol that you want to use. These plugins come with Gaim, so just go to
278 the Plugins dialog (Tools->Plugins, or the Plugins button on the start
279 screen). The list of plugins on this screen is a listing of plugins you have
280 already loaded and does not included unloaded but available plugins. To load
281 a new plugin, click "Load." The protocol plugins are named libprotocol.so, so
282 MSN for instance is provided by libmsn.so, and Gadu-Gadu is provided by
283 libgg.so. Now you can use the Account Editor to add an account with the
284 desired protocol.
285 307
286 2.3 How do I make gaim use emacs-like keybindings? 308 2.3 How do I make gaim use emacs-like keybindings?
287 309
288 You need to edit your ~/.gtkrc-2.0 to contain the keybindings line from http: 310 You need to edit your ~/.gtkrc-2.0 to contain the keybindings line from http:
289 //gaim.sf.net/gtkrc-2.0. 311 //gaim.sf.net/gtkrc-2.0.
290 312
291 2.4 How do I change the font Gaim uses? 313 2.4 How do I change the font Gaim uses?
292 314
293 The font preference in Gaim is used only for the formatting of outgoing 315 The font preference in Gaim is used only for the formatting of outgoing
294 messages, and that only on the few protocols we support outgoing format on. 316 messages, and that only on the few protocols we support outgoing format on.
295 The display fonts used by the rest of Gaim are those specified by GTK. To 317 The display fonts used by the rest of Gaim are those specified by GTK. To
296 change this font you need to edit your ~/.gktrc (Gaim 0.59.9 and lower) or ~ 318 change this font you need to edit your ~/.gtkrc-2.0 file. If you need help
297 /.gtkrc-2.0 (Gaim 0.60 and newer). An example ~/.gtkrc-2.0 is available http: 319 you can see our example .gtkrc-2.0 (http://gaim.sf.net/gtkrc-2.0) file.
298 //gaim.sf.net/gtkrc-2.0.
299 320
300 2.5 How do I use smiley themes? 321 2.5 How do I use smiley themes?
301 322
302 Gaim 0.60 and higher support themable smileys. To select a theme, open Gaim's 323 To select a theme, open Gaim's preferences to the "Smiley Themes" page and
303 preferences to the "Smiley Themes" page and click on whichever theme you want 324 click on whichever theme you want to use. To install a theme, simply drag it
304 to use. To install a theme, simply drag it into the theme selector. You can 325 into the theme selector. You can find themes on the Gaim Smiley Themes (http:
305 find themes on the Gaim Smiley Themes (http://gaim.sourceforge.net/ 326 //gaim.sf.net/themes.php) page.
306 themes.php) page.
307 327
308 You can also install themes manually by uncompressing them to their own 328 You can also install themes manually by uncompressing them to their own
309 directory in ~/.gaim/smileys/ 329 directory in ~/.gaim/smileys/
310 330
311 2.6 Why are the status icons so big? 331 2.6 Why are the status icons so big?
312 332
313 We believe that, by adding a second line of text to each buddy list entry, 333 We believe that, by adding a second line of text to each buddy list entry,
314 we're able to show more information about each buddy on the buddy list. The 334 we're able to show more information about each buddy on the buddy list. The
315 'Big List,' as we call it, shows status text, idle time, and warning level 335 'Big List,' as we call it, shows status text, idle time, and warning level
316 concisely and attractively. It shows more than one status "emblem" for each 336 concisely and attractively. It shows more than one status "emblem" for each
317 buddy, indicating at the same time a mobile user who is away. Most 337 buddy, indicating at the same time a mobile user who is away. Most
323 We are aware that some people feel more comfortable using an interface more 343 We are aware that some people feel more comfortable using an interface more
324 similar to IM clients they may have used in the past. 'Big List' can be 344 similar to IM clients they may have used in the past. 'Big List' can be
325 disabled by un-checking "Show buddy icons in list" in the Buddy List 345 disabled by un-checking "Show buddy icons in list" in the Buddy List
326 preferences. 346 preferences.
327 347
328 2.7 Why is Gaim crashing when somebody sends me an IM? 348 2.7 How do I get sound to work correctly?
329 349
330 If you're using a version older than 0.55 (or Ximian or Debian's 0.54 350 Gaim uses libao to play sounds. Playing sounds directly through esound or
331 package), you can be crashed remotely through an IM using one of two strings. 351 arts is no longer supported.
332 The solution is to upgrade to the latest version, where both exploits are 352
333 fixed. 353 Libao is a cross-platform library that allows programs to output PCM audio
334 354 data to the native audio devices on a wide variety of platforms. It currently
335 If you use Yahoo with Gaim 0.59.8 or lower, you need to upgrade. Yahoo 355 supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound
336 changed the protocol in a way that broke Gaim, Trillian, Everybuddy, and 356 Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts
337 their own linux client. 357 (Analog Realtime Synthesizer).
338 358
339 If you use Gaim 0.59.5 and Gaim segfaults as soon as it signs on, you do not 359 To compile Gaim with support for libao you need libao-devel and
340 have a valid ~/.gtkrc file. This is fixed in debian's 0.59.5-2 package, and 360 audiofile-devel. To use libao you need libao and audiofile. If you do not
341 is fixed in 0.59.6 for the rest of the world. 361 wish to install these packages you can also just change your sound playing
342 362 method in preferences to Command and use "esdplay %s" or "artsplay %s."
343 If you are using a version newer than 0.59.6 and Gaim still crashes, please 363
344 let us know. 364 2.8 How do I make Gaim use ALSA or OSS for playing sounds? What does the
345 365 "Automatic" option do?
346 2.8 Why is gaim crashing when I start it? 366
347 367 If you choose "Automatic", "ESD", or "Arts", Gaim uses libao to play sounds.
348 With 0.60 and higher, try running gaim with GDK_USE_XFT=0 set. If this does 368 Choosing "ESD" or "Arts" forces libao to play sounds using that method, while
349 not fix the problem, please submit a bug report. If gaim is not crashing, but 369 choosing "Automatic" lets it decide for itself.
350 is just sitting there not displaying anything, try turning off anything else 370
351 that might be using the sound device (ie xmms) and then starting gaim. If 371 If you choose Automatc, you can create a file, either /etc/libao.conf or ~
352 this fixes the problem, it is a libao issue, not a gaim issue, and can be 372 /.libao, and put one of the following lines in it:
353 worked around by the use of esd or arts. 373
354 374 default_driver=alsa
355 If you use MSN, and have a version 0.64, downgrade to 0.63 or upgrade to 375
356 0.65. 376 default_driver=oss
357 377 Other drivers, like alsa09, arts, esd, irix, macosx, and sun might also be
358 If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto away 378 supported, depending on your platform, and how libao was compiled. See also
359 preference from -1 to 0. 379 'man 5 libao.conf'.
360
361 If you use 0.67 and do not have yourself on your buddy list, upgrade.
362
363 If you use 0.70 or lower, make sure only one version of Gaim is installed.
364 380
365 2.9 I just changed my buddy icon, and I can't see the new one. 381 2.9 I just changed my buddy icon, and I can't see the new one.
366 382
367 First, try IMing yourself. Buddy icons are checked when you IM people, so 383 First, try IMing yourself a few times. Buddy icons are checked when you IM
368 depending on the protocol, that may work. If it still doesn't update, check 384 people, so depending on the protocol, that may work. If it still doesn't
369 the file size (buddy icons must be smaller than 4kb) and the image size (it 385 update, check the file size (buddy icons must be smaller than 4kb) and the
370 should be 48x48 or 50x50 in most cases). Also, check the file type. GIF or 386 image size (it should be 48x48 or 50x50 in most cases). Also, check the file
371 JPEG images are best supported; most other formats do not work at all. If all 387 type. GIF or JPEG images are best supported; most other formats do not work
372 of that checks out and it still doesn't work, and you're sure the protocol 388 at all. If all of that checks out and it still doesn't work, and you're sure
373 supports it, try restarting Gaim. 389 the protocol supports it, try restarting Gaim.
374 390
375 2.10 Why is everything at such small/large font sizes? 391 2.10 Why is everything at such small/large font sizes?
376 392
377 You need to edit your .gtkrc-2.0 in your home directory. This is almost 393 You need to edit your .gtkrc-2.0 in your home directory. This is almost
378 certainly a gtk theme thing. You can find more gtk themes by visiting 394 certainly a gtk theme thing. You can find more gtk themes by visiting
379 themes.freshmeat.net, art.gnome.org, or searching on Google. If it is a 395 themes.freshmeat.net, art.gnome.org, or searching on Google. If it is a
380 particular message window, you can also try ignoring font sizes (Tools-> 396 particular message window, you can also try ignoring font sizes (Tools->
381 Preferences->Message Text), though that will only have limited effects. See 397 Preferences->Message Text), though that will only have limited effects. See
382 an example .gktrc-2.0 at http://gaim.sf.net/gtkrc-2.0. 398 an example .gktrc-2.0 at http://gaim.sf.net/gtkrc-2.0.
383 399
384 2.11 Gaim CVS is buggy. Gaim <non-current version> is buggy. 400 2.11 Why does Gaim use the same WM_CLASS for every window? It makes it
385 401 impossible to control window size and placement for the buddy list
386 Yes, it is! CVS is often unsupported by Gaim, as are non-current versions. 402 separately from the conversations.
387 This is because non-current versions have old bugs which may be fixed in the 403
388 current version, and CVS is frequently unusable because of the changes in the 404 Both strings in the WM_CLASS property are supposed to be the same for all
389 code (and it has new bugs). If you are using either and have a problem, 405 windows in the same instance of an application. ICCCM states that one is
390 upgrade/install the current version of Gaim before posting a bug or asking 406 meant to be the same for all instances of the application, the other is meant
391 for help in Gaim's IRC channel. If the bug does not exist in the current 407 to be unique to that instance of the application. ICCCM also states "If a
392 version, then please do not ask for help. 408 client has multiple windows with identical WM_CLASS and WM_NAME properties,
409 then it should provide a WM_WINDOW_ROLE property."
410
411 Gtk+ sets these WM_CLASS values for us so that they are unique for Gaim
412 instances, and the documentation for the gtk_window_set_wmclass function says
413 explicitly not to use it for anything else. Before we released Gaim 0.60, we
414 replaced all calls to this function with calls to gtk_window_set_role(),
415 which sets the WM_WINDOW_ROLE hint instead. If your window manager is having
416 problems differentiating between Gaim windows, please ensure that your window
417 managers uses the WM_WINDOW_ROLE hint per the ICCCM.
393 418
394 2.12 Why is the toggle to disable tabs not working? 419 2.12 Why is the toggle to disable tabs not working?
395 420
396 You have told gaim (or have neglected to change the default) to place tabs in 421 Because your conversation placement setting is incorrect. Go to Preferences->
397 the "Last Created Window" instead of in a "New Window." Change this tab 422 Conversation->Placement and set this to "New Window." Bada bing. Although, I
398 placement option and you will be all set. 423 don't know why anyone would not want to use tabs.
399 424
400 2.13 What is a "Buddy Pounce"? 425 2.13 What is a "Buddy Pounce"?
401 426
402 Gaim introduced buddy pounces a few releases before AOL came out with "Buddy 427 Gaim introduced buddy pounces a few releases before AOL came out with "Buddy
403 Alerts." Despite this though, you could think of a buddy pounce as an Alert 428 Alerts." Despite this though, you could think of a buddy pounce as an Alert
404 and get an idea of the most minimal uses of a buddy pounce. In reality, a 429 and get an idea of the most minimal uses of a buddy pounce. In reality, a
405 buddy pounce is much like a macro, or a recorded action. When you set a 430 buddy pounce is much like a macro, or a recorded action. When you set a
406 pounce on someone, you choose from a number of events, such as signon or 431 pounce on someone, you choose from a number of events, such as signon or
408 actions include everything from playing a sound (like an Alert would do) to 433 actions include everything from playing a sound (like an Alert would do) to
409 sending a messsage to the person, to executing a command. This action will 434 sending a messsage to the person, to executing a command. This action will
410 occur the next time gaim detects the event, ie the next time the person in 435 occur the next time gaim detects the event, ie the next time the person in
411 your buddy list who you have pounced signs on. 436 your buddy list who you have pounced signs on.
412 437
413 2.14 How do I get rid of the buddy icons in the taskbar? 438 2.14 Where does gaim store its logs?
414 439
415 As of 0.71, you do not. 440 On unix, they are in ~/.gaim/logs, on win32 they are in the $drive/documents
441 and settings/user/application data/.gaim/logs directory. In either case, new
442 logs (new as of 0.73) are in subdirectories that correspond to protocol\
443 yourscreenname\theirscreenname.
444
445 2.15 Can I use Gaim for e-mail, blogging, an RSS feed, or something else that
446 isn't IM-related?
447
448 No, you can't. We get requests for this often, but Gaim is indeed an instant
449 messenger client. Aside from the capabilities each protocol may support, the
450 Gaim developers have no intention to turn Gaim into a multi-feature Internet
451 client capable of doing everything under the sun. We also won't be helping to
452 develop plugins to turn it into that. There are many Internet applications
453 available for Linux, Windows, or whatever operating system you use that would
454 undoubtably do a better job.
416 455
417 +------------------------------------------------------------------------------ 456 +------------------------------------------------------------------------------
418 | 3. Features 457 | 3. Features
419 +------------------------------------------------------------------------------ 458 +------------------------------------------------------------------------------
420 459
421 3.1 Can Gaim send files? 460 3.1 Does Gaim support file transfer?
422 461
423 TOC can, in a limited way, and OSCAR can send files over AIM in 0.60 and 462 Somewhat, yeah. Yahoo! supports sending and receiving files in Gaim 0.75 and
424 higher. Most protocols are capable of it, but Gaim hasn't implemented 463 higher. As of 0.76 the following is supported:
425 anything yet. Support is being worked on and may partially work for MSN and 464
426 Jabber. 465 * Sending and receiving files on AIM (although it might be a bit buggy)
427 466 * Sending and receiving files on IRC
428 3.2 When will file transfer be supported? Is it being worked on? 467 * Sending and receiving files on Jabber
429 468 * Sending and receiving files on Yahoo (sending is limited to 1Mb)
430 Gaim 0.60 includes preliminary file transfer support. It likely contains a 469
431 few bugs that will be fixed in time. Currently, Gaim supports sending and 470 Most of the protocols themselves support file transfer, but Gaim has not been
432 receiving files via AIM, receiving files via Jabber and IRC. File transfer 471 written to support it yet. If you would like file transfer to work better or
433 receive code exists for MSN, but it is very flakey, and files are often 472 be more complete, get CVS and submit a patch using the generic file transfer
434 corrupt. If you would like support for another protocol, get CVS and submit a 473 API.
435 patch using the generic file transfer API. 474
436 475 3.2 Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or
437 3.3 File Transfer for xxxx doesn't seem to be working.
438
439 File transfer for all protocols is still buggy. This is being worked on, but
440 has no set date for completion.
441
442 3.4 Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or
443 something? 476 something?
444 477
445 In 0.59.x and below, Gaim only has support for Gnome's panel. Gaim 0.60 and 478 Yeah, Gaim supports what is called a system tray icon that conforms to the
446 higher have replaced the gnome-applet with a tray icon that conforms to the 479 standards at www.freedesktop.org. This tray icon is supported by Windows, KDE
447 standards at www.freedesktop.org. This tray icon is supported in KDE 3.1, 480 3.1, Gnome 2.2, and Red Hat Gnome 2.0. All you have to do is load the "System
448 Gnome 2.2, and Red Hat Gnome 2.0. Gaim will insert the tray icon in any 481 Tray Icon" plugin by going to Preferences and then Plugins.
482
483 If you're using Gnome you need to make sure that your panel has a
484 Notification Area on it. To add one, right click on the panel, select Add To
485 Panel->Utility->Notification Area. Gaim will insert the tray icon in any
449 System Tray implementation that conforms to these standards, so feel free to 486 System Tray implementation that conforms to these standards, so feel free to
450 write one for your window manager of choice. For Gnome, you must have a 487 write one for your window manager of choice.
451 Notification Area in your Gnome panel. 488
452 489 3.3 What do those colors in the conversation tab mean?
453 This docklet is the only supported way of putting Gaim in a Gnome2 panel. The 490
454 panel applet (the gaim-applet rpm, the gaim-gnome deb package and compiling
455 with the --enable-panel flag) is only supported with Gaim 0.59.x and Gnome
456 1.x, the GTK1.2 versions of Gnome.
457
458 3.5 What do those colors in the conversation tab mean?
459
460 A red tab means a message is waiting for you; green means the buddy is 491 A red tab means a message is waiting for you; green means the buddy is
461 typing; yellow means the buddy began typing, and then stopped. Gray means 492 typing; yellow means the buddy began typing, and then stopped. Gray means
462 that there has been a join or a part in that chat. 493 that there has been a join or a part in that chat, or the buddy has signed
463 494 off.
464 3.6 Will Gaim save my buddy list to the server? 495
465 496 3.4 Will Gaim save my buddy list to the server?
466 Yes, as of 0.60 Gaim saves your buddy list to the server for AIM, ICQ, MSN, 497
467 Yahoo, TOC and Jabber. Gaim 0.59.x supports this for AIM, MSN, Yahoo, TOC and 498 Yes, Gaim saves your buddy list to the server for AIM, ICQ, MSN, Yahoo, TOC
468 Jabber. 499 and Jabber.
469 500
470 3.7 How come there's no Export Buddy List? 501 3.5 Can I import or export my buddy list?
471 502
472 In 0.59 and earlier you can use cp to copy your buddy list. It is stored in 503 Sorry, no. Old versions of Gaim supported this, but new versions do not. All
473 the $HOME/.gaim directory. The file name is your screen name, in all capital 504 the code for saving and loading buddy lists was rewritten, and support for
474 letters. Gaim 0.60 does not support exporting your buddy list. 505 importing and exporting buddy lists was never re-added. However, with all
475 506 major protocols storing their buddy lists on the server, this feature is less
476 Import and export code will hopefully be reintroduced for one of the 0.6x 507 useful today than in the past.
477 releases, due to the introduction of the unified xml buddy list in 0.60. 508
478 509 3.6 Does Gaim support animated smileys?
479 3.8 Can Gaim import my buddy list? 510
480
481 Unfortunately, no, you cannot import your buddy list with Gaim 0.60 and
482 later. However, as Gaim will read the server copy of the buddy list, this is
483 most likely not necessary unless you use a 3rd party client that is broken
484 (aka trillian).
485
486 With Gaim 0.59 and earlier, this depends on the format of the buddy list.
487 Gaim has mixed success importing Windows AIM buddy lists. If you want to try,
488 click File->Import. This is accessible after you sign on. If you want to
489 import an Licq (http://licq.org/) contact list, you can try using the
490 licq2gaim.pl perl script, which comes with the Gaim source code, but we do
491 not support this.
492
493 3.9 Does Gaim support animated smileys?
494
495 Yes, as of version 0.70 Gaim supports animated smileys. 511 Yes, as of version 0.70 Gaim supports animated smileys.
496 512
497 3.10 Can I make Gaim group screen names by the person that owns them? 513 3.7 Can I make Gaim group screen names by the person that owns them? You know,
498 514 like Trillian's Meta Contacts?
515
499 Sure! Right click a buddy on your list and at the bottom of the menu click 516 Sure! Right click a buddy on your list and at the bottom of the menu click
500 "Expand". Then just drag other screen names to the same person below it. When 517 "Expand". Then just drag other screen names to the same person below it. When
501 you're done, click on the arrow to collapse them. When the contact is 518 you're done, click on the arrow to collapse them. When the contact is
502 collapsed, Gaim will select a buddy to display based on the status of the 519 collapsed, Gaim will select a buddy to display based on the status of the
503 buddies in the contact, and their order. 520 buddies in the contact, and their order.
504 521
522 3.8 How do I get the old logging back?
523
524 The old logging was removed because it was deficient in many ways. There is
525 no way in gaim itself to revert to the old logging, but the new logging is so
526 good you could implement something similar to the old logging as a plugin.
527
528 3.9 How can I convert my old logs to the new format?
529
530 It's not possible to perfectly convert from the old format to the new format
531 because the old format is missing some information necessary to do that (eg.
532 which account the messages were sent from).
533
534 It shouldn't be too difficult to do a rough conversion using a small script,
535 or using the old_logger_* functions in gaim itself.
536
537 Peter Johnson has written a python script to do just this, it is available on
538 his website (at the bottom).
539
540 3.10 Where has the system log gone?
541
542 The system log had to be removed when the new logging was implented. It will
543 make a return someday, just be patient. Or if you're brave there is a patch
544 in the patch tracker on sourceforge that re-implements system logging.
545
505 +------------------------------------------------------------------------------ 546 +------------------------------------------------------------------------------
506 | 4. ICQ Protocol 547 | 4. ICQ Protocol
507 +------------------------------------------------------------------------------ 548 +------------------------------------------------------------------------------
508 549
509 4.1 How do I use ICQ? 550 4.1 How do I use ICQ?
510 551
511 ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim (see the 552 ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim. To use
512 question ICQ doesn't work for why). To use it, simply put your account number 553 it, simply put your account number in the Screenname box and your password in
513 in the Screenname box and your password in the Password box. Leave the server 554 the Password box. Leave the server settings set to the default
514 settings set to the default (login.oscar.aol.com and port 5190). 555 (login.oscar.aol.com and port 5190).
515 556
516 4.2 ICQ doesn't work. 557 4.2 Can I send SMS messages?
517 558
518 Use AIM/ICQ for ICQ. AOL stopped supporting the older versions of the ICQ 559 Kind of. See our answer to this for the AIM/ICQ Protocol.
519 protocol. The newer versions are extensions of Oscar, which is labeled AIM/
520 ICQ in Gaim. Currently, Oscar supports as much of ICQ as the ICQ plugin used
521 to. To use Oscar for ICQ, put your UIN in the Screenname box, and leave the
522 server information alone.
523
524 4.3 Gaim 0.60 pops up a bunch of authorization request Dialogs.
525
526 This is a side effect of enabling support for the server side lists. Yes, you
527 must re-request authorization, we can't find a way around this requirement.
528 560
529 +------------------------------------------------------------------------------ 561 +------------------------------------------------------------------------------
530 | 5. TOC Protocol 562 | 5. TOC Protocol
531 +------------------------------------------------------------------------------ 563 +------------------------------------------------------------------------------
532 564
533 5.1 What is the TOC protocol? 565 5.1 What is the TOC protocol?
534 566
535 It's an AIM protocol used by quickbuddy and aimexpress. It's not particularly 567 It's an AIM protocol used by quickbuddy and aimexpress. It's recommended that
536 recommended that you use it unless you know what it is. :) The only time it 568 you don't use it. You should use Gaim's OSCAR (AIM/ICQ) protocol, instead. We
537 would be useful in Gaim is if Gaim's OSCAR (AIM/ICQ) protocol stopped working 569 keep TOC around in case OSCAR ever stops working.
538 for some reason, such as being blocked. 570
539 571 +------------------------------------------------------------------------------
540 +------------------------------------------------------------------------------ 572 | 6. AIM/ICQ (OSCAR) Protocol
541 | 6. AIM/ICQ (Oscar) Protocol 573 +------------------------------------------------------------------------------
542 +------------------------------------------------------------------------------ 574
543 575 6.1 Can I set my profile?
544 6.1 Can I set a buddy icon? 576
545 577 Yes you can. Go to Tools->Protocol Actions
578
579 6.2 Can I set a buddy icon?
580
546 Yes. Go to the Account Editor (Tools->Accounts from the buddy list), and 581 Yes. Go to the Account Editor (Tools->Accounts from the buddy list), and
547 click to "Modify" the AIM/ICQ account you wish to have an icon. Enter the 582 click to "Modify" the AIM/ICQ account you wish to have an icon. Enter the
548 full path to the image you wish to use in the box labeled "Buddy Icon File." 583 full path to the image you wish to use in the box labeled "Buddy Icon File."
549 The file must be below 4KB. It can have any dimensions, and can be in any 584 The file must be below 4KB. It can have any dimensions, and can be in any
550 format. However, if you wish Windows users to see it, it must be in a format 585 format. However, if you wish Windows users to see it, it must be in a format
551 Windows understands, such as .bmp, .gif, and .jpg. 586 Windows understands, such as .bmp, .gif, and .jpg.
552 587
553 6.2 Some of my buddies are not showing up as online, why is that? 588 6.3 Some of my buddies are not showing up as online, why is that?
554 589
555 AOL has set a limit for the maximum number of people you can have in your 590 AOL has set a limit for the maximum number of people you can have in your
556 buddy list. This number is currently 200. Gaim 0.58 and newer give you a 591 buddy list. This number is currently 200. If you don't think you are anywhere
557 warning if you are over the limit, but if you are using something prior to 592 near that limit, it is possible that your server-stored buddy list is
558 0.58, make sure you are not over the limit (and upgrade to something more 593 corrupt.
559 recent!). 594
560 595 If you think this might be the case, you can try the following steps to
561 The other possibility is that your server-stored buddy list is corrupt. 596 "clean" your list (be careful doing this, if you do something wrong you could
562 Unfortunately, Gaim 0.53 had a bug that caused it to corrupt some entries, 597 lose your buddy list!):
563 especially group names. While this corruption doesn't show in Gaim unless you 598
564 remove the SCREENNAME.0.blist file from ~/.gaim, it does affect how long the 599 1. Exit Gaim
565 server thinks your list is. The best way to fix this, is to: 600 2. mv ~/.gaim/blist.xml ~/
566 601 3. rm ~/.gaim/*.blist
567 mv ~/.gaim/SCREENNAME.0.blist ~/ 602 4. Start Gaim and sign on your AIM account
568 603 5. Delete everyone from your buddy list then sign off
569 where SCREENNAME is your screenname, without spaces and in all caps. Then 604 6. Repeat the above two steps until you are sure your list is empty
570 signon, delete all groups, signoff, and signon again to verify that your list 605 7. Exit Gaim
571 is empty. Once it is empty, signoff, mv your SCREENNAME.0.blist file back 606 8. cp ~/blist.xml ~/.gaim/
572 into ~/.gaim, then sign on again. This should not be necessary in Gaim 0.60 607 9. Start Gaim and sign on your AIM account
573 and higher. 608
574 609 6.4 Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
575 If you have 0.60 or higher, move ~/.gaim/blist.xml instead. 610
576
577 6.3 Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
578
579 Yes, with Gaim 0.60 and higher, but it can be difficult to set up. You need 611 Yes, with Gaim 0.60 and higher, but it can be difficult to set up. You need
580 to pass the entire URI to the gaim-remote program (included with gaim). To do 612 to pass the entire URI to the gaim-remote program (included with gaim). To do
581 this with Gnome 2, run gnome-file-types-properties or "File Types and 613 this with Gnome 2, run gnome-file-types-properties or "File Types and
582 Programs" from the preferences menu. Add a service with protocol "aim" and 614 Programs" from the preferences menu. Add a service with protocol "aim" and
583 set the program to gaim-remote uri "%s". This will make AIM URIs work in 615 set the program to gaim-remote uri "%s". This will make AIM URIs work in
584 Galeon 2. Also, not all types of aim URI's are supported. The ones that are 616 Galeon 2. Also, not all types of aim URI's are supported. The ones that are
585 supported are goim, addbuddy, and gochat. 617 supported are goim, addbuddy, and gochat.
586 618
619 You'll need the "Remote Control" plugin loaded for this to work.
620
587 If you use wingaim, this will not work as gaim-remote has not yet been ported 621 If you use wingaim, this will not work as gaim-remote has not yet been ported
588 over. 622 over.
589 623
590 6.4 IM Image doesn't work, why? 624 6.5 Does Gaim support DirectIM and IM Image?
591 625
592 IM Image is very sensitive, even from windows. Gaim currently only supports 626 Yeah, kind of. This tends to be one of the buggier areas of Gaim. If it's not
593 sending IM Images if the sender is not behind a firewall or NAT device. Given 627 working for you make sure that the person requesting the DirectIM is not
594 that the windows version of AIM also has trouble in this situation, we are 628 behind a firewall.
595 not sure this is entirely fixable. A work around that is sometimes effective 629
596 is to have the receiver, not being behind a firewall, request a direct 630 6.6 Can I send SMS messages?
597 connection, then send the image. 631
598 632 Yep, just send an IM to the person's phone number. For example, if the phone
599 In cvs, the html widget is being re-written. it currently does not support 633 number is (919) 555-1234, you would IM the screenname +19195551234 We think
600 many features of the old widget we used with GTK1.2, including images. 634 this should work for contries with a country code of 1 (the United States and
601 635 Canada).
602 6.5 I sent an IM Image, but only a blank line shows up, why? 636
603 637 Sending SMS messages using "the ICQ method" is not yet supported.
604 For Gaim 0.59.x and lower, You need to have gdk-pixbuf installed to view IM 638
605 Images. If the receiver is also using Gaim, [s]he also needs to have this 639 6.7 Can I add SMS numbers to my buddy list?
606 installed. 640
607
608 6.6 Can I add SMS numbers to my buddy list?
609
610 Not currently. This functionality has been broken since around September 641 Not currently. This functionality has been broken since around September
611 2003. There is no ETA for when it will be fixed. 642 2003. There is no ETA for when it will be fixed.
612 643
613 6.7 I heard AOL is combining ICQ and AIM, does that mean I can send a message 644 6.8 I heard AOL is combining ICQ and AIM, does that mean I can send a message
614 from an AIM account to an ICQ account and vice-versa? 645 from an AIM account to an ICQ account and vice-versa?
615 646
616 Yes, AOL is slowly letting the two messaging networks interoperate with each 647 Yes, AOL is slowly letting the two messaging networks interoperate with each
617 other. Messaging between the two protocols works as long as the receiver of 648 other. Messaging between the two protocols works as long as the receiver of
618 the message supports it. Gaim 0.60 supports sending and receiving messages 649 the message supports it. Gaim 0.60 supports sending and receiving messages
619 between AIM and ICQ, but the person receiving the message must support this. 650 between AIM and ICQ, but the person receiving the message must support this.
620 Gaim, of course, supports this for both ICQ and AIM accounts. Windows AIM 651 Gaim, of course, supports this for both ICQ and AIM accounts. Windows AIM
629 network will also show up in buddy lists of people using the alternate 660 network will also show up in buddy lists of people using the alternate
630 network. This means that if you can message an ICQ user from an AIM account, 661 network. This means that if you can message an ICQ user from an AIM account,
631 then the ICQ user will also show up in your AIM buddy list. So an AIM user 662 then the ICQ user will also show up in your AIM buddy list. So an AIM user
632 using Windows AIM version 5.2.3139 will show up in an ICQ buddy list. 663 using Windows AIM version 5.2.3139 will show up in an ICQ buddy list.
633 664
634 6.8 Why can't I connect via either Oscar or TOC? 665 6.9 Why can't I connect via either Oscar or TOC?
635 666
636 If you are using Linux, your kernel may be using a network option called 667 If you are using Linux, your kernel may be using a network option called
637 "ECN". It seems that the AOL servers are currently dropping packets marked as 668 "ECN". It seems that the AOL servers are currently dropping packets marked as
638 "ECN-capable". In order to turn this off, run the command "echo 0 > /proc/sys 669 "ECN-capable". In order to turn this off, run the command "echo 0 > /proc/sys
639 /net/ipv4/tcp_ecn" as root, or (if your distribution supports it) put the 670 /net/ipv4/tcp_ecn" as root, or (if your distribution supports it) put the
640 line "net.ipv4.tcp_ecn = 0" in the file /etc/sysctl.conf. 671 line "net.ipv4.tcp_ecn = 0" in the file /etc/sysctl.conf.
642 +------------------------------------------------------------------------------ 673 +------------------------------------------------------------------------------
643 | 7. IRC Protocol 674 | 7. IRC Protocol
644 +------------------------------------------------------------------------------ 675 +------------------------------------------------------------------------------
645 676
646 7.1 Why am I getting disconnected when I try to connect to IRC? 677 7.1 Why am I getting disconnected when I try to connect to IRC?
647 678
648 You will be disconnected if the nickname you chose is already in use on that 679 You will be disconnected if the nickname you chose is already in use on that
649 IRC server. Try again with a different nickname. In 0.60 or later, Gaim will 680 IRC server. Try again with a different nickname. In 0.60 or later, Gaim will
650 prompt you to change your screenname in this situation. 681 prompt you to change your screenname in this situation.
651 682
652 7.2 How do I join a channel with the IRC plugin? 683 7.2 How do I join a channel with the IRC plugin?
653 684
654 First create the account, then sign on. After you have signed on, you can use 685 First create the account, then sign on. After you have signed on, you can use
655 File->Join A Chat on the buddy list to join a channel. In any window, either 686 File->Join A Chat on the buddy list to join a channel. In any window, either
656 a conversation or a chat, in which your IRC user is the sender, you can also 687 a conversation or a chat, in which your IRC user is the sender, you can also
657 use /join to connect to a new channel. 688 use /join to connect to a new channel.
658 689
659 7.3 Is there a way to make Gaim automatically identify me and/or join IRC 690 7.3 Is there a way to make Gaim automatically identify me and/or join IRC
660 chats on login? 691 chats on login?
661 692
662 Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it. 693 Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it.
663 694
664 In version 0.64 or higher, you can add a chat to your buddy list, right click 695 In version 0.64 or higher, you can add a chat to your buddy list, right click
665 it, and tell gaim to auto-join it. 696 it, and tell gaim to auto-join it.
666 697
667 +------------------------------------------------------------------------------ 698 +------------------------------------------------------------------------------
668 | 8. Jabber Protocol 699 | 8. Jabber Protocol
669 +------------------------------------------------------------------------------ 700 +------------------------------------------------------------------------------
670 701
671 8.1 How do I choose which Jabber server to use? 702 8.1 How do I choose which Jabber server to use?
672 703
673 The Jabber server name is part of your Jabber I.D., such as 704 The Jabber server name is part of your Jabber I.D., such as
674 somebody@server.name. So when entering your Jabber "screen name", the server 705 somebody@server.name. So when entering your Jabber "screen name", the server
675 is specified as part of your JID. 706 is specified as part of your JID.
676 707
677 8.2 How do I change my Jabber resource to be other than the default of "/ 708 8.2 How do I change my Jabber resource to be other than the default of "/
678 GAIM"? 709 Gaim"?
679 710
680 When you create your account in Gaim, simply append the desired resource 711 When you create your account in Gaim, simply append the desired resource
681 identifier to your Jabber I.D. For example: somebody@server.name/resource 712 identifier to your Jabber I.D. For example: somebody@server.name/resource
682 713
683 8.3 How do I register a new Jabber account? 714 8.3 How do I register a new Jabber account?
684 715
685 As of version 0.52 and up: 716 As of version 0.52 and up:
686 717
687 1. Click "Tools->Accounts->Add" 718 1. Click "Tools->Accounts->Add"
688 2. Select "Jabber" for the protocol. 719 2. Select "Jabber" for the protocol.
689 3. Fill in screen name and password as you normally would. THIS IS A 720 3. Fill in screen name and password as you normally would. THIS IS A
694 Note: You are strongly recommended to check the "Remember password" check-box 725 Note: You are strongly recommended to check the "Remember password" check-box
695 as well, as Gaim presently does no password verification. So if you don't 726 as well, as Gaim presently does no password verification. So if you don't
696 type in what you thought you did, you're hosed. 727 type in what you thought you did, you're hosed.
697 728
698 8.4 How do I use invisibility? 729 8.4 How do I use invisibility?
699 730
700 Jabber invisibility support is available in Gaim version 0.60 and later. 731 Jabber invisibility support is available in Gaim version 0.60 and later.
701 732
702 There are two ways to use Jabber invisibility: on a per-buddy and on a 733 There are two ways to use Jabber invisibility: on a per-buddy and on a
703 per-server basis. 734 per-server basis.
704 735
724 Gaim currently does not retain invisibility settings between logins, just as 755 Gaim currently does not retain invisibility settings between logins, just as
725 it doesn't currently retain "away" status. 756 it doesn't currently retain "away" status.
726 757
727 8.5 I've a buddy that I keep removing from my buddy list but the entry keeps 758 8.5 I've a buddy that I keep removing from my buddy list but the entry keeps
728 coming back every time I log in again! How can I stop this? 759 coming back every time I log in again! How can I stop this?
729 760
730 As of Gaim version 0.59 and later: Select the Edit Buddies tab, right-click 761 As of Gaim version 0.59 and later: Select the Edit Buddies tab, right-click
731 on the offending entry, and select "Remove From Roster. 762 on the offending entry, and select "Remove From Roster".
763
764 If you're Gaim 0.60 or later, it might be continuing to import the old buddy
765 lists. Remove ~/.gaim/*.blist - these are no longer used, the buddy list is
766 now stored in ~/.gaim/blist.xml
732 767
733 8.6 Can I remove a buddy from my Jabber roster entirely? 768 8.6 Can I remove a buddy from my Jabber roster entirely?
734 769
735 As of Gaim version 0.59 and later: yes. In the Edit Buddies tab, right-click 770 As of Gaim version 0.59 and later: yes. In the Edit Buddies tab, right-click
736 on a buddy and Select "Remove From Roster. 771 on a buddy and Select "Remove From Roster.
737 772
738 The buddy will disappear from your buddy list and also will no longer receive 773 The buddy will disappear from your buddy list and also will no longer receive
739 presence notifications from you. 774 presence notifications from you.
741 In 0.60, the deletion code will do this. Gaim currently does not retain 776 In 0.60, the deletion code will do this. Gaim currently does not retain
742 invisibility settings between logins, just as it doesn't currently retain 777 invisibility settings between logins, just as it doesn't currently retain
743 "away" status. 778 "away" status.
744 779
745 8.7 What does "Cancel Presence Notification" do? 780 8.7 What does "Cancel Presence Notification" do?
746 781
747 This selection, available in Gaim version 0.60 and later, and found by 782 This selection, available in Gaim version 0.60 and later, and found by
748 right-clicking on a buddy entry in the Edit Buddies tab, prevents that Jabber 783 right-clicking on a buddy entry in the Edit Buddies tab, prevents that Jabber
749 I.D. from receiving future presence notifications when you log on to the 784 I.D. from receiving future presence notifications when you log on to the
750 server. 785 server.
751 786
752 After you do this, that buddy will have to re-request a subscription to your 787 After you do this, that buddy will have to re-request a subscription to your
753 presence (and you will have to approve it) for them to again see you on-line. 788 presence (and you will have to approve it) for them to again see you on-line.
754 789
755 +------------------------------------------------------------------------------ 790 +------------------------------------------------------------------------------
756 | 9. Y!M (yahoo) Protocol 791 | 9. Y!M (Yahoo) Protocol
757 +------------------------------------------------------------------------------ 792 +------------------------------------------------------------------------------
758 793
759 9.1 I cannot connect to yahoo! 794 9.1 I cannot connect to yahoo!
760 795
761 Make sure you have at least 0.70. If you still cannot connect, change the 796 Make sure you have at least 0.76.
762 host you connect to from scs.yahoo.com to scs.msg.yahoo.com
763 797
764 +------------------------------------------------------------------------------ 798 +------------------------------------------------------------------------------
765 | 10. MSN Protocol 799 | 10. MSN Protocol
766 +------------------------------------------------------------------------------ 800 +------------------------------------------------------------------------------
767 801
768 10.1 I'm getting lots of "Already in Opposite list" errors on msn, why? 802 10.1 I'm getting lots of "Already in Opposite list" errors on msn, why?
769 803
770 The reason this happens is because you have a screenname in both your permit 804 The reason this happens is because you have a screenname in both your permit
771 list and your deny list. There are two ways to fix this: the correct way and 805 list and your deny list. There are two ways to fix this: the correct way and
772 the quick way. The correct way is to go to tools->preferences (tools->privacy 806 the quick way. The correct way is to go to tools->preferences (tools->privacy
773 in 0.60 or later), and manually scan the list and remove the duplicate 807 in 0.60 or later), and manually scan the list and remove the duplicate
774 entries. The quick way is to remove the msn .blist file from the ~/.gaim 808 entries. The quick way is to remove the msn .blist file from the ~/.gaim
775 directory. This will have a side effect: the msn server stores the 809 directory. This will have a side effect: the msn server stores the
776 screennames of your contacts, but does not store what group they are in, so 810 screennames of your contacts, but does not store what group they are in, so
777 you will have to re-sort your msn contacts into the appropriate groups. 811 you will have to re-sort your msn contacts into the appropriate groups. The
778 812 buddy list is ~/.gaim/blist.xml in 0.60 and later, but be aware that this
779 10.2 I'm getting an "Invalid User" popop whenever I sign on. How can I make 813 contains your buddy list for all accounts, and also stores the "Contact"
814 grouping of Buddies.
815
816 10.2 I'm getting an "Invalid User" popup whenever I sign on. How can I make
780 this go away? 817 this go away?
781 818
782 Delete your buddy list. On unix, this will be at ~/.gaim/blist.xml (or ~ 819 Delete your buddy list. On unix, this will be at ~/.gaim/blist.xml (or ~
783 /.gaim/USERNAME.0.blist pre-v0.60). Note that you will lose buddy groups and 820 /.gaim/USERNAME.0.blist pre-v0.60). Note that you will lose buddy groups and
784 aliases when you do this. Alternatively, since this will delete ALL buddy 821 aliases when you do this. Alternatively, since this will delete ALL buddy
785 lists, not just the msn one, you can hand edit the ~/.gaimrc to remove the 822 lists, not just the msn one, you can hand edit the ~/.gaimrc to remove the
786 msn account. Start gaim up, which will remove the entries from the account 823 msn account. Start gaim up, which will remove the entries from the account
787 that no longer exists, and re-add your account. For most users, this will be 824 that no longer exists, and re-add your account. For most users, this will be
788 the better temporary solution. 825 the better temporary solution.
789 826
790 10.3 Is there a way to invite more than one person to an MSN chat? 827 10.3 Is there a way to invite more than one person to an MSN chat?
791 828
792 Not at this time. When the conversation framework gets another rewrite, it is 829 Not at this time. When the conversation framework gets another rewrite, it is
793 possible that it will be worked on. Until that time, sorry. :) 830 possible that it will be worked on. Until that time, sorry. :)
794 831
795 10.4 Is MSNP9 (MSN6) going to be supported? 832 10.4 Is MSNP9 (MSN6) going to be supported?
796 833
797 MSNP9 support has existed in Gaim since 0.69. However, at this point, 834 MSNP9 support has existed in Gaim since 0.69. However, at this point,
798 features such as custom smileys and buddy icons aren't yet implemented. 835 features such as custom smileys and buddy icons aren't yet implemented.
799 836
800 10.5 Will I be able to use Gaim for MSN after October 15th? (The day they're 837 10.5 Will I be able to use Gaim for MSN after October 15th 2003? (The day
801 preventing third party clients from connecting) 838 they're preventing third party clients from connecting)
802 839
803 Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is supported 840 Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is supported
804 after October 15th. 841 after October 15th 2003.
805 842
806 10.6 I just upgraded Gaim and the MSN plugin will not load. Why? 843 10.6 I just upgraded Gaim and the MSN plugin will not load. Why?
807 844
808 You did not compile with SSL support, or the SSL plugin failed to load. As of 845 You did not compile with SSL support, or the SSL plugin failed to load. As of
809 protocol version 9, the MSN protocol requires the use of SSL, which gaim 846 protocol version 9, the MSN protocol requires the use of SSL, which gaim
810 provides by either GnuTLS or the combination of NSS and NSPR from the Mozilla 847 provides by either GnuTLS or the combination of NSS and NSPR from the Mozilla
811 project. Install one or both of these and recompile Gaim, and see the next 848 project. Install one or both of these and recompile Gaim, and see the next
812 question. 849 question.
813 850
814 10.7 The MSN plugin won't load, but I have Mozilla NSS! 851 10.7 The MSN plugin won't load, but I have Mozilla NSS!
815 852
816 Some distributions, including Slackware, install Mozilla NSS to a 853 Some distributions, including Slackware, install Mozilla NSS to a
817 non-standard directory. The fix is simple. Edit /etc/ld.so.conf and add /usr/ 854 non-standard directory. The fix is simple. Edit /etc/ld.so.conf and add /usr/
818 lib/mozilla-1.4 (or whatever version you're using, but it's usually 1.4) to 855 lib/mozilla-1.4 (or whatever version you're using, but it's usually 1.4) to
819 the file, and run ldconfig as root. Then re-run configure and recompile Gaim. 856 the file, and run ldconfig as root. Then re-run configure and recompile Gaim.
820 You may also need to specify where the include file are for NSS and NSPR, see 857 You may also need to specify where the include file are for NSS and NSPR, see
821 ./configure --help for the options. 858 ./configure --help for the options.
822 859
823 Mozilla 1.5 has a broken .pc file and does not install the necessary .h 860 Mozilla 1.5 has a broken .pc file and does not install the necessary .h
824 files, and so will not be detected. 861 files, and so will not be detected.
825 862
826 See http://gaim.sf.net/faq-ssl.php on getting ssl to work with gaim. 863 See http://gaim.sf.net/faq-ssl.php on getting SSL to work with gaim.
864
865 10.8 What does "MSN: S: 911 3" in the debug window mean when I cannot connect
866 to msn?
867
868 See http://gaim.sf.net/911.txt.
827 869
828 +------------------------------------------------------------------------------ 870 +------------------------------------------------------------------------------
829 | 11. Gadu-Gadu Protocol 871 | 11. Gadu-Gadu Protocol
830 +------------------------------------------------------------------------------ 872 +------------------------------------------------------------------------------
831 873
832 11.1 What is Gadu-Gadu? 874 11.1 What is Gadu-Gadu?
833 875
834 Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at 876 Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at
835 http://www.gadu-gadu.pl (website in Polish). 877 www.gadu-gadu.pl (website in Polish).
836 878
837 +------------------------------------------------------------------------------ 879 +------------------------------------------------------------------------------
838 | 12. Trepia Protocol 880 | 12. Zephyr Protocol
839 +------------------------------------------------------------------------------ 881 +------------------------------------------------------------------------------
840 882
841 12.1 I heard Trepia was going to be in 0.65. Where is it? 883 12.1 What is Zephyr?
842 884
885 Zephyr is an IM protocol developed at MIT for use with Project Athena. Its
886 features include Kerberos IV authentication, multi-level chats (aka
887 "subscriptions"). You're probably using this because your college/employer/
888 organization uses it as a local IM/chat system. If not, you probably don't
889 have a server to connect to.
890
891 12.2 Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with "Couldn't
892 initialize zephyr".
893
894 Your site might require the use of Kerberos 4 for authentication, though few
895 (if any) prepackaged gaim binaries compile it with Kerberos support. The
896 solution is to compile gaim with the --with-krb4 flag to point to the
897 location of your Kerberos 4 devel files, usually one of /usr, /usr/local, or
898 /usr/athena , e.g. ./configure --with-krb4=/path/to/kerberosIV
899
900 12.3 Gaim isn't working, but I never got any other zephyr client working on
901 this machine.
902
903 You need to have zhm (which comes with the standard zephyr distribution)
904 installed, and running, and pointed at your zephyr servers. e.g.
905
906 zhm z1.example.com z2.example.com z3.example.com
907
908 Alternately, there might be a firewall or a NAT between you and the zephyr
909 servers Zephyr doesn't work in an environment where incoming connections
910 cannot be made to arbitrary UDP ports.
911
912 +------------------------------------------------------------------------------
913 | 13. Trepia Protocol
914 +------------------------------------------------------------------------------
915
916 13.1 I heard Trepia was going to be in 0.65. Where is it?
917
843 Support for the Trepia protocol was removed right before 0.65's release. It 918 Support for the Trepia protocol was removed right before 0.65's release. It
844 may make it into a future version, but we're not sure yet. 919 may make it into a future version, but we're not sure yet.
845 920
846 12.2 Trepia is showing people in Japan, England, etc. on my buddy list. I 921 13.2 Trepia is showing people in Japan, England, etc. on my buddy list. I
847 thought this was supposed to show people in my area? 922 thought this was supposed to show people in my area?
848 923
849 We believe this to be the protocol, not Gaim. As Trepia continues to update 924 We believe this to be the fault of protocol, not Gaim. As Trepia continues to
850 and refine their protocol, it will become more accurate. If we find out 925 update and refine their protocol, it will become more accurate. If we find
851 otherwise, we will attempt to incorporate the changes necessary to act like 926 out otherwise, we will attempt to incorporate the changes necessary to act
852 the official client. 927 like the official client.
853 928
854 +------------------------------------------------------------------------------ 929 +------------------------------------------------------------------------------
855 | 13. Scripts and Plugins 930 | 14. Scripts and Plugins
856 +------------------------------------------------------------------------------ 931 +------------------------------------------------------------------------------
857 932
858 13.1 How do I use perl scripts with Gaim? 933 14.1 How do I use perl scripts with Gaim?
859 934
860 Save the perl script to ~/.gaim/ or $prefix/lib/gaim/, restart Gaim, and load 935 Save the perl script to ~/.gaim/plugins/ or $prefix/lib/gaim/, restart Gaim,
861 the perl script by checking the check box next to its name on the Plugins 936 and load the perl script by checking the check box next to its name on the
862 page in preferences. 937 Plugins page in preferences.
863 938
864 13.2 How do I compile a plugin for Gaim? 939 14.2 How do I compile a plugin for Gaim?
865 940
866 To compile a plugin for Gaim, you must have Gaim's source code. There are two 941 To compile a plugin for Gaim, you must have Gaim's source code. To download
867 ways to get this: Tarballs, and CVS. To work with a tarball, follow the 942 Gaim's source code, get the most recent tarball from http://
868 instructions below. To use CVS, follow the instructions on the CVS (http:// 943 gaim.sourceforge.net/downloads.php (http://gaim.sf.net/downloads.php) and
869 gaim.sf.net/cvs.php) page. Please note that often, CVS is much less stable 944 untar it with the command:
870 than the tarballs! Do not use CVS unless you are writting a patch.
871
872 To work with a tarball, download the latest source code from http://
873 gaim.sf.net/ and untar it with the command:
874
875 tar zxvf filename 945 tar zxvf filename
876
877 where filename is the file you downloaded. 946 where filename is the file you downloaded.
878 947
879 After you have a Gaim source code tree, either through tarballs or CVS: 948 After you have a Gaim source code tree:
880 949
881 1. Change to the resulting directory and run the command: 950 1. Change to the resulting directory and run the command:
882
883 ./configure 951 ./configure
884
885 This will create the necessary make files. 952 This will create the necessary make files.
886 2. Move the plugin you wish to compile into the plugins/ directory in the 953 2. Move the plugin you wish to compile into the plugins/ directory in the
887 Gaim source code tree. 954 Gaim source code tree.
888 3. Change to the plugins/ directory. 955 3. Change to the plugins/ directory.
889 4. Type: 956 4. Type:
890
891 make name.so 957 make name.so
892
893 where the name of the file you wish to compile is name.c. 958 where the name of the file you wish to compile is name.c.
894 959
895 Note well the difference in the extensions. If you type make name.c 960 Note well the difference in the extensions. If you type make name.c
896 instead of name.so, it won't work. 961 instead of name.so, it won't work.
897 962
898 5. After make finishes, you can move the plugin to a place that is more 963 5. After make finishes, you can move the plugin to a place that is more
899 convenient. $prefix/lib/gaim is suggested. If you installed Gaim by 964 convenient. $prefix/lib/gaim is suggested. If you installed Gaim by
900 compiling it yourself, $prefix is /usr/local by default. Otherwise, 965 compiling it yourself, $prefix is /usr/local by default. Otherwise,
901 $prefix is /usr. 966 $prefix is /usr.
902 967
903 13.3 I have a plugin or perl script for Gaim that does not work with 0.60 or 968 14.3 I have a plugin or perl script for Gaim that does not work with 0.60 or
904 higher. 969 higher.
905 970
906 The plugin and perl script API has changed in 0.60, which means plugins and 971 The plugin and perl script API has changed in 0.60, which means plugins and
907 perl scripts must be modified in order to work. The plugin or perl script 972 perl scripts must be modified in order to work. The plugin or perl script
908 must be located in $prefix/lib/gaim or in ~/.gaim, and must implement the new 973 must be located in $prefix/lib/gaim/ or in ~/.gaim/plugins/, and must
909 API, as documented in the howto file in the plugins directory. Plugins and 974 implement the new API, as documented in the HOWTO file in the plugins
910 perl scripts are now controled from preferences. 975 directory. Plugins and perl scripts are now controled from preferences.
911 976
912 13.4 Where can I find documentation on writing plugins and Perl scripts? 977 14.4 Where can I find documentation on writing plugins and Perl scripts?
913 978
914 If you look in the plugins/ directory in the Gaim source, you should see a 979 If you look in the plugins/ directory in the Gaim source, you should see a
915 HOWTO file for C plugins and a PERL-HOWTO for Perl scripts. 980 HOWTO file with some details for C plugins. Also be sure to check out our
916 981 online documentation (http://gaim.sf.net/api/index.html). Be especially sure
917 In 0.68 or later, get the source code and run make docs. You will need 982 to look at the Related Pages, which lists all of Gaim's signals, as well as a
918 doxygen and graphviz dot installed for this to work. This will produce an api 983 nice perl script HOWTO.
919 reference and both the perl and plugin documentation. 984
920 985 This documentation can be generated directly from the Gaim source by running
921 +------------------------------------------------------------------------------ 986 make docs. You will need doxygen and graphviz dot installed for this to work.
922 | 14. Development 987
923 +------------------------------------------------------------------------------ 988 +------------------------------------------------------------------------------
924 989 | 15. Development
925 14.1 Where should I report bugs? 990 +------------------------------------------------------------------------------
926 991
992 15.1 Can I help?
993
994 But of course. Just find something that's bugging you and fix it. There is a
995 slew of a bug reports in Gaim's bug report tracker, you could pick one and
996 try to tackle it and submit a patch. You could also help with general bug
997 triage by going through the bug reports and leaving comments such as "this
998 has been fixed" or "this is a duplicate of bug #12345." As always, make sure
999 you follow the same coding style used in Gaim, and make sure you don't break
1000 the core/UI split.
1001
1002 15.2 Gaim never leaves a core file.
1003
1004 On most installs core files are limited in size to 0 bytes, and are therefore
1005 not created. To rectify this situation, add ulimit -c unlimited to your
1006 startup scripts (~/.bash_profile is a good place) or run it manually in a
1007 terminal before starting gaim from that terminal. You can also run Gaim
1008 directly in gdb with gdb gaim.
1009
1010 15.3 Where should I report bugs?
1011
927 http://gaim.sf.net/bug.php. 1012 http://gaim.sf.net/bug.php.
928 1013
929 14.2 Gaim never leaves a core file. 1014 15.4 Where should I submit patches?
930 1015
931 On most installs, for some odd reason, core files are limited in size to 0
932 bytes, and so are not created. To rectify this situation, add ulimit -c
933 unlimited to your startup scripts or run it manually in a terminal before
934 starting gaim from that terminal.
935
936 14.3 Where should I submit patches?
937
938 http://gaim.sf.net/patches.php. 1016 http://gaim.sf.net/patches.php.
939 1017
940 14.4 Did you guys reverse engineer it? 1018 15.5 Did you guys reverse engineer it?
941 1019
942 TOC, Jabber, MSN, Napster, and IRC are published protocols, so we didn't have 1020 TOC, Jabber, MSN, Napster, and IRC are published protocols, so we didn't have
943 to reverse engineer those. Oscar, ICQ, and Yahoo are not published, and were 1021 to reverse engineer those. Oscar, ICQ, and Yahoo are not published, and were
944 reverse engineered by other people. 1022 reverse engineered by other people.
945 1023
946 14.5 Will Gaim be ported to Windows 95/98/Me/2000/XP? 1024 +------------------------------------------------------------------------------
947 1025 | 16. Misc. Questions
948 Gaim has released a Windows version. 1026 +------------------------------------------------------------------------------
949 1027
950 +------------------------------------------------------------------------------ 1028 16.1 Can I IM you guys?
951 | 15. Misc. Questions 1029
952 +------------------------------------------------------------------------------ 1030 Sure! Look at the Contact Information (http://gaim.sf.net/contactinfo.php)
953
954 15.1 Does AOL's attempts at blocking Trillian affect Gaim?
955
956 No.
957
958 15.2 Is Gaim affected by the vulnerability found in Windows AIM or Yahoo
959 Instant Messenger clients?
960
961 No.
962
963 15.3 Can I IM you guys?
964
965 Sure! Look at the Contact Information (http://gaim.sf.net//contactinfo.php)
966 page! 1031 page!
967 1032
968 15.4 Hello? 1033 16.2 Hello?
969 1034
970 We don't know how to answer this question. Stop asking it. 1035 We don't know how to answer this question. Stop asking it.
971 1036
972 15.5 Can I give you money/hardware/other expensive things that can be hocked 1037 16.3 Can I give you money/hardware/other expensive things that can be hocked
973 for cash what with you all being students/full-time-workers and helping 1038 for cash what with you all being students/full-time-workers and helping
974 to produce this wonderful software instead of studying/sleeping? 1039 to produce this wonderful software instead of studying/sleeping?
975 1040
976 No. We're completely fool-hardy and won't accept any gratuities with no 1041 No. We're completely fool-hardy and won't accept any gratuities with no
977 strings attached for just being good guys. That and we'd have to share with 1042 strings attached for just being good guys. That and we'd have to share with
978 everyone who has submitted patches. ;-) 1043 everyone who has submitted patches. ;-)
979 1044
980 15.6 Does Gaim support secure instant messaging (encrypted IMs)? 1045 16.4 Does Gaim support secure instant messaging (encrypted IMs)?
981 1046
982 Not natively. Doing secure instant messaging right is a big deal and 1047 Not natively. Doing secure instant messaging right is a big deal and
983 requires, among other things, an authentication scheme. Simply encrypting 1048 requires, among other things, an authentication scheme. Simply encrypting
984 your data stream without verifying the party with whom you are chatting is 1049 your data stream without verifying the party with whom you are chatting is
985 not secure in any way; some other clients offer options like this, but we 1050 not secure in any way; some other clients offer options like this, but we
986 feel that such measures instill a false sense of security that is more 1051 feel that such measures instill a false sense of security that is more
987 harmful than helpful. 1052 harmful than helpful.
988 1053
989 The gaim-e project (http://gaim-e.sourceforge.net/) is working on developing 1054 There are a number of 3rd party plugin developers working on developing a
990 a secure IM framework that uses the GnuPG and the OpenPGP trust model for 1055 secure IM framework, the better ones using the GnuPG and the OpenPGP trust
991 authentication. If you are serious about secure instant messaging, read the 1056 model for authentication. If you are serious about secure instant messaging,
992 documentation on the "web of trust" model available at http://www.gnupg.org/ 1057 read the documentation on the "web of trust" model available at www.gnupg.org
993 and try out gaim-e. 1058 and try out one of these.
994 1059
995 15.7 Why are the passwords in accounts.xml not encrypted? 1060 16.5 Why are the passwords in accounts.xml not encrypted?
996 1061
997 This is a case of a really long answer to a short question. Read our 1062 This is a case of a really long answer to a short question. Read our
998 explanation at http://gaim.sf.net/plaintextpasswords.txt. 1063 explanation at http://gaim.sf.net/plaintextpasswords.txt.
999 1064
1000 15.8 What is gaim-remote? 1065 16.6 What is gaim-remote?
1001 1066
1002 gaim-remote is a second executable included with Gaim starting with 0.60. It 1067 gaim-remote is a second executable included with Gaim starting with 0.60. It
1003 allows you to perform some actions to control/manipulate an existing Gaim 1068 allows you to perform some actions to control/manipulate an existing Gaim
1004 process from the command line. Run gaim-remote --help to get an idea of what 1069 process from the command line. Run gaim-remote --help to get an idea of what
1005 we currently envision it doing. 1070 we currently envision it doing.
1006 1071
1007 15.9 When will the next version of Gaim be released? 1072 16.7 When will the next version of Gaim be released?
1008 1073
1009 The schedule for releases is every other Thursday. However, a new version 1074 The schedule for releases is every other Thursday. However, a new version
1010 will only be released if it meets a certain standard of quality (i.e., it 1075 will only be released if it meets a certain standard of quality (i.e., it
1011 will not be released if it still has a large number of serious bugs). 1076 will not be released if it still has a large number of serious bugs).
1012 Therefore, some releases will take longer than others. Major rewrites means 1077 Therefore, some releases will take longer than others. Major rewrites means
1013 lots of new bugs to work out. The new version will be released as soon as it 1078 lots of new bugs to work out. The new version will be released as soon as it