From: Stu T. <nos...@us...> - 2005-02-26 18:55:49
|
Update of /cvsroot/gaim/gaim/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv23849 Modified Files: Tag: oldstatus FAQ Log Message: Sync the in-tree FAQ with reality Index: FAQ =================================================================== RCS file: /cvsroot/gaim/gaim/doc/FAQ,v retrieving revision 1.31 retrieving revision 1.31.2.1 diff -u -d -p -r1.31 -r1.31.2.1 --- FAQ 31 Jul 2004 15:27:39 -0000 1.31 +++ FAQ 26 Feb 2005 18:55:36 -0000 1.31.2.1 @@ -15,10 +15,11 @@ Gaim: The Pimpin' Penguin IM Clone Thats key? 1.8. Can I use Gaim for GTK+1.2? 1.9. Can I run Gaim on IRIX? - 1.10. How do I apply the patch "something.diff"? - 1.11. Why is gaim crashing when I start it? - 1.12. Gaim <non-current version> is buggy. Gaim CVS is buggy. Why? - 1.13. Why do you always say not to use CVS? + 1.10. Can I run gaim on MacOSX? + 1.11. How do I apply the patch "something.diff"? + 1.12. Why is gaim crashing when I start it? + 1.13. Gaim <non-current version> is buggy. Gaim CVS is buggy. Why? + 1.14. Why do you always say not to use CVS? 2. Using Gaim @@ -29,15 +30,18 @@ Gaim: The Pimpin' Penguin IM Clone Thats 2.4. How do I make gaim use emacs-like keybindings? 2.5. How do I use smiley themes? 2.6. Why are the status icons so big? - 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 + 2.7. Why do the emblems move around the status icon? + 2.8. How do I get sound to work correctly? + 2.9. How do I make Gaim use ALSA or OSS for playing sounds? What does the "Automatic" option do? Why does Gaim use the same WM_CLASS for every window? It makes - 2.9. it impossible to control window size and placement for the buddy + 2.10. it impossible to control window size and placement for the buddy list separately from the conversations. - 2.10. What is a "Buddy Pounce"? - 2.11. Where does gaim store its logs? - 2.12. Can I use Gaim for e-mail, blogging, an RSS feed, or something + 2.11. I blocked someone accidentally, how can I unblock them? + 2.12. What is a "Buddy Pounce"? + 2.13. Where does gaim store its logs? + 2.14. How can I see my own status with Gaim? + 2.15. Can I use Gaim for e-mail, blogging, an RSS feed, or something else that isn't IM-related? 3. Features @@ -76,6 +80,9 @@ Gaim: The Pimpin' Penguin IM Clone Thats 6.9. 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.10. Why can't I connect via either Oscar or TOC? + English is not my native language, and some of my friends have + 6.11. trouble seeing my IMs/I have trouble seeing my friends' IMs. How + do I use a native language character set with ICQ? 7. IRC Protocol @@ -98,20 +105,32 @@ Gaim: The Pimpin' Penguin IM Clone Thats 9. Y!M (Yahoo) Protocol - 9.1. I cannot connect to yahoo! + 9.1. I cannot connect to Yahoo! and get "Invalid Password" errors, or + I'm using a version of Gaim older than 0.79! + 9.2. I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why + doesn't Gaim have Yahoo's "Firewall with no proxy" option? + 9.3. I blocked someone, but it doesn't seem to have worked. + 9.4. Can I get a list of Yahoo! Chat rooms? What about non-US lists? + 9.5. What protocol does Gaim use to connect to Yahoo!? 10. MSN Protocol - 10.1. I'm getting lots of "Already in Opposite list" errors on msn, - why? - 10.2. Is there a way to invite more than one person to an MSN chat? - 10.3. Is MSNP9 (MSN6) going to be supported? - 10.4. Will I be able to use Gaim for MSN after October 15th 2003? (The - day they're preventing third party clients from connecting) - 10.5. I just upgraded Gaim and the MSN plugin will not load. Why? - 10.6. The MSN plugin won't load, but I have Mozilla NSS! - 10.7. What does "MSN: S: 911 3" in the debug window mean when I cannot - connect to msn? + 10.1. Why are my file transfers so slow? + 10.2. I'm getting lots of "Already in Opposite list" errors on MSN, + why? + 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? + Will I be able to use Gaim for MSN after October 15th 2003? + 10.5. (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? + 10.9. How do I set an MSN avatar? + 10.10. What does "Has you" in the buddy tooltip mean? + 10.11. How do I set my MSN Friendly Name (the name other users see)? + 10.12. What does "Error reading from switchboard server" mean? 11. Gadu-Gadu Protocol @@ -121,55 +140,54 @@ Gaim: The Pimpin' Penguin IM Clone Thats 12. Zephyr Protocol 12.1. What is Zephyr? - 12.2. Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with + 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 + 12.3. Gaim isn't working, but I never got any other Zephyr client working on this machine. + 12.4. How do I use Zephyr from behind my firewall, or without + recompiling with kerberos support if needed? -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? - -14. SILC Protocol +13. SILC Protocol - 14.1. What is SILC? + 13.1. What is SILC? -15. Novell Protocol +14. Novell Protocol - 15.1. Are there any public servers for Novell? - 15.2. I can't seem to get it to work. + 14.1. Are there any public servers for Novell? + 14.2. I can't seem to get it to work. -16. Scripts and Plugins +15. Scripts and Plugins - 16.1. How do I use perl scripts with Gaim? - 16.2. How do I compile a plugin for Gaim? - 16.3. I have a plugin or perl script for Gaim that does not work with - 0.60 or higher. - 16.4. Where can I find documentation on writing plugins and Perl + 15.1. How do I use perl scripts with Gaim? + 15.2. How do I compile a plugin for Gaim? + 15.3. I have a plugin or perl script for Gaim that used to work, but + does not with the current version. + 15.4. Where can I find documentation on writing plugins and Perl scripts? -17. Development +16. Development - 17.1. Can I help? - 17.2. Gaim never leaves a core file. - 17.3. Where should I report bugs? - 17.4. Where should I submit patches? - 17.5. Did you guys reverse engineer it? + 16.1. Can I help? + 16.2. Gaim never leaves a core file. + 16.3. Where should I report bugs? + 16.4. Where should I submit patches? + 16.5. Did you guys reverse engineer it? -18. Misc. Questions +17. Misc. Questions - 18.1. Can I IM you guys? - 18.2. Hello? + 17.1. Can I IM you guys? + 17.2. Hello? Can I give you money/hardware/other expensive things that can be - 18.3. hocked for cash what with you all being students/ + 17.3. hocked for cash what with you all being students/ full-time-workers and helping to produce this wonderful software instead of studying/sleeping? - 18.4. Does Gaim support secure instant messaging (encrypted IMs)? - 18.5. Why are the passwords in accounts.xml not encrypted? - 18.6. What is gaim-remote? - 18.7. When will the next version of Gaim be released? + 17.4. Does Gaim support secure instant messaging (encrypted IMs)? + 17.5. Why are the passwords in accounts.xml not encrypted? + 17.6. What is gaim-remote? + 17.7. When will the next version of Gaim be released? + 17.8. What will the next version be? + 17.9. So, can I look forward to mega-sexy super functionality with + Gaim? +------------------------------------------------------------------------------ | 1. Compiling and Installing @@ -215,7 +233,12 @@ Gaim: The Pimpin' Penguin IM Clone Thats toolkit/) and the Gaim SILC plugin. This plugin is generally provided as a separate package (such as a gaim-silc RPM). If you're compiling yourself, see the ./configure --help for specifying the SILC includes and libs. If you're - compiling an SRPM, use "--with silc" to build the gaim-silc RPM. + compiling an SRPM, use --with silc to build the gaim-silc RPM. + + In Windows, the SILC toolkit is installed with Gaim. + + Some distributions provide the SILC toolkit and include Gaim's SILC plugin in + their Gaim package. 1.5 Is there some way I can compile just Gaim, without all of these protocols? @@ -238,7 +261,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats 1.6 I installed a new version of Gaim, but the about window says I'm still using the old version. - If you compiled yourself, and you previously had an rpm or a Debian package + 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. @@ -271,12 +294,21 @@ Gaim: The Pimpin' Penguin IM Clone Thats It has been done before. Please see http://sourceforge.net/forum/forum.php? thread_id=725839&forum_id=665 at our SourceForge Forum. -1.10 How do I apply the patch "something.diff"? +1.10 Can I run gaim on MacOSX? + + Yes you can, but we do not provide a package for it. The reason being is that + to use gaim on MacOSX, you need to install an X server and gtk, which we are + not prepared to support. You can either compile gaim (and its dependencies) + yourself, or you can use the fink installer available from http://fink.sf.net + . If you would like a native aqua interface or a user-friendly installer, we + suggest trying Adium (http://www.adiumx.com/). + +1.11 How do I apply the patch "something.diff"? Type patch -p0 < something.diff from inside the gaim directory. If that doesn't work, try patch -p1 < something.diff. -1.11 Why is gaim crashing when I start it? +1.12 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 following: @@ -296,14 +328,14 @@ Gaim: The Pimpin' Penguin IM Clone Thats * If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto away preference from -1 to 0. -1.12 Gaim <non-current version> is buggy. Gaim CVS is buggy. Why? +1.13 Gaim <non-current version> is buggy. Gaim CVS is buggy. Why? Non-current versions have old bugs which may be fixed in the current version--that's why we make new releases. CVS is frequently unusable because of changes in the code. Bugs are introduced during the development process and are hopefully fixed before a release is made. -1.13 Why do you always say not to use CVS? +1.14 Why do you always say not to use CVS? That's a long story. For starters, see the previous question. It is often the case that Gaim CVS exhibits bad behavior due to features and bugfixes which @@ -363,9 +395,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats MSN (including Hotmail email): Go to http://registernet.passport.com/. - MSN (using your own email address): Go to https://register.passport.net/ - reg.srf?lc=1033&id=486&ru= - http%3A%2F%2Fwww%2Epassport%2Enet%2FConsumer%2FDefault%2Easp%3Flc%3D1033&sl=1 + MSN (using your own email address): Go to http://register.passport.net/. Yahoo: Go to http://edit.yahoo.com/config/eval_register. @@ -389,6 +419,8 @@ Gaim: The Pimpin' Penguin IM Clone Thats messages. The display fonts used by the rest of Gaim are those specified by GTK. To 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. + On Windows, this file is located at C:\Documents and Settings\username + \.themes\Default\gtk-2.0\gtkrc. You can also just switch to a different GTK theme. You can find GTK themes (and information on using them) by visiting themes.freshmeat.net, @@ -429,7 +461,18 @@ Gaim: The Pimpin' Penguin IM Clone Thats similar to IM clients they may have used in the past. The 'Big List' can be disabled by un-checking "Show buddy icons" in the Buddy List preferences. -2.7 How do I get sound to work correctly? +2.7 Why do the emblems move around the status icon? + + The four corners of the icon have different precedence. The lower-right is + the highest, lower-left is second-highest, etc. The most important emblem is + in the lower-right, always. When an AOL buddy is not away, the fact that [s] + he's an AOL user is the most important information shown in the icon. The + consistency is that the user can always look in the same place on the icon to + find out what he needs to know. Also, importantly, the lower-right corner + emblem is the only emblem that shows up when "Small list" is on, as only one + emblem would fit. + +2.8 How do I get sound to work correctly? Gaim uses libao to play sounds. Playing sounds directly through esound or arts is no longer supported. @@ -443,9 +486,9 @@ Gaim: The Pimpin' Penguin IM Clone Thats 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." + method in preferences to Command and use esdplay %s or artsplay %s. -2.8 How do I make Gaim use ALSA or OSS for playing sounds? What does the +2.9 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. @@ -455,16 +498,17 @@ Gaim: The Pimpin' Penguin IM Clone Thats If you choose "Automatic", 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=alsa + + default_driver=oss - 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'. + supported, depending on your platform and how libao was compiled. See also + man 5 libao.conf. -2.9 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. +2.10 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 @@ -480,7 +524,11 @@ Gaim: The Pimpin' Penguin IM Clone Thats differentiating between Gaim windows, please ensure that it uses the WM_WINDOW_ROLE hint per the ICCCM. -2.10 What is a "Buddy Pounce"? +2.11 I blocked someone accidentally, how can I unblock them? + + See the "Privacy" option under the "Tools" menu of the Buddy List. + +2.12 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 @@ -493,19 +541,25 @@ 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.11 Where does gaim store its logs? +2.13 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.12 Can I use Gaim for e-mail, blogging, an RSS feed, or something else that +2.14 How can I see my own status with Gaim? + + Currently the only supported method to see your own status is to add yourself + to your buddy list. This works with Aim, ICQ, Y!M, IRC, and some of the + others, and is mimiced by gaim for MSN and Jabber. + +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 a - messenging client. Aside from the capabilities each protocol may support, the - Gaim developers have no intention to turn Gaim into a multi-feature Internet + No, you can't. We get requests for this often, but Gaim is indeed a messaging + 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 @@ -584,6 +638,9 @@ Gaim: The Pimpin' Penguin IM Clone Thats collapsed, Gaim will select a buddy to display based on the status of the buddies in the contact, and their order. + You may need to turn off the preference option to automatically expand + Contacts in order to be able to edit an existing Contact. + 3.8 How do I get the old logging back? The old logging was removed because it was deficient in many ways. There is @@ -662,7 +719,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats this with Gnome 2, run gnome-file-types-properties or "File Types and Programs" from the preferences menu. Add a service with protocol "aim" and set the program to gaim-remote uri "%s". This will make AIM URIs work in - Galeon 2. Also, not all types of aim URI's are supported. The ones that are + 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. @@ -724,9 +781,18 @@ Gaim: The Pimpin' Penguin IM Clone Thats 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 - /net/ipv4/tcp_ecn" as root, or (if your distribution supports it) put the - line "net.ipv4.tcp_ecn = 0" in the file /etc/sysctl.conf. + "ECN-capable". In order to turn this off, run the command + echo 0 > /proc/sys/net/ipv4/tcp_ecn + as root, or (if your distribution supports it) put the line + net.ipv4.tcp_ecn = 0 + in the file /etc/sysctl.conf. + +6.11 English is not my native language, and some of my friends have trouble + seeing my IMs/I have trouble seeing my friends' IMs. How do I use a + native language character set with ICQ? + + Gaim 0.82 and higher allow you to specify a character encoding to use when + conversing with ICQ users. Use the account editor to set this encoding. +------------------------------------------------------------------------------ | 7. IRC Protocol @@ -743,9 +809,10 @@ Gaim: The Pimpin' Penguin IM Clone Thats chats on login? Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it. + Do not include "/msg nickserv" as part of the message to send. In version 0.64 or higher, you can add a chat to your buddy list, right click - it, and tell gaim to auto-join it. + it, and tell Gaim to auto-join it. +------------------------------------------------------------------------------ | 8. Jabber Protocol @@ -833,53 +900,137 @@ Gaim: The Pimpin' Penguin IM Clone Thats | 9. Y!M (Yahoo) Protocol +------------------------------------------------------------------------------ -9.1 I cannot connect to yahoo! +9.1 I cannot connect to Yahoo! and get "Invalid Password" errors, or I'm using + a version of Gaim older than 0.79! Make sure you have at least 0.79. +9.2 I cannot connect to Yahoo! and I'm behind a firewall or NAT. Why doesn't + Gaim have Yahoo's "Firewall with no proxy" option? + + Yahoo!'s firewall with no proxy option connects to Yahoo! by wrapping the + YMSG protocol inside HTTP. Gaim currently doesn't support doing this. + + Gaim does support changing the port it connects to. Try changing the + Pager Port in the Account editor under "Show more options". Ports known to + work are: 20, 23, 25, 80, 119, 5050, 8001, and 8002. While this doesn't work + for as many people as actually tunneling through the HTTP protocol would, it + helps many users. + +9.3 I blocked someone, but it doesn't seem to have worked. + + As of 0.81, this is a known bug in our Yahoo code. We're not sure what + exactly is wrong, but it seems to fail most often when automatically removing + the buddy from your buddy list at the same time it blocks them. It also + always seems to fail if Gaim already thinks the buddy is blocked, and you try + to block them again. + + We suggest manually removing Yahoo! buddies before attempting to block them. + For buddies which Gaim reports are blocked but which are not, unblocking them + and reblocking them from the Tools->Privacy dialog will often get things + working. + +9.4 Can I get a list of Yahoo! Chat rooms? What about non-US lists? + + Tools->Room List will let you list available Yahoo! Chat rooms. Yahoo! does + support hidden and invite-only rooms. If you know the name of the room you + wish to join, and it's not invite only, you can join it via Buddies->Join a + Chat. You can also create a chat room this way, although we don't support + setting the hidden or invite-only type settings. + + To get a non-US room list, you'll need to change the Chat Room List Url in + the account editor, under "Show more options". By default this field contains + "http://insider.msg.yahoo.com/ycontent/". You can add a country code prefix + to the url to fetch the list for another country. For example, for the German + list, you would use "http://de.insider.msg.yahoo.com/ycontent/". + + The list of known country codes for this url is: + + * aa => Asia + * ar => Argentina + * au => Australia + * br => Brazil + * ca => Canada + * cf => Central African Republic + * cn => China + * de => Germany + * dk => Denmark + * es => Spain + * fr => France + * hk => Hong Kong + * in => India + * it => Italy + * kr => Korea, Republic of + * mx => Mexico + * no => Norway + * se => Sweden + * sg => Singapore + * tw => Taiwan + * uk => United Kingdom + +9.5 What protocol does Gaim use to connect to Yahoo!? + + Normally Gaim uses the YMSG protocol, which is the same protocol that the + official Yahoo! clients use. If an attempt to login returns the "Invalid + Password" error code, Gaim automatically tries to log in using the "Web + Messenger" method. This method still uses the YMSG protocol, but + authenticates differently, and connects to a different server. + + While in Web Messenger mode, several things work differently or not at all. + Adding, moving, and removing buddies doesn't work, and the only available + statuses are "Available" and "Invisible". In addition, the Yahoo! server + seems to ignore all Yahoo! Chat related packets. For this reason, we use the + YCHT protocol to join Yahoo! Chat rooms while connected using the Web + Messenger method. + +------------------------------------------------------------------------------ | 10. MSN Protocol +------------------------------------------------------------------------------ -10.1 I'm getting lots of "Already in Opposite list" errors on msn, why? +10.1 Why are my file transfers so slow? + + Gaim only supports tranferring files over MSN via the MSN servers. This means + all your data is sent to an MSN server and then forwarded to the person at + the other end of the transfer. It is unknown whether we will support true + peer to peer file transfer over MSN. + +10.2 I'm getting lots of "Already in Opposite list" errors on MSN, why? The reason this happens is because you have a screen name 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 - in 0.60 or later), and manually scan the list and remove the duplicate - 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 screen - names 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. 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 + the quick way. The correct way is to go to Tools->Privacy, and manually scan + the list and remove the duplicate entries. The quick way is to remove the + blist.xml file from the ~/.gaim directory. Be aware that this contains your + buddy list for all accounts, and also stores the "Contact" grouping of Buddies. -10.2 Is there a way to invite more than one person to an MSN chat? +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. :) + Yes. Right click a buddy on your list and choose "Initiate Chat". In the + conversation window that appears, choose "Invite" from the "Conversation" + menu to invite another user. When the conversation framework gets another + rewrite, it is possible that this will be simplified. -10.3 Is MSNP9 (MSN6) going to be supported? +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. + features such as custom smileys aren't yet implemented. -10.4 Will I be able to use Gaim for MSN after October 15th 2003? (The day +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 2003. -10.5 I just upgraded Gaim and the MSN plugin will not load. Why? +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 + 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 project. Install one or both of these and recompile Gaim, and see the next question. -10.6 The MSN plugin won't load, but I have Mozilla NSS! +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/ @@ -891,13 +1042,35 @@ 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.7 What does "MSN: S: 911 3" in the debug window mean when I cannot connect - to msn? +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. +10.9 How do I set an MSN avatar? + + Gaim calls these Buddy Icons. Go to Tools->Accounts and click to Modify your + MSN account. You can drag and drop a file to the resulting dialog, or use the + Open button. + +10.10 What does "Has you" in the buddy tooltip mean? + + It shows you if that MSN user has added you to his/her buddy list. "Has you: + No" does not mean you can't talk to that person. + +10.11 How do I set my MSN Friendly Name (the name other users see)? + + In the Buddy List window, go to Tools->Account Actions->account->Set Friendly + Name. + +10.12 What does "Error reading from switchboard server" mean? + + We haven't fully figured that out yet, but even Microsoft's client seems to + get similar errors, although with less frequency than we do. See Bug 1060205 + for further information. + +------------------------------------------------------------------------------ | 11. Gadu-Gadu Protocol +------------------------------------------------------------------------------ @@ -927,64 +1100,61 @@ Gaim: The Pimpin' Penguin IM Clone Thats 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 +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 + prepackaged Gaim binaries use Kerberos. One 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 +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. - + 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 - Alternatively, 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. - -+------------------------------------------------------------------------------ -| 13. Trepia Protocol -+------------------------------------------------------------------------------ - -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. + Alternatively, there might be a firewall or a NAT between you and the Zephyr + servers. Zephyr generally doesn't work in an environment where incoming + connections cannot be made to arbitrary UDP ports. -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? +12.4 How do I use Zephyr from behind my firewall, or without recompiling with + kerberos support if needed? - 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. + You can use tzc, "Trivial Zephyr Client" and ssh to run Zephyr from a machine + that is behind a firewall or NAT. First, make sure that tzc is installed and + working on the remote machine. The best version of tzc to use can be found + http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/ + tzc-cclub_001-3.tar.gz. Second, make sure that you can make a passwordless + ssh connection to the remote machine and get kerberos 4 tickets. Then, click + on "Show more options", enable "Use tzc", and set the tzc command to + /path/to/ssh username@hostname /path/to/tzc -e "%s" + Alternately, if you have tzc working on your machine, you can enable "Use + tzc", and set the tzc command to + /path/to/tzc -e "%s" +------------------------------------------------------------------------------ -| 14. SILC Protocol +| 13. SILC Protocol +------------------------------------------------------------------------------ -14.1 What is SILC? +13.1 What is SILC? SILC is an open protocol designed from the ground up with security in mind. It is, or should be, the protocol of choice for the paranoid. See http:// www.silcnet.org for more details. +------------------------------------------------------------------------------ -| 15. Novell Protocol +| 14. Novell Protocol +------------------------------------------------------------------------------ -15.1 Are there any public servers for Novell? +14.1 Are there any public servers for Novell? Not really. This protocol is designed to connect to a Novell GroupWise server running on a corporate LAN. -15.2 I can't seem to get it to work. +14.2 I can't seem to get it to work. Novell tells us that this protocol plugin will only work with either the GroupWise Messenger for Linux server or the GroupWise Messenger SP2 (or @@ -995,34 +1165,40 @@ Gaim: The Pimpin' Penguin IM Clone Thats provided us. +------------------------------------------------------------------------------ -| 16. Scripts and Plugins +| 15. Scripts and Plugins +------------------------------------------------------------------------------ -16.1 How do I use perl scripts with Gaim? +15.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. -16.2 How do I compile a plugin for Gaim? +15.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. + untar it with the command: tar zxvf filename where filename is the file you + downloaded. 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. + 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: + 4. On Unix/Linux Type: + make name.so + + where the name of the file you wish to compile is name.c. + + On Win32 Type: + + make -f Makefile.mingw name.dll + 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 @@ -1033,16 +1209,18 @@ Gaim: The Pimpin' Penguin IM Clone Thats compiling it yourself, $prefix is /usr/local by default. Otherwise, $prefix is /usr. -16.3 I have a plugin or perl script for Gaim that does not work with 0.60 or - higher. +15.3 I have a plugin or perl script for Gaim that used to work, but does not + with the current version. - 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 + The plugin and perl script API has changed several times, 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/plugins/, and must - implement the new API, as documented in the HOWTO file in the plugins - directory. Plugins and perl scripts are now controlled from preferences. + implement the new API, as documented by the make docs command from the root + of the Gaim source code tree. This will generated html documentation in the + doc/html directory. Also note that plugins and perl scripts are now + controlled from preferences. -16.4 Where can I find documentation on writing plugins and Perl scripts? +15.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 with some details for C plugins. Also be sure to check out our @@ -1054,10 +1232,10 @@ Gaim: The Pimpin' Penguin IM Clone Thats make docs. You will need doxygen and graphviz dot installed for this to work. +------------------------------------------------------------------------------ -| 17. Development +| 16. Development +------------------------------------------------------------------------------ -17.1 Can I help? +16.1 Can I help? But of course. Just find something that's bugging you and fix it. There are a slew of a bug reports in Gaim's bug report tracker - you could pick one and @@ -1067,23 +1245,23 @@ Gaim: The Pimpin' Penguin IM Clone Thats you follow the same coding style used in Gaim, and make sure you don't break the core/UI split. -17.2 Gaim never leaves a core file. +16.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 + terminal before starting Gaim from that terminal. You can also run Gaim directly in gdb with gdb gaim. -17.3 Where should I report bugs? +16.3 Where should I report bugs? - http://gaim.sf.net/". + http://gaim.sf.net/bug.php. -17.4 Where should I submit patches? +16.4 Where should I submit patches? - http://gaim.sf.net/". + http://gaim.sf.net/patches.php. -17.5 Did you guys reverse engineer it? +16.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 @@ -1091,19 +1269,19 @@ Gaim: The Pimpin' Penguin IM Clone Thats was written by one of the protocol's developers. +------------------------------------------------------------------------------ -| 18. Misc. Questions +| 17. Misc. Questions +------------------------------------------------------------------------------ -18.1 Can I IM you guys? +17.1 Can I IM you guys? Sure! Look at the Contact Information (http://gaim.sf.net/contactinfo.php) page! -18.2 Hello? +17.2 Hello? We don't know how to answer this question. Stop asking it. -18.3 Can I give you money/hardware/other expensive things that can be hocked +17.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? @@ -1111,7 +1289,7 @@ Gaim: The Pimpin' Penguin IM Clone Thats strings attached for just being good guys. That and we'd have to share with everyone who has submitted patches. ;-) -18.4 Does Gaim support secure instant messaging (encrypted IMs)? +17.4 Does Gaim support secure instant messaging (encrypted IMs)? Short answer: Yes, use the SILC protocol. Long Answer(for other protocols): Not natively. Doing secure instant messaging right is a big deal and @@ -1127,19 +1305,19 @@ Gaim: The Pimpin' Penguin IM Clone Thats read the documentation on the "web of trust" model available at www.gnupg.org and try out one of these. -18.5 Why are the passwords in accounts.xml not encrypted? +17.5 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. + explanation at http://gaim.sf.net/plaintextpasswords.php. -18.6 What is gaim-remote? +17.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. -18.7 When will the next version of Gaim be released? +17.7 When will the next version of Gaim be released? The schedule for releases is every third Thursday. However, a new version will only be released if it meets a certain standard of quality (i.e., it @@ -1148,3 +1326,23 @@ Gaim: The Pimpin' Penguin IM Clone Thats lots of new bugs to work out. The new version will be released as soon as it is possible to do so. +17.8 What will the next version be? + + Starting with version 1.0.0, Gaim version numbers have 3 parts to them. The + format is major.minor.micro. If we change something internally in Gaim such + that some plugins won't work with the newer version, we will increment the + major version number. If we don't increment the major version number, and + we've added things to the Gaim API that won't break any older stuff, we will + increment the minor version number. In any other cases, we will increment the + micro version number. Even and odd numbers have nothing to do with stability, + and you should always be running the latest release of Gaim to get new + features and bug fixes. + +17.9 So, can I look forward to mega-sexy super functionality with Gaim? + + Yes, that is the intended idea. In fact, there have been quite a number of + unpopular geeks who have made the switch to gaim. In a matter of days, the + number of dates and awesomeness points received by the geek increased ten + fold! You, too, can have an exciting life with Gaim. Get Gaim. Get the babes. + Get uhh... hmm. + |