Mercurial > pidgin
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 |