Index: doc/FAQ =================================================================== RCS file: /cvsroot/gaim/gaim/doc/FAQ,v retrieving revision 1.28 diff -u -p -r1.28 FAQ --- doc/FAQ 13 Dec 2003 02:23:25 -0000 1.28 +++ doc/FAQ 20 Apr 2004 12:22:06 -0000 @@ -5,13 +5,15 @@ Gaim: The Pimpin' Penguin IM Clone Thats 1.1. Why can't I compile Gaim? 1.2. I'm trying to install Gaim, but it complains that I don't have libgtkspell.so.0, from where can I get this? - 1.3. How do I get sound to work correctly? - 1.4. Is there some way I can compile just Gaim, without all of these + 1.3. Is there some way I can compile just Gaim, without all of these protocols? - 1.5. I compiled Gaim, but when I restart, it did not update. - 1.6. I have a question about GTK1.2. - 1.7. I'd like to use Gaim on IRIX. - 1.8. How do I apply the xxxx patch (name.diff)? + 1.4. I installed a new version of Gaim, but the about window says I'm + still using the old version. + 1.5. Can I use Gaim for GTK+1.2? + 1.6. Can I run Gaim on IRIX? + 1.7. How do I apply the xxxx patch (name.diff)? + 1.8. Why is gaim crashing when I start it? + 1.9. Gaim CVS is buggy. Gaim is buggy. 2. Using Gaim @@ -22,50 +24,56 @@ Gaim: The Pimpin' Penguin IM Clone Thats 2.4. How do I change the font Gaim uses? 2.5. How do I use smiley themes? 2.6. Why are the status icons so big? - 2.7. Why is Gaim crashing when somebody sends me an IM? - 2.8. Why is gaim crashing when I start it? + 2.7. How do I get sound to work correctly? + 2.8. How do I make Gaim use ALSA or OSS for playing sounds? What does + the "Automatic" option do? 2.9. I just changed my buddy icon, and I can't see the new one. 2.10. Why is everything at such small/large font sizes? - 2.11. Gaim CVS is buggy. Gaim is buggy. + Why does Gaim use the same WM_CLASS for every window? It makes + 2.11. it impossible to control window size and placement for the buddy + list separately from the conversations. 2.12. Why is the toggle to disable tabs not working? 2.13. What is a "Buddy Pounce"? - 2.14. How do I get rid of the buddy icons in the taskbar? + 2.14. Where does gaim store its logs? + 2.15. Can I use Gaim for e-mail, blogging, an RSS feed, or something + else that isn't IM-related? 3. Features - 3.1. Can Gaim send files? - 3.2. When will file transfer be supported? Is it being worked on? - 3.3. File Transfer for xxxx doesn't seem to be working. - 3.4. Is there a Gaim tray icon, or docklet, or gnome applet, or panel + 3.1. Does Gaim support file transfer? + 3.2. Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or something? - 3.5. What do those colors in the conversation tab mean? - 3.6. Will Gaim save my buddy list to the server? - 3.7. How come there's no Export Buddy List? - 3.8. Can Gaim import my buddy list? - 3.9. Does Gaim support animated smileys? - 3.10. Can I make Gaim group screen names by the person that owns them? + 3.3. What do those colors in the conversation tab mean? + 3.4. Will Gaim save my buddy list to the server? + 3.5. Can I import or export my buddy list? + 3.6. Does Gaim support animated smileys? + 3.7. Can I make Gaim group screen names by the person that owns them? + You know, like Trillian's Meta Contacts? + 3.8. How do I get the old logging back? + 3.9. How can I convert my old logs to the new format? + 3.10. Where has the system log gone? 4. ICQ Protocol 4.1. How do I use ICQ? - 4.2. ICQ doesn't work. - 4.3. Gaim 0.60 pops up a bunch of authorization request Dialogs. + 4.2. Can I send SMS messages? 5. TOC Protocol 5.1. What is the TOC protocol? -6. AIM/ICQ (Oscar) Protocol +6. AIM/ICQ (OSCAR) Protocol - 6.1. Can I set a buddy icon? - 6.2. Some of my buddies are not showing up as online, why is that? - 6.3. Can I use AIM URI's such as "aim:goim?screenname=robflynn"? - 6.4. IM Image doesn't work, why? - 6.5. I sent an IM Image, but only a blank line shows up, why? - 6.6. Can I add SMS numbers to my buddy list? - 6.7. I heard AOL is combining ICQ and AIM, does that mean I can send a + 6.1. Can I set my profile? + 6.2. Can I set a buddy icon? + 6.3. Some of my buddies are not showing up as online, why is that? + 6.4. Can I use AIM URI's such as "aim:goim?screenname=robflynn"? + 6.5. Does Gaim support DirectIM and IM Image? + 6.6. Can I send SMS messages? + 6.7. Can I add SMS numbers to my buddy list? + 6.8. I heard AOL is combining ICQ and AIM, does that mean I can send a message from an AIM account to an ICQ account and vice-versa? - 6.8. Why can't I connect via either Oscar or TOC? + 6.9. Why can't I connect via either Oscar or TOC? 7. IRC Protocol @@ -78,7 +86,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats 8.1. How do I choose which Jabber server to use? 8.2. How do I change my Jabber resource to be other than the default - of "/GAIM"? + of "/Gaim"? 8.3. How do I register a new Jabber account? 8.4. How do I use invisibility? I've a buddy that I keep removing from my buddy list but the @@ -87,7 +95,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats 8.6. Can I remove a buddy from my Jabber roster entirely? 8.7. What does "Cancel Presence Notification" do? -9. Y!M (yahoo) Protocol +9. Y!M (Yahoo) Protocol 9.1. I cannot connect to yahoo! @@ -95,77 +103,79 @@ Gaim: The Pimpin' Penguin IM Clone Thats 10.1. I'm getting lots of "Already in Opposite list" errors on msn, why? - 10.2. I'm getting an "Invalid User" popop whenever I sign on. How can + 10.2. I'm getting an "Invalid User" popup whenever I sign on. How can I make this go away? 10.3. Is there a way to invite more than one person to an MSN chat? 10.4. Is MSNP9 (MSN6) going to be supported? - 10.5. Will I be able to use Gaim for MSN after October 15th? (The day - they're preventing third party clients from connecting) + 10.5. Will I be able to use Gaim for MSN after October 15th 2003? (The + day they're preventing third party clients from connecting) 10.6. I just upgraded Gaim and the MSN plugin will not load. Why? 10.7. The MSN plugin won't load, but I have Mozilla NSS! + 10.8. What does "MSN: S: 911 3" in the debug window mean when I cannot + connect to msn? 11. Gadu-Gadu Protocol 11.1. What is Gadu-Gadu? -12. Trepia Protocol +12. Zephyr Protocol - 12.1. I heard Trepia was going to be in 0.65. Where is it? - 12.2. Trepia is showing people in Japan, England, etc. on my buddy + 12.1. What is Zephyr? + 12.2. Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with + "Couldn't initialize zephyr". + 12.3. Gaim isn't working, but I never got any other zephyr client + working on this machine. + +13. Trepia Protocol + + 13.1. I heard Trepia was going to be in 0.65. Where is it? + 13.2. Trepia is showing people in Japan, England, etc. on my buddy list. I thought this was supposed to show people in my area? -13. Scripts and Plugins +14. Scripts and Plugins - 13.1. How do I use perl scripts with Gaim? - 13.2. How do I compile a plugin for Gaim? - 13.3. I have a plugin or perl script for Gaim that does not work with + 14.1. How do I use perl scripts with Gaim? + 14.2. How do I compile a plugin for Gaim? + 14.3. I have a plugin or perl script for Gaim that does not work with 0.60 or higher. - 13.4. Where can I find documentation on writing plugins and Perl + 14.4. Where can I find documentation on writing plugins and Perl scripts? -14. Development +15. Development + + 15.1. Can I help? + 15.2. Gaim never leaves a core file. + 15.3. Where should I report bugs? + 15.4. Where should I submit patches? + 15.5. Did you guys reverse engineer it? - 14.1. Where should I report bugs? - 14.2. Gaim never leaves a core file. - 14.3. Where should I submit patches? - 14.4. Did you guys reverse engineer it? - 14.5. Will Gaim be ported to Windows 95/98/Me/2000/XP? - -15. Misc. Questions - - 15.1. Does AOL's attempts at blocking Trillian affect Gaim? - 15.2. Is Gaim affected by the vulnerability found in Windows AIM or - Yahoo Instant Messenger clients? - 15.3. Can I IM you guys? - 15.4. Hello? +16. Misc. Questions + + 16.1. Can I IM you guys? + 16.2. Hello? Can I give you money/hardware/other expensive things that can be - 15.5. hocked for cash what with you all being students/ + 16.3. hocked for cash what with you all being students/ full-time-workers and helping to produce this wonderful software instead of studying/sleeping? - 15.6. Does Gaim support secure instant messaging (encrypted IMs)? - 15.7. Why are the passwords in accounts.xml not encrypted? - 15.8. What is gaim-remote? - 15.9. When will the next version of Gaim be released? + 16.4. Does Gaim support secure instant messaging (encrypted IMs)? + 16.5. Why are the passwords in accounts.xml not encrypted? + 16.6. What is gaim-remote? + 16.7. When will the next version of Gaim be released? +------------------------------------------------------------------------------ | 1. Compiling and Installing +------------------------------------------------------------------------------ 1.1 Why can't I compile Gaim? - - Make sure you have gettext <= 0.10.40 or gettext >= 0.11.3, autoconf 2.11 or - >= 2.53, and automake >= 1.4px (tested up to automake 1.6.3). If you are - still having problems, make sure that your gettext package includes the - program gettextize (for gettext <= 0.10.40) or autopoint (for gettext >= - 0.11.3). If it does not, look for another package. - - We don't support gettext 0.11.0 through 0.11.2 or 0.12.1. It may work for - you, but we make no promises. - If you are using autoconf 2.50+, do not use a version of gettext lower than - 0.11.3. You will get errors in the po/ directory. + Make sure you have relatively recent versions of automake, autoconf, and + gettext. HOWEVER, generally speaking, having the absolute newest of them is + not as good as having one version short of newest since we might not have + found work-arounds for the latest set of changes. Also, some versions of + automake require certain ranges of gettext versions, and we are utterly + unable to keep track of what versions will work with what other versions. - If you have Slackware, you need to get non-slack packages for autoconf, + If you have Slackware < 9.1, you need to get non-slack packages for autoconf, automake, gettext, and libtool. You also have to copy the contents of /usr/ local/share/aclocal to /usr/share/aclocal. This is due to bugs in Slackware and the auto* packages. @@ -173,33 +183,20 @@ Gaim: The Pimpin' Penguin IM Clone Thats *BSD users may also have problems with libtool and will also have to remove the --no-verify from the configure script. + Having problems getting SSL and MSN working? See http://gaim.sf.net/ + faq-ssl.php for distribution specific hints. + 1.2 I'm trying to install Gaim, but it complains that I don't have libgtkspell.so.0, from where can I get this? - + libtgtkspell.so.0 is provided by gtkspell. This library is used by Gaim to provide the "Highlight misspelled words" feature. You can find an RPM of gtkspell at freshrpms.net. You can find the source and a non-Red Hat specific RPM at gtkspell.sourceforge.net. -1.3 How do I get sound to work correctly? - - Gaim 0.60 and higher support playing sounds via libao. Playing sounds - directly through esound or arts is no longer supported. +1.3 Is there some way I can compile just Gaim, without all of these protocols? - `Libao is a cross-platform library that allows programs to output PCM audio - data to the native audio devices on a wide variety of platforms. It currently - supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound - Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts - (Analog Realtime Synthesizer). ' - - To compile Gaim with support for libao you need libao-devel and - audiofile-devel. To use libao you need libao and audiofile. If you do not - wish to install these packages you can also just change your sound playing - method in preferences to Command and use "esdplay %s" or "artsplay %s." - -1.4 Is there some way I can compile just Gaim, without all of these protocols? - - Sort of, yeah. There are actually two ways to do it. + Yeah. There are actually three ways to do it. 1. Use the --with-static-prpls option to ./configure along with --disable-plugins. This will let you choose which protocols are compiled @@ -209,49 +206,82 @@ Gaim: The Pimpin' Penguin IM Clone Thats You'll need to compile any protocols that you specified in --with-static-prpls. Oscar and TOC are defaults. - 2. Change to the directories for the protocols you want to compile (e.g. src + 2. Use the --with-dynamic-prpls option to ./configure + + 3. Change to the directories for the protocols you want to compile (e.g. src /protocols/jabber), and run make from there. Then after you've compiled all of them, change back to src/ and run make gaim. - The static prpls option is broke in 0.64 and higher. +1.4 I installed a new version of Gaim, but the about window says I'm still + using the old version. -1.5 I compiled Gaim, but when I restart, it did not update. - - If you previously had an rpm or a Debian package installed, you need to - remove that first. rpm -e gaim or dpkg -p gaim should work. If you are using - 0.59.x or lower, you will receive some errors about your plugins when you - restart Gaim. This is normal. Simply go into the Plugins dialog (Tools-> - Plugins) and reload them. These errors will only happen once. + If you compiled yourself, and you previously had an rpm or a Debian package + installed, you need to remove that first. rpm -e gaim or dpkg -p gaim should + work. Likewise, if you want to use an RPM or deb and you have previously compiled Gaim from source, you need to make uninstall to remove all Gaim files from / usr/local. -1.6 I have a question about GTK1.2. - - Our GTK2 port is now complete, the 0.59.x release series uses only GTK1.2, - and it is also entirely devoid of new features. 0.60 is the first release - with GTK2 support. 0.60 and all future Gaim versions will no longer support - GTK1.2. With the release of 0.60, the gtk1-stable tree that the 0.59.x - releases were from has been discontinued. If you want anything new in that - tree, you will have to maintain it yourself. - -1.7 I'd like to use Gaim on IRIX. - - Please see http://sourceforge.net/forum/forum.php?thread_id=725839&forum_id= - 665 at our SourceForge Forum. +1.5 Can I use Gaim for GTK+1.2? + + As of version 0.60, Gaim has been completely converted to using GTK+2.0. We + really really really recommend using the most current version of Gaim and not + a GTK+1.2 version of Gaim. However, if you are living in the '90s, or you're + afraid GTK+2.0 will insult your mother, you can use Gaim 0.59.x, which is + GTK+1.2 based. We should warn you though, the 0.59.x releases haven't had new + features since the middle of 2002. Also, the 0.59.x releases aren't + breathtakingly beautiful. + +1.6 Can I run Gaim on IRIX? + + It has been done before. Please see http://sourceforge.net/forum/forum.php? + thread_id=725839&forum_id=665 at our SourceForge Forum. + +1.7 How do I apply the xxxx patch (name.diff)? -1.8 How do I apply the xxxx patch (name.diff)? - Type patch -p0 < name.diff from inside the gaim directory. If that doesn't work, try patch -p1 < name.diff. +1.8 Why is gaim crashing when I start it? + + First of all make sure you are using the most recent version of Gaim. If you + still have problems, try the things in the following list: + + * Try running gaim with GDK_USE_XFT=0 set (type that in a terminal and then + run Gaim from the same terminal). + * If gaim is not crashing, but is just sitting there not displaying + anything, try turning off anything else that might be using the sound + device (ie xmms) and then starting gaim. If this fixes the problem, it is + a libao issue, not a gaim issue, and can be worked around by the use of + esd or arts. + * Try disabling or deleting any 3rd party plugins, especially anything + related to encryption. + * If you use 0.75 on win32, try deleting tcl.dll. + * If you use 0.70 or lower, make sure only one version of Gaim is + installed. + * If you use 0.67 and do not have yourself on your buddy list, upgrade. + * If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto + away preference from -1 to 0. + * If you use MSN, and have a version 0.64, downgrade to 0.63 or upgrade to + 0.65. + +1.9 Gaim CVS is buggy. Gaim is buggy. + + Yes, it is! CVS is often unsupported by Gaim, as are non-current versions. + This is because non-current versions have old bugs which may be fixed in the + current version, and CVS is frequently unusable because of the changes in the + code (and it has new bugs). If you are using either and have a problem, + upgrade/install the current stable version of Gaim before posting a bug or + asking for help in Gaim's IRC channel. If the bug does not exist in the + current version, then please do not ask for help. + +------------------------------------------------------------------------------ | 2. Using Gaim +------------------------------------------------------------------------------ 2.1 How do I register for a new account? - + This depends on the protocol. AIM: Go to http://my.screenname.aol.com/_cqr/login/login.psp?siteId= @@ -261,55 +291,45 @@ Gaim: The Pimpin' Penguin IM Clone Thats Yahoo: Go to http://edit.yahoo.com/config/eval_register. - MSN: Go to http://registernet.passport.com. + MSN (including hotmail email): Go to http://registernet.passport.com/. + + MSN (using your own email address): Go to this website Gadu-Gadu: Use the official client to create an account. Jabber: See the question How do I register a new Jabber account? below. 2.2 How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu(GG), Napster, or Zephyr? - - In Gaim 0.60 and higher, use the Account Editor (Tools->Accounts, or the - Accounts button on the start screen) to add the account. The appropriate - protocol plugin is loaded automatically. - - In Gaim 0.59 and lower, you must first load the protocol plugin for the - protocol that you want to use. These plugins come with Gaim, so just go to - the Plugins dialog (Tools->Plugins, or the Plugins button on the start - screen). The list of plugins on this screen is a listing of plugins you have - already loaded and does not included unloaded but available plugins. To load - a new plugin, click "Load." The protocol plugins are named libprotocol.so, so - MSN for instance is provided by libmsn.so, and Gadu-Gadu is provided by - libgg.so. Now you can use the Account Editor to add an account with the - desired protocol. + + Use the Account Editor (Tools->Accounts, or the Accounts button on the start + screen) to add the account of the appropriate messaging service. The protocol + plugin is loaded automatically. 2.3 How do I make gaim use emacs-like keybindings? - + You need to edit your ~/.gtkrc-2.0 to contain the keybindings line from http: //gaim.sf.net/gtkrc-2.0. 2.4 How do I change the font Gaim uses? - + The font preference in Gaim is used only for the formatting of outgoing messages, and that only on the few protocols we support outgoing format on. The display fonts used by the rest of Gaim are those specified by GTK. To - change this font you need to edit your ~/.gktrc (Gaim 0.59.9 and lower) or ~ - /.gtkrc-2.0 (Gaim 0.60 and newer). An example ~/.gtkrc-2.0 is available http: - //gaim.sf.net/gtkrc-2.0. + change this font you need to edit your ~/.gtkrc-2.0 file. If you need help + you can see our example .gtkrc-2.0 (http://gaim.sf.net/gtkrc-2.0) file. 2.5 How do I use smiley themes? - - Gaim 0.60 and higher support themable smileys. To select a theme, open Gaim's - preferences to the "Smiley Themes" page and click on whichever theme you want - to use. To install a theme, simply drag it into the theme selector. You can - find themes on the Gaim Smiley Themes (http://gaim.sourceforge.net/ - themes.php) page. + + To select a theme, open Gaim's preferences to the "Smiley Themes" page and + click on whichever theme you want to use. To install a theme, simply drag it + into the theme selector. You can find themes on the Gaim Smiley Themes (http: + //gaim.sf.net/themes.php) page. You can also install themes manually by uncompressing them to their own directory in ~/.gaim/smileys/ 2.6 Why are the status icons so big? - + We believe that, by adding a second line of text to each buddy list entry, we're able to show more information about each buddy on the buddy list. The 'Big List,' as we call it, shows status text, idle time, and warning level @@ -325,55 +345,51 @@ Gaim: The Pimpin' Penguin IM Clone Thats disabled by un-checking "Show buddy icons in list" in the Buddy List preferences. -2.7 Why is Gaim crashing when somebody sends me an IM? - - If you're using a version older than 0.55 (or Ximian or Debian's 0.54 - package), you can be crashed remotely through an IM using one of two strings. - The solution is to upgrade to the latest version, where both exploits are - fixed. - - If you use Yahoo with Gaim 0.59.8 or lower, you need to upgrade. Yahoo - changed the protocol in a way that broke Gaim, Trillian, Everybuddy, and - their own linux client. - - If you use Gaim 0.59.5 and Gaim segfaults as soon as it signs on, you do not - have a valid ~/.gtkrc file. This is fixed in debian's 0.59.5-2 package, and - is fixed in 0.59.6 for the rest of the world. - - If you are using a version newer than 0.59.6 and Gaim still crashes, please - let us know. - -2.8 Why is gaim crashing when I start it? - - With 0.60 and higher, try running gaim with GDK_USE_XFT=0 set. If this does - not fix the problem, please submit a bug report. If gaim is not crashing, but - is just sitting there not displaying anything, try turning off anything else - that might be using the sound device (ie xmms) and then starting gaim. If - this fixes the problem, it is a libao issue, not a gaim issue, and can be - worked around by the use of esd or arts. - - If you use MSN, and have a version 0.64, downgrade to 0.63 or upgrade to - 0.65. +2.7 How do I get sound to work correctly? - If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto away - preference from -1 to 0. + Gaim uses libao to play sounds. Playing sounds directly through esound or + arts is no longer supported. - If you use 0.67 and do not have yourself on your buddy list, upgrade. + Libao is a cross-platform library that allows programs to output PCM audio + data to the native audio devices on a wide variety of platforms. It currently + supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound + Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts + (Analog Realtime Synthesizer). + + To compile Gaim with support for libao you need libao-devel and + audiofile-devel. To use libao you need libao and audiofile. If you do not + wish to install these packages you can also just change your sound playing + method in preferences to Command and use "esdplay %s" or "artsplay %s." - If you use 0.70 or lower, make sure only one version of Gaim is installed. +2.8 How do I make Gaim use ALSA or OSS for playing sounds? What does the + "Automatic" option do? + + If you choose "Automatic", "ESD", or "Arts", Gaim uses libao to play sounds. + Choosing "ESD" or "Arts" forces libao to play sounds using that method, while + choosing "Automatic" lets it decide for itself. + + If you choose Automatc, you can create a file, either /etc/libao.conf or ~ + /.libao, and put one of the following lines in it: + + default_driver=alsa + + default_driver=oss + Other drivers, like alsa09, arts, esd, irix, macosx, and sun might also be + supported, depending on your platform, and how libao was compiled. See also + 'man 5 libao.conf'. 2.9 I just changed my buddy icon, and I can't see the new one. - - First, try IMing yourself. Buddy icons are checked when you IM people, so - depending on the protocol, that may work. If it still doesn't update, check - the file size (buddy icons must be smaller than 4kb) and the image size (it - should be 48x48 or 50x50 in most cases). Also, check the file type. GIF or - JPEG images are best supported; most other formats do not work at all. If all - of that checks out and it still doesn't work, and you're sure the protocol - supports it, try restarting Gaim. + + First, try IMing yourself a few times. Buddy icons are checked when you IM + people, so depending on the protocol, that may work. If it still doesn't + update, check the file size (buddy icons must be smaller than 4kb) and the + image size (it should be 48x48 or 50x50 in most cases). Also, check the file + type. GIF or JPEG images are best supported; most other formats do not work + at all. If all of that checks out and it still doesn't work, and you're sure + the protocol supports it, try restarting Gaim. 2.10 Why is everything at such small/large font sizes? - + You need to edit your .gtkrc-2.0 in your home directory. This is almost certainly a gtk theme thing. You can find more gtk themes by visiting themes.freshmeat.net, art.gnome.org, or searching on Google. If it is a @@ -381,24 +397,33 @@ Gaim: The Pimpin' Penguin IM Clone Thats Preferences->Message Text), though that will only have limited effects. See an example .gktrc-2.0 at http://gaim.sf.net/gtkrc-2.0. -2.11 Gaim CVS is buggy. Gaim is buggy. - - Yes, it is! CVS is often unsupported by Gaim, as are non-current versions. - This is because non-current versions have old bugs which may be fixed in the - current version, and CVS is frequently unusable because of the changes in the - code (and it has new bugs). If you are using either and have a problem, - upgrade/install the current version of Gaim before posting a bug or asking - for help in Gaim's IRC channel. If the bug does not exist in the current - version, then please do not ask for help. +2.11 Why does Gaim use the same WM_CLASS for every window? It makes it + impossible to control window size and placement for the buddy list + separately from the conversations. + + Both strings in the WM_CLASS property are supposed to be the same for all + windows in the same instance of an application. ICCCM states that one is + meant to be the same for all instances of the application, the other is meant + to be unique to that instance of the application. ICCCM also states "If a + client has multiple windows with identical WM_CLASS and WM_NAME properties, + then it should provide a WM_WINDOW_ROLE property." + + Gtk+ sets these WM_CLASS values for us so that they are unique for Gaim + instances, and the documentation for the gtk_window_set_wmclass function says + explicitly not to use it for anything else. Before we released Gaim 0.60, we + replaced all calls to this function with calls to gtk_window_set_role(), + which sets the WM_WINDOW_ROLE hint instead. If your window manager is having + problems differentiating between Gaim windows, please ensure that your window + managers uses the WM_WINDOW_ROLE hint per the ICCCM. 2.12 Why is the toggle to disable tabs not working? - - You have told gaim (or have neglected to change the default) to place tabs in - the "Last Created Window" instead of in a "New Window." Change this tab - placement option and you will be all set. + + Because your conversation placement setting is incorrect. Go to Preferences-> + Conversation->Placement and set this to "New Window." Bada bing. Although, I + don't know why anyone would not want to use tabs. 2.13 What is a "Buddy Pounce"? - + Gaim introduced buddy pounces a few releases before AOL came out with "Buddy Alerts." Despite this though, you could think of a buddy pounce as an Alert and get an idea of the most minimal uses of a buddy pounce. In reality, a @@ -410,139 +435,149 @@ Gaim: The Pimpin' Penguin IM Clone Thats occur the next time gaim detects the event, ie the next time the person in your buddy list who you have pounced signs on. -2.14 How do I get rid of the buddy icons in the taskbar? - - As of 0.71, you do not. +2.14 Where does gaim store its logs? + + On unix, they are in ~/.gaim/logs, on win32 they are in the $drive/documents + and settings/user/application data/.gaim/logs directory. In either case, new + logs (new as of 0.73) are in subdirectories that correspond to protocol\ + yourscreenname\theirscreenname. + +2.15 Can I use Gaim for e-mail, blogging, an RSS feed, or something else that + isn't IM-related? + + No, you can't. We get requests for this often, but Gaim is indeed an instant + messenger client. Aside from the capabilities each protocol may support, the + Gaim developers have no intention to turn Gaim into a multi-feature Internet + client capable of doing everything under the sun. We also won't be helping to + develop plugins to turn it into that. There are many Internet applications + available for Linux, Windows, or whatever operating system you use that would + undoubtably do a better job. +------------------------------------------------------------------------------ | 3. Features +------------------------------------------------------------------------------ -3.1 Can Gaim send files? - - TOC can, in a limited way, and OSCAR can send files over AIM in 0.60 and - higher. Most protocols are capable of it, but Gaim hasn't implemented - anything yet. Support is being worked on and may partially work for MSN and - Jabber. - -3.2 When will file transfer be supported? Is it being worked on? - - Gaim 0.60 includes preliminary file transfer support. It likely contains a - few bugs that will be fixed in time. Currently, Gaim supports sending and - receiving files via AIM, receiving files via Jabber and IRC. File transfer - receive code exists for MSN, but it is very flakey, and files are often - corrupt. If you would like support for another protocol, get CVS and submit a - patch using the generic file transfer API. - -3.3 File Transfer for xxxx doesn't seem to be working. - - File transfer for all protocols is still buggy. This is being worked on, but - has no set date for completion. +3.1 Does Gaim support file transfer? + + Somewhat, yeah. Yahoo! supports sending and receiving files in Gaim 0.75 and + higher. As of 0.76 the following is supported: -3.4 Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or + * Sending and receiving files on AIM (although it might be a bit buggy) + * Sending and receiving files on IRC + * Sending and receiving files on Jabber + * Sending and receiving files on Yahoo (sending is limited to 1Mb) + + Most of the protocols themselves support file transfer, but Gaim has not been + written to support it yet. If you would like file transfer to work better or + be more complete, get CVS and submit a patch using the generic file transfer + API. + +3.2 Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or something? - - In 0.59.x and below, Gaim only has support for Gnome's panel. Gaim 0.60 and - higher have replaced the gnome-applet with a tray icon that conforms to the - standards at www.freedesktop.org. This tray icon is supported in KDE 3.1, - Gnome 2.2, and Red Hat Gnome 2.0. Gaim will insert the tray icon in any + + Yeah, Gaim supports what is called a system tray icon that conforms to the + standards at www.freedesktop.org. This tray icon is supported by Windows, KDE + 3.1, Gnome 2.2, and Red Hat Gnome 2.0. All you have to do is load the "System + Tray Icon" plugin by going to Preferences and then Plugins. + + If you're using Gnome you need to make sure that your panel has a + Notification Area on it. To add one, right click on the panel, select Add To + Panel->Utility->Notification Area. Gaim will insert the tray icon in any System Tray implementation that conforms to these standards, so feel free to - write one for your window manager of choice. For Gnome, you must have a - Notification Area in your Gnome panel. + write one for your window manager of choice. - This docklet is the only supported way of putting Gaim in a Gnome2 panel. The - panel applet (the gaim-applet rpm, the gaim-gnome deb package and compiling - with the --enable-panel flag) is only supported with Gaim 0.59.x and Gnome - 1.x, the GTK1.2 versions of Gnome. +3.3 What do those colors in the conversation tab mean? -3.5 What do those colors in the conversation tab mean? - A red tab means a message is waiting for you; green means the buddy is typing; yellow means the buddy began typing, and then stopped. Gray means - that there has been a join or a part in that chat. + that there has been a join or a part in that chat, or the buddy has signed + off. + +3.4 Will Gaim save my buddy list to the server? + + Yes, Gaim saves your buddy list to the server for AIM, ICQ, MSN, Yahoo, TOC + and Jabber. + +3.5 Can I import or export my buddy list? -3.6 Will Gaim save my buddy list to the server? - - Yes, as of 0.60 Gaim saves your buddy list to the server for AIM, ICQ, MSN, - Yahoo, TOC and Jabber. Gaim 0.59.x supports this for AIM, MSN, Yahoo, TOC and - Jabber. - -3.7 How come there's no Export Buddy List? - - In 0.59 and earlier you can use cp to copy your buddy list. It is stored in - the $HOME/.gaim directory. The file name is your screen name, in all capital - letters. Gaim 0.60 does not support exporting your buddy list. - - Import and export code will hopefully be reintroduced for one of the 0.6x - releases, due to the introduction of the unified xml buddy list in 0.60. - -3.8 Can Gaim import my buddy list? - - Unfortunately, no, you cannot import your buddy list with Gaim 0.60 and - later. However, as Gaim will read the server copy of the buddy list, this is - most likely not necessary unless you use a 3rd party client that is broken - (aka trillian). - - With Gaim 0.59 and earlier, this depends on the format of the buddy list. - Gaim has mixed success importing Windows AIM buddy lists. If you want to try, - click File->Import. This is accessible after you sign on. If you want to - import an Licq (http://licq.org/) contact list, you can try using the - licq2gaim.pl perl script, which comes with the Gaim source code, but we do - not support this. + Sorry, no. Old versions of Gaim supported this, but new versions do not. All + the code for saving and loading buddy lists was rewritten, and support for + importing and exporting buddy lists was never re-added. However, with all + major protocols storing their buddy lists on the server, this feature is less + useful today than in the past. + +3.6 Does Gaim support animated smileys? -3.9 Does Gaim support animated smileys? - Yes, as of version 0.70 Gaim supports animated smileys. -3.10 Can I make Gaim group screen names by the person that owns them? - +3.7 Can I make Gaim group screen names by the person that owns them? You know, + like Trillian's Meta Contacts? + Sure! Right click a buddy on your list and at the bottom of the menu click "Expand". Then just drag other screen names to the same person below it. When you're done, click on the arrow to collapse them. When the contact is collapsed, Gaim will select a buddy to display based on the status of the buddies in the contact, and their order. +3.8 How do I get the old logging back? + + The old logging was removed because it was deficient in many ways. There is + no way in gaim itself to revert to the old logging, but the new logging is so + good you could implement something similar to the old logging as a plugin. + +3.9 How can I convert my old logs to the new format? + + It's not possible to perfectly convert from the old format to the new format + because the old format is missing some information necessary to do that (eg. + which account the messages were sent from). + + It shouldn't be too difficult to do a rough conversion using a small script, + or using the old_logger_* functions in gaim itself. + + Peter Johnson has written a python script to do just this, it is available on + his website (at the bottom). + +3.10 Where has the system log gone? + + The system log had to be removed when the new logging was implented. It will + make a return someday, just be patient. Or if you're brave there is a patch + in the patch tracker on sourceforge that re-implements system logging. + +------------------------------------------------------------------------------ | 4. ICQ Protocol +------------------------------------------------------------------------------ 4.1 How do I use ICQ? - - ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim (see the - question ICQ doesn't work for why). To use it, simply put your account number - in the Screenname box and your password in the Password box. Leave the server - settings set to the default (login.oscar.aol.com and port 5190). - -4.2 ICQ doesn't work. - - Use AIM/ICQ for ICQ. AOL stopped supporting the older versions of the ICQ - protocol. The newer versions are extensions of Oscar, which is labeled AIM/ - ICQ in Gaim. Currently, Oscar supports as much of ICQ as the ICQ plugin used - to. To use Oscar for ICQ, put your UIN in the Screenname box, and leave the - server information alone. - -4.3 Gaim 0.60 pops up a bunch of authorization request Dialogs. - - This is a side effect of enabling support for the server side lists. Yes, you - must re-request authorization, we can't find a way around this requirement. + + ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim. To use + it, simply put your account number in the Screenname box and your password in + the Password box. Leave the server settings set to the default + (login.oscar.aol.com and port 5190). + +4.2 Can I send SMS messages? + + Kind of. See our answer to this for the AIM/ICQ Protocol. +------------------------------------------------------------------------------ | 5. TOC Protocol +------------------------------------------------------------------------------ 5.1 What is the TOC protocol? - - It's an AIM protocol used by quickbuddy and aimexpress. It's not particularly - recommended that you use it unless you know what it is. :) The only time it - would be useful in Gaim is if Gaim's OSCAR (AIM/ICQ) protocol stopped working - for some reason, such as being blocked. + + It's an AIM protocol used by quickbuddy and aimexpress. It's recommended that + you don't use it. You should use Gaim's OSCAR (AIM/ICQ) protocol, instead. We + keep TOC around in case OSCAR ever stops working. +------------------------------------------------------------------------------ -| 6. AIM/ICQ (Oscar) Protocol +| 6. AIM/ICQ (OSCAR) Protocol +------------------------------------------------------------------------------ -6.1 Can I set a buddy icon? - +6.1 Can I set my profile? + + Yes you can. Go to Tools->Protocol Actions + +6.2 Can I set a buddy icon? + Yes. Go to the Account Editor (Tools->Accounts from the buddy list), and click to "Modify" the AIM/ICQ account you wish to have an icon. Enter the full path to the image you wish to use in the box labeled "Buddy Icon File." @@ -550,32 +585,29 @@ Gaim: The Pimpin' Penguin IM Clone Thats format. However, if you wish Windows users to see it, it must be in a format Windows understands, such as .bmp, .gif, and .jpg. -6.2 Some of my buddies are not showing up as online, why is that? - +6.3 Some of my buddies are not showing up as online, why is that? + AOL has set a limit for the maximum number of people you can have in your - buddy list. This number is currently 200. Gaim 0.58 and newer give you a - warning if you are over the limit, but if you are using something prior to - 0.58, make sure you are not over the limit (and upgrade to something more - recent!). - - The other possibility is that your server-stored buddy list is corrupt. - Unfortunately, Gaim 0.53 had a bug that caused it to corrupt some entries, - especially group names. While this corruption doesn't show in Gaim unless you - remove the SCREENNAME.0.blist file from ~/.gaim, it does affect how long the - server thinks your list is. The best way to fix this, is to: - - mv ~/.gaim/SCREENNAME.0.blist ~/ - - where SCREENNAME is your screenname, without spaces and in all caps. Then - signon, delete all groups, signoff, and signon again to verify that your list - is empty. Once it is empty, signoff, mv your SCREENNAME.0.blist file back - into ~/.gaim, then sign on again. This should not be necessary in Gaim 0.60 - and higher. + buddy list. This number is currently 200. If you don't think you are anywhere + near that limit, it is possible that your server-stored buddy list is + corrupt. + + If you think this might be the case, you can try the following steps to + "clean" your list (be careful doing this, if you do something wrong you could + lose your buddy list!): + + 1. Exit Gaim + 2. mv ~/.gaim/blist.xml ~/ + 3. rm ~/.gaim/*.blist + 4. Start Gaim and sign on your AIM account + 5. Delete everyone from your buddy list then sign off + 6. Repeat the above two steps until you are sure your list is empty + 7. Exit Gaim + 8. cp ~/blist.xml ~/.gaim/ + 9. Start Gaim and sign on your AIM account - If you have 0.60 or higher, move ~/.gaim/blist.xml instead. +6.4 Can I use AIM URI's such as "aim:goim?screenname=robflynn"? -6.3 Can I use AIM URI's such as "aim:goim?screenname=robflynn"? - Yes, with Gaim 0.60 and higher, but it can be difficult to set up. You need to pass the entire URI to the gaim-remote program (included with gaim). To do this with Gnome 2, run gnome-file-types-properties or "File Types and @@ -584,35 +616,34 @@ Gaim: The Pimpin' Penguin IM Clone Thats Galeon 2. Also, not all types of aim URI's are supported. The ones that are supported are goim, addbuddy, and gochat. + You'll need the "Remote Control" plugin loaded for this to work. + If you use wingaim, this will not work as gaim-remote has not yet been ported over. -6.4 IM Image doesn't work, why? - - IM Image is very sensitive, even from windows. Gaim currently only supports - sending IM Images if the sender is not behind a firewall or NAT device. Given - that the windows version of AIM also has trouble in this situation, we are - not sure this is entirely fixable. A work around that is sometimes effective - is to have the receiver, not being behind a firewall, request a direct - connection, then send the image. - - In cvs, the html widget is being re-written. it currently does not support - many features of the old widget we used with GTK1.2, including images. - -6.5 I sent an IM Image, but only a blank line shows up, why? - - For Gaim 0.59.x and lower, You need to have gdk-pixbuf installed to view IM - Images. If the receiver is also using Gaim, [s]he also needs to have this - installed. +6.5 Does Gaim support DirectIM and IM Image? + + Yeah, kind of. This tends to be one of the buggier areas of Gaim. If it's not + working for you make sure that the person requesting the DirectIM is not + behind a firewall. + +6.6 Can I send SMS messages? + + Yep, just send an IM to the person's phone number. For example, if the phone + number is (919) 555-1234, you would IM the screenname +19195551234 We think + this should work for contries with a country code of 1 (the United States and + Canada). + + Sending SMS messages using "the ICQ method" is not yet supported. + +6.7 Can I add SMS numbers to my buddy list? -6.6 Can I add SMS numbers to my buddy list? - Not currently. This functionality has been broken since around September 2003. There is no ETA for when it will be fixed. -6.7 I heard AOL is combining ICQ and AIM, does that mean I can send a message +6.8 I heard AOL is combining ICQ and AIM, does that mean I can send a message from an AIM account to an ICQ account and vice-versa? - + Yes, AOL is slowly letting the two messaging networks interoperate with each other. Messaging between the two protocols works as long as the receiver of the message supports it. Gaim 0.60 supports sending and receiving messages @@ -631,8 +662,8 @@ Gaim: The Pimpin' Penguin IM Clone Thats then the ICQ user will also show up in your AIM buddy list. So an AIM user using Windows AIM version 5.2.3139 will show up in an ICQ buddy list. -6.8 Why can't I connect via either Oscar or TOC? - +6.9 Why can't I connect via either Oscar or TOC? + If you are using Linux, your kernel may be using a network option called "ECN". It seems that the AOL servers are currently dropping packets marked as "ECN-capable". In order to turn this off, run the command "echo 0 > /proc/sys @@ -644,13 +675,13 @@ Gaim: The Pimpin' Penguin IM Clone Thats +------------------------------------------------------------------------------ 7.1 Why am I getting disconnected when I try to connect to IRC? - + You will be disconnected if the nickname you chose is already in use on that IRC server. Try again with a different nickname. In 0.60 or later, Gaim will prompt you to change your screenname in this situation. 7.2 How do I join a channel with the IRC plugin? - + First create the account, then sign on. After you have signed on, you can use File->Join A Chat on the buddy list to join a channel. In any window, either a conversation or a chat, in which your IRC user is the sender, you can also @@ -658,7 +689,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats 7.3 Is there a way to make Gaim automatically identify me and/or join IRC chats on login? - + Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it. In version 0.64 or higher, you can add a chat to your buddy list, right click @@ -669,19 +700,19 @@ Gaim: The Pimpin' Penguin IM Clone Thats +------------------------------------------------------------------------------ 8.1 How do I choose which Jabber server to use? - + The Jabber server name is part of your Jabber I.D., such as somebody@server.name. So when entering your Jabber "screen name", the server is specified as part of your JID. 8.2 How do I change my Jabber resource to be other than the default of "/ - GAIM"? - + Gaim"? + When you create your account in Gaim, simply append the desired resource identifier to your Jabber I.D. For example: somebody@server.name/resource 8.3 How do I register a new Jabber account? - + As of version 0.52 and up: 1. Click "Tools->Accounts->Add" @@ -696,7 +727,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats type in what you thought you did, you're hosed. 8.4 How do I use invisibility? - + Jabber invisibility support is available in Gaim version 0.60 and later. There are two ways to use Jabber invisibility: on a per-buddy and on a @@ -726,12 +757,16 @@ Gaim: The Pimpin' Penguin IM Clone Thats 8.5 I've a buddy that I keep removing from my buddy list but the entry keeps coming back every time I log in again! How can I stop this? - + As of Gaim version 0.59 and later: Select the Edit Buddies tab, right-click - on the offending entry, and select "Remove From Roster. + on the offending entry, and select "Remove From Roster". + + If you're Gaim 0.60 or later, it might be continuing to import the old buddy + lists. Remove ~/.gaim/*.blist - these are no longer used, the buddy list is + now stored in ~/.gaim/blist.xml 8.6 Can I remove a buddy from my Jabber roster entirely? - + As of Gaim version 0.59 and later: yes. In the Edit Buddies tab, right-click on a buddy and Select "Remove From Roster. @@ -743,7 +778,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats "away" status. 8.7 What does "Cancel Presence Notification" do? - + This selection, available in Gaim version 0.60 and later, and found by right-clicking on a buddy entry in the Edit Buddies tab, prevents that Jabber I.D. from receiving future presence notifications when you log on to the @@ -753,20 +788,19 @@ Gaim: The Pimpin' Penguin IM Clone Thats presence (and you will have to approve it) for them to again see you on-line. +------------------------------------------------------------------------------ -| 9. Y!M (yahoo) Protocol +| 9. Y!M (Yahoo) Protocol +------------------------------------------------------------------------------ 9.1 I cannot connect to yahoo! - - Make sure you have at least 0.70. If you still cannot connect, change the - host you connect to from scs.yahoo.com to scs.msg.yahoo.com + + Make sure you have at least 0.76. +------------------------------------------------------------------------------ | 10. MSN Protocol +------------------------------------------------------------------------------ 10.1 I'm getting lots of "Already in Opposite list" errors on msn, why? - + The reason this happens is because you have a screenname in both your permit list and your deny list. There are two ways to fix this: the correct way and the quick way. The correct way is to go to tools->preferences (tools->privacy @@ -774,11 +808,14 @@ Gaim: The Pimpin' Penguin IM Clone Thats entries. The quick way is to remove the msn .blist file from the ~/.gaim directory. This will have a side effect: the msn server stores the screennames of your contacts, but does not store what group they are in, so - you will have to re-sort your msn contacts into the appropriate groups. + you will have to re-sort your msn contacts into the appropriate groups. The + buddy list is ~/.gaim/blist.xml in 0.60 and later, but be aware that this + contains your buddy list for all accounts, and also stores the "Contact" + grouping of Buddies. -10.2 I'm getting an "Invalid User" popop whenever I sign on. How can I make +10.2 I'm getting an "Invalid User" popup whenever I sign on. How can I make this go away? - + Delete your buddy list. On unix, this will be at ~/.gaim/blist.xml (or ~ /.gaim/USERNAME.0.blist pre-v0.60). Note that you will lose buddy groups and aliases when you do this. Alternatively, since this will delete ALL buddy @@ -788,23 +825,23 @@ Gaim: The Pimpin' Penguin IM Clone Thats the better temporary solution. 10.3 Is there a way to invite more than one person to an MSN chat? - + Not at this time. When the conversation framework gets another rewrite, it is possible that it will be worked on. Until that time, sorry. :) 10.4 Is MSNP9 (MSN6) going to be supported? - + MSNP9 support has existed in Gaim since 0.69. However, at this point, features such as custom smileys and buddy icons aren't yet implemented. -10.5 Will I be able to use Gaim for MSN after October 15th? (The day they're - preventing third party clients from connecting) - +10.5 Will I be able to use Gaim for MSN after October 15th 2003? (The day + they're preventing third party clients from connecting) + Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is supported - after October 15th. + after October 15th 2003. 10.6 I just upgraded Gaim and the MSN plugin will not load. Why? - + You did not compile with SSL support, or the SSL plugin failed to load. As of protocol version 9, the MSN protocol requires the use of SSL, which gaim provides by either GnuTLS or the combination of NSS and NSPR from the Mozilla @@ -812,7 +849,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats question. 10.7 The MSN plugin won't load, but I have Mozilla NSS! - + Some distributions, including Slackware, install Mozilla NSS to a non-standard directory. The fix is simple. Edit /etc/ld.so.conf and add /usr/ lib/mozilla-1.4 (or whatever version you're using, but it's usually 1.4) to @@ -823,73 +860,101 @@ Gaim: The Pimpin' Penguin IM Clone Thats Mozilla 1.5 has a broken .pc file and does not install the necessary .h files, and so will not be detected. - See http://gaim.sf.net/faq-ssl.php on getting ssl to work with gaim. + See http://gaim.sf.net/faq-ssl.php on getting SSL to work with gaim. + +10.8 What does "MSN: S: 911 3" in the debug window mean when I cannot connect + to msn? + + See http://gaim.sf.net/911.txt. +------------------------------------------------------------------------------ | 11. Gadu-Gadu Protocol +------------------------------------------------------------------------------ 11.1 What is Gadu-Gadu? - + Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at - http://www.gadu-gadu.pl (website in Polish). + www.gadu-gadu.pl (website in Polish). + ++------------------------------------------------------------------------------ +| 12. Zephyr Protocol ++------------------------------------------------------------------------------ + +12.1 What is Zephyr? + + Zephyr is an IM protocol developed at MIT for use with Project Athena. Its + features include Kerberos IV authentication, multi-level chats (aka + "subscriptions"). You're probably using this because your college/employer/ + organization uses it as a local IM/chat system. If not, you probably don't + have a server to connect to. + +12.2 Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with "Couldn't + initialize zephyr". + + Your site might require the use of Kerberos 4 for authentication, though few + (if any) prepackaged gaim binaries compile it with Kerberos support. The + solution is to compile gaim with the --with-krb4 flag to point to the + location of your Kerberos 4 devel files, usually one of /usr, /usr/local, or + /usr/athena , e.g. ./configure --with-krb4=/path/to/kerberosIV + +12.3 Gaim isn't working, but I never got any other zephyr client working on + this machine. + + You need to have zhm (which comes with the standard zephyr distribution) + installed, and running, and pointed at your zephyr servers. e.g. + + zhm z1.example.com z2.example.com z3.example.com + + Alternately, there might be a firewall or a NAT between you and the zephyr + servers Zephyr doesn't work in an environment where incoming connections + cannot be made to arbitrary UDP ports. +------------------------------------------------------------------------------ -| 12. Trepia Protocol +| 13. Trepia Protocol +------------------------------------------------------------------------------ -12.1 I heard Trepia was going to be in 0.65. Where is it? - +13.1 I heard Trepia was going to be in 0.65. Where is it? + Support for the Trepia protocol was removed right before 0.65's release. It may make it into a future version, but we're not sure yet. -12.2 Trepia is showing people in Japan, England, etc. on my buddy list. I +13.2 Trepia is showing people in Japan, England, etc. on my buddy list. I thought this was supposed to show people in my area? - - We believe this to be the protocol, not Gaim. As Trepia continues to update - and refine their protocol, it will become more accurate. If we find out - otherwise, we will attempt to incorporate the changes necessary to act like - the official client. - -+------------------------------------------------------------------------------ -| 13. Scripts and Plugins -+------------------------------------------------------------------------------ - -13.1 How do I use perl scripts with Gaim? - - Save the perl script to ~/.gaim/ or $prefix/lib/gaim/, restart Gaim, and load - the perl script by checking the check box next to its name on the Plugins - page in preferences. - -13.2 How do I compile a plugin for Gaim? - - To compile a plugin for Gaim, you must have Gaim's source code. There are two - ways to get this: Tarballs, and CVS. To work with a tarball, follow the - instructions below. To use CVS, follow the instructions on the CVS (http:// - gaim.sf.net/cvs.php) page. Please note that often, CVS is much less stable - than the tarballs! Do not use CVS unless you are writting a patch. - To work with a tarball, download the latest source code from http:// - gaim.sf.net/ and untar it with the command: + We believe this to be the fault of protocol, not Gaim. As Trepia continues to + update and refine their protocol, it will become more accurate. If we find + out otherwise, we will attempt to incorporate the changes necessary to act + like the official client. - tar zxvf filename ++------------------------------------------------------------------------------ +| 14. Scripts and Plugins ++------------------------------------------------------------------------------ + +14.1 How do I use perl scripts with Gaim? + + Save the perl script to ~/.gaim/plugins/ or $prefix/lib/gaim/, restart Gaim, + and load the perl script by checking the check box next to its name on the + Plugins page in preferences. +14.2 How do I compile a plugin for Gaim? + + To compile a plugin for Gaim, you must have Gaim's source code. To download + Gaim's source code, get the most recent tarball from http:// + gaim.sourceforge.net/downloads.php (http://gaim.sf.net/downloads.php) and + untar it with the command: + tar zxvf filename where filename is the file you downloaded. - After you have a Gaim source code tree, either through tarballs or CVS: + After you have a Gaim source code tree: 1. Change to the resulting directory and run the command: - ./configure - This will create the necessary make files. 2. Move the plugin you wish to compile into the plugins/ directory in the Gaim source code tree. 3. Change to the plugins/ directory. 4. Type: - make name.so - where the name of the file you wish to compile is name.c. Note well the difference in the extensions. If you type make name.c @@ -900,85 +965,85 @@ Gaim: The Pimpin' Penguin IM Clone Thats compiling it yourself, $prefix is /usr/local by default. Otherwise, $prefix is /usr. -13.3 I have a plugin or perl script for Gaim that does not work with 0.60 or +14.3 I have a plugin or perl script for Gaim that does not work with 0.60 or higher. - + The plugin and perl script API has changed in 0.60, which means plugins and perl scripts must be modified in order to work. The plugin or perl script - must be located in $prefix/lib/gaim or in ~/.gaim, and must implement the new - API, as documented in the howto file in the plugins directory. Plugins and - perl scripts are now controled from preferences. + must be located in $prefix/lib/gaim/ or in ~/.gaim/plugins/, and must + implement the new API, as documented in the HOWTO file in the plugins + directory. Plugins and perl scripts are now controled from preferences. + +14.4 Where can I find documentation on writing plugins and Perl scripts? -13.4 Where can I find documentation on writing plugins and Perl scripts? - If you look in the plugins/ directory in the Gaim source, you should see a - HOWTO file for C plugins and a PERL-HOWTO for Perl scripts. + HOWTO file with some details for C plugins. Also be sure to check out our + online documentation (http://gaim.sf.net/api/index.html). Be especially sure + to look at the Related Pages, which lists all of Gaim's signals, as well as a + nice perl script HOWTO. - In 0.68 or later, get the source code and run make docs. You will need - doxygen and graphviz dot installed for this to work. This will produce an api - reference and both the perl and plugin documentation. + This documentation can be generated directly from the Gaim source by running + make docs. You will need doxygen and graphviz dot installed for this to work. +------------------------------------------------------------------------------ -| 14. Development +| 15. Development +------------------------------------------------------------------------------ -14.1 Where should I report bugs? - +15.1 Can I help? + + But of course. Just find something that's bugging you and fix it. There is a + slew of a bug reports in Gaim's bug report tracker, you could pick one and + try to tackle it and submit a patch. You could also help with general bug + triage by going through the bug reports and leaving comments such as "this + has been fixed" or "this is a duplicate of bug #12345." As always, make sure + you follow the same coding style used in Gaim, and make sure you don't break + the core/UI split. + +15.2 Gaim never leaves a core file. + + On most installs core files are limited in size to 0 bytes, and are therefore + not created. To rectify this situation, add ulimit -c unlimited to your + startup scripts (~/.bash_profile is a good place) or run it manually in a + terminal before starting gaim from that terminal. You can also run Gaim + directly in gdb with gdb gaim. + +15.3 Where should I report bugs? + http://gaim.sf.net/bug.php. -14.2 Gaim never leaves a core file. - - On most installs, for some odd reason, core files are limited in size to 0 - bytes, and so are not created. To rectify this situation, add ulimit -c - unlimited to your startup scripts or run it manually in a terminal before - starting gaim from that terminal. +15.4 Where should I submit patches? -14.3 Where should I submit patches? - http://gaim.sf.net/patches.php. -14.4 Did you guys reverse engineer it? - +15.5 Did you guys reverse engineer it? + TOC, Jabber, MSN, Napster, and IRC are published protocols, so we didn't have to reverse engineer those. Oscar, ICQ, and Yahoo are not published, and were reverse engineered by other people. -14.5 Will Gaim be ported to Windows 95/98/Me/2000/XP? - - Gaim has released a Windows version. - +------------------------------------------------------------------------------ -| 15. Misc. Questions +| 16. Misc. Questions +------------------------------------------------------------------------------ -15.1 Does AOL's attempts at blocking Trillian affect Gaim? - - No. - -15.2 Is Gaim affected by the vulnerability found in Windows AIM or Yahoo - Instant Messenger clients? - - No. +16.1 Can I IM you guys? -15.3 Can I IM you guys? - - Sure! Look at the Contact Information (http://gaim.sf.net//contactinfo.php) + Sure! Look at the Contact Information (http://gaim.sf.net/contactinfo.php) page! -15.4 Hello? - +16.2 Hello? + We don't know how to answer this question. Stop asking it. -15.5 Can I give you money/hardware/other expensive things that can be hocked +16.3 Can I give you money/hardware/other expensive things that can be hocked for cash what with you all being students/full-time-workers and helping to produce this wonderful software instead of studying/sleeping? - + No. We're completely fool-hardy and won't accept any gratuities with no strings attached for just being good guys. That and we'd have to share with everyone who has submitted patches. ;-) -15.6 Does Gaim support secure instant messaging (encrypted IMs)? - +16.4 Does Gaim support secure instant messaging (encrypted IMs)? + Not natively. Doing secure instant messaging right is a big deal and requires, among other things, an authentication scheme. Simply encrypting your data stream without verifying the party with whom you are chatting is @@ -986,26 +1051,26 @@ Gaim: The Pimpin' Penguin IM Clone Thats feel that such measures instill a false sense of security that is more harmful than helpful. - The gaim-e project (http://gaim-e.sourceforge.net/) is working on developing - a secure IM framework that uses the GnuPG and the OpenPGP trust model for - authentication. If you are serious about secure instant messaging, read the - documentation on the "web of trust" model available at http://www.gnupg.org/ - and try out gaim-e. + There are a number of 3rd party plugin developers working on developing a + secure IM framework, the better ones using the GnuPG and the OpenPGP trust + model for authentication. If you are serious about secure instant messaging, + read the documentation on the "web of trust" model available at www.gnupg.org + and try out one of these. + +16.5 Why are the passwords in accounts.xml not encrypted? -15.7 Why are the passwords in accounts.xml not encrypted? - This is a case of a really long answer to a short question. Read our explanation at http://gaim.sf.net/plaintextpasswords.txt. -15.8 What is gaim-remote? - +16.6 What is gaim-remote? + gaim-remote is a second executable included with Gaim starting with 0.60. It allows you to perform some actions to control/manipulate an existing Gaim process from the command line. Run gaim-remote --help to get an idea of what we currently envision it doing. -15.9 When will the next version of Gaim be released? - +16.7 When will the next version of Gaim be released? + The schedule for releases is every other Thursday. However, a new version will only be released if it meets a certain standard of quality (i.e., it will not be released if it still has a large number of serious bugs). Index: doc/conversation-signals.dox =================================================================== RCS file: /cvsroot/gaim/gaim/doc/conversation-signals.dox,v retrieving revision 1.10 diff -u -p -r1.10 conversation-signals.dox --- doc/conversation-signals.dox 17 Feb 2004 04:09:28 -0000 1.10 +++ doc/conversation-signals.dox 20 Apr 2004 12:22:06 -0000 @@ -1,11 +1,15 @@ /** @page conversation-signals Conversation Signals @signals + @signal writing-im-msg + @signal wrote-im-msg @signal displaying-im-msg @signal displayed-im-msg @signal sending-im-msg @signal sent-im-msg @signal received-im-msg + @signal writing-chat-msg + @signal wrote-chat-msg @signal displaying-chat-msg @signal displayed-chat-msg @signal sending-chat-msg @@ -53,7 +57,7 @@ void (*wrote_im_msg)(GaimAccount *accoun Emitted after a message is entered by the user, but before it is sent and displyed. When sending an IM, the order that the im-msg callbacks will be called is: writing-im-msg, wrote-im-msg, displaying-im-msg, displayed-im-msg, sending-im-msg, - sending-im-msg, and finally sent-im-msg. + and finally sent-im-msg. @param account The account the message was displayed on. @param conv The conversation the message was displayed on. @param message The message that was displayed. @@ -130,6 +134,7 @@ gboolean (*received_im_msg)(GaimAccount @param account The account the message was received on. @param sender A pointer to the username of the sender. @param message A pointer to the message that was sent. + @param flags The message flags. @endsignaldef @signaldef writing-chat-msg @@ -150,15 +155,15 @@ gboolean (*writing_chat_msg)(GaimAccount @return @c TRUE if the message should be canceled, or @c FALSE otherwise. @endsignaldef - @signaldef wrote-im-msg + @signaldef wrote-chat-msg @signalproto -void (*wrote_im_msg)(GaimAccount *account, GaimConversation *conv, const char *message); +void (*wrote_chat_msg)(GaimAccount *account, GaimConversation *conv, const char *message); @endsignalproto @signaldesc Emitted after a message is entered by the user, but before it is sent and displyed. When sending an IM, the order that the im-msg callbacks will be called is: writing-im-msg, wrote-im-msg, displaying-im-msg, displayed-im-msg, sending-im-msg, - sending-im-msg, and finally sent-im-msg. + and finally sent-im-msg. @param account The account the message was displayed on. @param conv The conversation the message was displayed on. @param message The message that was displayed. Index: doc/gaim.1.in =================================================================== RCS file: /cvsroot/gaim/gaim/doc/gaim.1.in,v retrieving revision 1.4 diff -u -p -r1.4 gaim.1.in --- doc/gaim.1.in 5 Feb 2004 04:43:14 -0000 1.4 +++ doc/gaim.1.in 20 Apr 2004 12:22:06 -0000 @@ -39,8 +39,8 @@ Launch the \fBAccount Editor\fR rather t .B \-d, \-\-debug Print debugging messages to stdout. These are the same debugging messages that are displayed in the \fBDebug\fR window. .TP -.B \-f, \-\-file=\fIFILE\fB -Use \fIFILE\fR as the configuration file instead of \fI~/.gaimrc\fR. +.B \-c, \-\-config=\fIDIR\fB +Use \fIDIR\fR as the directory for config files instead of \fI~/.gaim\fR. .TP .B \-h, \-\-help Print this help and exit. @@ -72,7 +72,7 @@ Opens a new \fBConversation\fR window to A Buddy Pounce is a configurable automated action to be performed when the buddy's state changes. This will open the \fBBuddy Pounce\fR dialog to be discussed later. .TP .B View Log -\fBgaim\fR is capable of automatically log its activities. These logs are html files (with a .log extenstion) located in the \fI~/.gaim/logs\fR directory. This menu command will attempt to view this file with \fBgaim\fR's internal log viewer. +\fBgaim\fR is capable of automatically log its activities. These logs are either plain text files (with a .log extension) or html files (with a .html extenstion) located under the \fI~/.gaim/logs\fR directory. This menu command will attempt to view this file with \fBgaim\fR's internal log viewer. .TP .B Alias Create an alias for this buddy. This will open up a new dialog in which one can give this buddy an alternate name to appear on the buddy list and in conversataions. @@ -119,11 +119,11 @@ All options take effect immediately. \fIDisplay remote nicknames if no alias is set\fR: Toggles whether server nickname data should be used if no local alias exists. .TP -.B Themes -Allows the user to choose between different emoticon themes. +.B Smiley Themes +Allows the user to choose between different smiley themes. .TP .B Fonts -Lets the user pick a default font style/face/color for all accounts (only available in protocols that accept HTML messages). +Lets the user pick a default font style/face/color for all accounts (only applicable to protocols that support HTML formatting in messages). .TP .B Message Text \fIShow graphical smileys\fR: Enables the replacement of text emoticons with their graphical equivalents. @@ -138,26 +138,44 @@ Lets the user pick a default font style/ Allows the user to determine which keyboard shortcuts are available. .TP .B Buddy List -\fIHide IM/Info/Chat buttons\fR: Disables the display of these buttons on the -\fBBuddy List\fR's \fBOnline\fR pane. +\fISorting\fR: Toggles the order in which buddies are shown in your \fBBuddy List\fR between none, alphabetical, by status and by log size. -\fIShow pictures on buttons\fR: Toggles between picture-only and text-only views of the buttons on the \fBBuddy List\fR. - -\fISave window size/position\fR: If enabled, \fBgaim\fR will place the \fBBuddy List\fR at its last screen position at start-up. +\fIShow buttons as\fR: Toggles between picture-only, text-only, picure and text or no buttons view of the buttons on the \fBBuddy List\fR. \fIRaise window on events\fR: Tells \fBgaim\fR to bring the \fBBuddy List\fR window to the top when buddies sign in or out. -\fIHide groups with no online buddies\fR: Groups in which no buddies are currently logged in will not be shown in the \fBOnline\fR pane. - \fIShow numbers in groups\fR: The number of buddies from each group currently logged in will be shown along with the total number of buddies in the group. -\fIShow buddy type icons\fR: The icons showing which protocol each buddy uses and whether or not the buddy is away will not be shown. +\fIShow buddy icons\fR: Toggles the display of buddies' custom icons. \fIShow warning levels\fR: Each buddy's warning level will be displayed next to the screen name. As a buddy's warning level increases, outgoing messages are more and more severely rate-limited. \fIShow idle times\fR: The amount of time each buddy has been idle will be displayed next to the screen name (if the buddy has opted to have their client report this information). -\fIGrey idle buddies\fR: If enabled, idle buddies will be displayed in grey text instead of black text. +\fIDim idle buddies\fR: If enabled, idle buddies will be displayed in grey text instead of black text. + +\fIAutomatically expand contacts\fR: If enabled, contacts will automatically expand to show the associated buddies when the mouse is held over the contact for a short period. + +.SH Conversations + +\fIPlacement...\fR: Determines where new conversations will be placed (Last created window / New window / windows grouped by group or account). + +\fISend URLs as links\fR: Automatically turns URLs into clickable links when sent on protocols that support HTML. + +\fIShow formatting toolbar\fR: Display the formatting toolbar between the upper and lower text boxes in conversations. + +\fIShow aliases in tabs/titles\fR: Displays buddy alias instead of screen name in window tabs and titles. + +\fITab Placement...\fR: Specifies where tabs are shown in the conversation window. + +\fIShow IMs and chats in tabbed windows\fR: Tabbed chatting allows one to have multiple conversations without multiple windows. + +\fIShow IMs and chats in same tabbed window\fR: Uses the same window for both IMs and chats. + +\fIShow close buttons on tabs\fR: Adds a close button to each tab. + +\fIShow status icons on tabs\fR: Adds an icon to each tab representing the buddy's status. + .TP .B IM Window \fIShow buttons as...\fR: The selected item will determine whether picture-only, text-only, or combined picture/text buttons will be used for \fBConversation\fR windows. @@ -186,8 +204,6 @@ Allows the user to determine which keybo \fIColorize screennames\fR: Color code the screen names of users in chat rooms. .TP -.B Tabs -Tabbed chatting allows one to have multiple conversations without multiple windows. \fbTabs\fR show which conversations have unanswered messages, and can identify a user either by screen name or by alias. .SH Proxy @@ -203,7 +219,7 @@ Allows the user to select \fBgaim\fR's d .SH Sounds -\fINo sounds when you log in\fR: Makes the log-in process silent. +\fISounds when you log in\fR: Enables sounds during log-in. \fISounds while away\fR: Determines whether sounds are played when an away message is up. @@ -244,40 +260,37 @@ Allows the user to enable add-on plugins Some plugins can be configured. If you load such a plugin, its configuration preferences will appear as a submenu to \fBPlugins\fR, with the submenu title determined by the plugin's name. .SH CONVERSATIONS -When starting a new conversation, the user is presented with the \fBConversation\fR window. The conversation appears in the upper text box and the user types his/her message in the lower text box. Between the two is a row of settings, represented by icons. From left to right: +When starting a new conversation, the user is presented with the \fBConversation\fR window. The conversation appears in the upper text box and the user types his/her message in the lower text box. Between the two is a row of settings, represented by icons. Some or all buttons may not be active if the protocol does not support the specific formatting. From left to right: .TP .B Bold -adds to your message +Turns on/off bold. .TP .B Italics -adds to your message +Turns on/off italics. .TP .B Underline -adds to your message +Turns on/off underline. .TP .B Decrease font size -adds to your message -.TP -.B Default font size -adds to your message +Increases the size of the message text. .TP .B Increase font size -adds to your message +Decreases the size of the message text. .TP .B Select a foreground color -adds an appropriate font tag to your message. +Changes the foreground color of the message text. .TP .B Select a background color -adds an appropriate body tag to your message. +Changes the background color of the message text. .TP .B Add image -inserts an appropriate img tag (not available in all protocols). +Inserts an in-line image in the message. .TP .B Add hyperlink -adds an appropriate a href tag to your message. +Adds a clickable link to the message. .TP .B Add smiley -adds an ASCII smiley to your message. This will become a graphic smiley in the upper text box if the option for graphical smileys is set. +Adds an emoticon (smiley) to your message. Beneath the lower text box is a row of buttons that execute commands: .TP @@ -334,6 +347,9 @@ A Buddy Pounce is an automated trigger t .SH PERL \fBGaim\fR allows for perl scripting. See \fIPerl Scripting HOWTO\fR in the Gaim documentation for more information about perl scripting. +.SH TCL +\fBGaim\fR allows for Tcl scripting. See \fIplugins/tcl/TCL-HOWTO\fR for more information about Tcl scripting. + .SH FILES \fI@prefix@/bin/gaim\fR: \fBgaim\fR's location. .br @@ -347,15 +363,21 @@ A Buddy Pounce is an automated trigger t .br \fI~/.gaim/pounces.xml\fR: stores your buddy pounces. .br -\fI~/.gaim/logs/SCREENNAME.log\fR: a log of all conversation with \fISCREENNAME\fR. +\fI~/.gaim/logs/PROTOCOL/ACCOUNT/SCREENNAME/DATE.log\fR: conversation logs. .br \fI~/.gaim/blist.xml\fR: the buddy list. +.br +\fI~/.gaim/plugins/\fR: users local plugins .SH BUGS -Known bugs are listed at \fIhttp://sourceforge.net/tracker/?group_id=235&atid=100235\fR. +Known bugs are listed at +.br +\fIhttp://sourceforge.net/tracker/?group_id=235&atid=100235\fR .SH PATCHES -If you fix a bug in \fBgaim\fR (or otherwise enhance it), please submit a patch (using \fIcvs diff -u > my.diff\fR against the latest CVS version) at \fIhttp://sourceforge.net/tracker/?func=add&group_id=235&atid=300235\fR. +If you fix a bug in \fBgaim\fR (or otherwise enhance it), please submit a patch (using \fIcvs diff -up > my.diff\fR against the latest CVS version) at +.br +\fIhttp://sourceforge.net/tracker/?func=add&group_id=235&atid=300235\fR Before sending a bug report, please verify that you have the latest version of \fBgaim\fR. Many bugs (major and minor) are fixed