From: Mark D. <the...@us...> - 2003-03-14 15:34:52
|
Update of /cvsroot/gaim/web/htdocs In directory sc8-pr-cvs1:/tmp/cvs-serv26891/htdocs Modified Files: faq.txt Log Message: Let me know how this is. Good? Bad? Inaccurate? Reminds you of moth balls? We appreciate your patronage! I'm not going to run the update script yet. I'm sure it'll get run later tonight. Index: faq.txt =================================================================== RCS file: /cvsroot/gaim/web/htdocs/faq.txt,v retrieving revision 1.26 retrieving revision 1.27 diff -u -d -r1.26 -r1.27 --- faq.txt 2 Mar 2003 19:23:43 -0000 1.26 +++ faq.txt 14 Mar 2003 15:34:48 -0000 1.27 @@ -67,13 +67,11 @@ Q: I have a question about GTK2. -A: Our GTK2 port is in progress, the 0.59.x release series will be entirely Gtk1.2 and entirely devoid of new features. -0.60 will be the first release with Gtk2 supported, and will no longer have support for Gtk1.2. We are not sure when we will -be finished with this port, but if you want, you can use cvs to try it out. Nightly debs are at <a -href="http://people.debian.org/~robot101">http://people.debian.org/~robot101</a>, rpms and tarballs are provided intermittently -from the gaim home page. +A: All versions of Gaim 0.60 and higher are built for GTK2, while all earlier releases +are built for GTK1.2. The 0.59.x release series contains bug fixes only, and will be entirely +devoid of new features. -Q: I'd like to use gaim on IRIX. +Q: I'd like to use Gaim on IRIX. A: Please see <a href="http://sourceforge.net/forum/forum.php?thread_id=725839&forum_id=665">this thread</a> at our SourceForge Forum. @@ -90,22 +88,42 @@ <p><b>Gadu-Gadu:</b> Use the official client to create an account.</p> <p><b>Jabber:</b> See the question <a href="#jabber-register">How do I register a new Jabber account?</a> below.</p> -Q: Why is gaim crashing when somebody sends me an IM? +Q: Why don't sounds work for me? + +A: Gaim 0.60 and higher do not natively support esound or arts. Support for +playing sounds using these sound daemons is provided by libao. +<p> +<quote> +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). +</quote> +</p> +<p> +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." +</p> + +Q: Why is Gaim crashing when somebody sends me an IM? A: 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. <p> -If you use yahoo with Gaim 0.59.7 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 Yahoo with Gaim 0.59.7 or lower, you need to upgrade. Yahoo changed their protocol in a way that broke Gaim, Trillian, Everybuddy, and +their own Linux client. </p> <p> 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 be fixed in 0.59.6 for the rest of the world. </p> <p> - If you are using a version newer than 0.59.6 and gaim still crashes, please + If you are using a version newer than 0.59.6 and Gaim still crashes, please let us know. </p> @@ -113,21 +131,19 @@ Q: How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu(GG), Napster, or Zephyr? -A: First load the plugin. Protocol plugins come with Gaim, so just go to the +A: 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. +<p> +In Gaim 0.59 and lower, you must first load the protocol plugin for 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 <code>lib<i>protocol</i>.so</code>, so MSN for instance is provided by <code>libmsn.so</code>, and Gadu-Gadu is provided by -<code>libgg.so</code>. -<p> - After you have loaded the appropriate plugin, use the - Account Editor (Tools->Accounts, or the Accounts button on the - start screen) to add the account. -</p> -<p> -In 0.60 and later, loading the plugin is not necessary, as protocols are automatically -loaded as needed, just select the correct protocol. +<code>libgg.so</code>. Now you can use the Account Editor to add an account with +the desired protocol. </p> Q: Can Gaim send files? @@ -137,79 +153,81 @@ Q: When will file transfer be supported? Is it being worked on? -A: File transfer is currently being worked on in CVS. It will be released -when it is ready, and no sooner. Do not ask for a more precise timeline. Currently -it is only being worked on for AIM, MSN, Jabber and IRC. Get CVS and submit a patch using the -generic file transfer api in Gaim if you would like it for another protocol. +A: 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 MSN, Jabber, and IRC. If you would +like support for another protocol, get CVS and submit a patch using the +generic file transfer API. Q: How come there's no Export Buddy List? -A: It would be the same as the <code>cp</code> command. -Gaim stores your buddy list in the <code>$HOME/.gaim</code> -directory. You can copy it out of there. +A: In 0.59 and earlier you can use <code>cp</code> to copy your buddy list. +It is stored in the <code>$HOME/.gaim</code> directory. The file name is your +screen name, in all capital letters. Gaim 0.60 does not support exporting your +buddy list. Q: Will Gaim save my buddy list to the server? -A: Gaim already does this in MSN, Yahoo, and TOC. As of version 0.53, -this support exists for AIM via Oscar as well. ICQ and improved Jabber support is being -worked on. +A: 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 does not support this for ICQ. Q: Can Gaim import my buddy list? -A: This depends on the format of the buddy list. Gaim cannot import -<a href="http://www.licq.org/">Licq</a> -contact lists. Gaim has mixed success importing Windows AIM buddy lists. If -you want to try, click File->Import. This is accessible after you sign on. - -Q: Can I set a buddy icon? - -A: Yes. Go to the Account Editor (Tools->Accounts from the buddy list), -and click to "Modify" the Oscar account you wish to have an icon. Type the -full path to the image you wish to use in the box labeled "Buddy Icon File." -The file must be below 4KB. It can have any dimensions, and can be in any -format. However, if you wish Windows users to see it, it must be in a format -Windows understands, such as .bmp, .gif, and .jpg. +A: 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. You can try using the +<code>licq2gaim.pl</code> perl script, which comes with the Gaim source code +to import <a href="http://licq.org/">Licq</a> contact lists, but we do not support +this. Q: What do those colors in the conversation tab mean? -A: A red tab means a message is waiting for you; green means the +A: 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. + !SECTION ICQ Protocol Q: How do I use ICQ? -A: ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in gaim +A: ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim (see the question <a href="#icq-no-worky">ICQ doesn't work</a> 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 alone. +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). !ANCHOR icq-no-worky Q: ICQ doesn't work. A: 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 +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. !SECTION AIM/ICQ (Oscar) Protocol +Q: Can I set a buddy icon? + +A: 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." +The file must be below 4KB. It can have any dimensions, and can be in any +format. However, if you wish Windows users to see it, it must be in a format +Windows understands, such as .bmp, .gif, and .jpg. + Q: Some of my buddies are not showing up as online, why is that? -A: -<p> - AOL has set a limit for the maximum number of people you can - have in your buddy list. This number is currently 400. Gaim 0.58 gives 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 +A: AOL has set a limit for the maximum number of people you can +have in your buddy list. This number is currently 400. 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!). -</p> <p> 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 + especially group names. While this corruption doesn't show in Gaim unless you remove the <code>SCREENNAME.0.blist</code> file from <code>~/.gaim</code>, it does affect how long the server thinks your list is. The best way to fix this, is to: @@ -220,30 +238,31 @@ signon, delete all groups, signoff, and signon again to verify that your list is empty. Once it is empty, signoff, mv your <code>SCREENNAME.0.blist</code> file back into <code>~/.gaim</code>, then - sign on again. + sign on again. This should not be necessary in Gaim 0.60 and higher. </p> Q: IM Image doesn't work, why? A: 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 +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. <p> 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. +many features of the old widget we used with GTK1.2, including images. </p> Q: I sent an IM Image, but only a blank line shows up, why? -A: You need to have gdk-pixbuf installed to send IM Images, if the -receiver is also using gaim, [s]he also needs to have this installed. +A: 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. Q: Can I add SMS numbers to my buddy list? -A: Yes, with gaim 0.60 and higher you can add SMS numbers to your buddy list the +A: Yes, with Gaim 0.60 and higher you can add SMS numbers to your buddy list the same way you can add screen names. Use "+19195151234" as the screen name, where 1 is the country code, 919 is the area code, and 515-1234 is the phone number. This is currently only supported for US phones. This works for both AIM and ICQ accounts. @@ -264,6 +283,7 @@ or a chat, in which your IRC user is the sender, you can also use <code>/join</code> to connect to a new channel. + !SECTION Jabber Protocol Q: How do I choose which Jabber server to use? @@ -370,18 +390,21 @@ 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. + !SECTION Gadu-Gadu Protocol Q: What is Gadu-Gadu? A: Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at <a href="http://www.gadu-gadu.pl">http://www.gadu-gadu.pl</a> (website in Polish). + !SECTION Scripts and Plugins -Q: Where can I find documentation on writing plugins and Perl scripts? +Q: How do I use perl scripts with Gaim? -A: If you look in the <code>plugins/</code> directory in the Gaim source, you -should see a HOWTO file for C plugins and a PERL-HOWTO for Perl scripts. +A: 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. Q: How do I compile a plugin for Gaim? @@ -432,10 +455,19 @@ </li> </ol> -Q: I had a plugin for gaim that does not work with 0.60 or higher. +Q: I have a plugin or perl script for Gaim that does not work with 0.60 or higher. + +A: The plugin and perl script API has change 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. + +Q: Where can I find documentation on writing plugins and Perl scripts? + +A: If you look in the <code>plugins/</code> directory in the Gaim source, you +should see a HOWTO file for C plugins and a PERL-HOWTO for Perl scripts. -A: The api has changed, plugins 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. !SECTION Development @@ -459,16 +491,19 @@ most buggy type of release a project can make. For some people it works very reliably, for others it is unusable. -Q: Where is the gnome-applet in the gtk2 version of Gaim? How do I put Gaim in my Panel, or dock Gaim in KDE or any other windowmanager? +Q: Where is the gnome-applet in the GTK2 version of Gaim? How do I put Gaim in my Panel, or dock Gaim in KDE or any other windowmanager? -A: In 0.59.x and below, Gaim only has support for Gnome's panel. Once 0.60 is released -Gaim will have replaced the gnome-applet with a tray icon that conforms to the standards at -<a href="http://www.freedesktop.org/">www.freedesktop.org</a>. KDE supports this in the current cvs -(what will be the 3.1 release), as does Gnome in its cvs. Gaim will insert the tray icon in any System Tray +A: 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 +<a href="http://www.freedesktop.org/">www.freedesktop.org</a>. 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 System Tray implementation that conforms to these standards, so feel free to 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 +of choice. For Gnome, you must have a Notification Area in your Gnome panel. +<p> +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 gnome 1.x, the gtk1.2 versions of gnome. +with Gaim 0.59.x and Gnome 1.x, the GTK1.2 versions of Gnome. +</p> !SECTION Misc. Questions @@ -494,7 +529,7 @@ strings attached for just being good guys. That and we'd have to share with everyone who has submitted patches. ;-) -Q: Does gaim support secure instant messaging (encrypted IMs)? +Q: Does Gaim support secure instant messaging (encrypted IMs)? A: Not natively. Doing secure instant messaging right is a big deal and requires, among other things, an authentication scheme. Simply @@ -510,7 +545,7 @@ Q: What is gaim-remote? -A: gaim-remote is a second executable included with gaim starting +A: 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 +an existing Gaim process from the command line. Run gaim-remote --help to get an idea of what we currently envision it doing. |