gaim/www

as discussed on gaim-devel

2005-12-20, Luke Schierer
0dca992e9b5d
Parents e8794afb4cea
Children 429aaebfcb69
as discussed on gaim-devel
3 files changed, 1528 insertions(+), 28 deletions(-)
  • +18 -28
    htdocs/faq.txt
  • +158 -0
    htdocs/faq2.php
  • +1352 -0
    htdocs/faq2.txt
    • --- a/htdocs/faq.txt Tue Dec 20 15:15:57 2005 -0500
    +++ b/htdocs/faq.txt Tue Dec 20 20:11:55 2005 -0500
    @@ -255,9 +255,10 @@
    Q: How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other protocol?
    -A: Use the Account Editor (Accounts->Add/Edit) to add the account of
    +A: Use the Account Editor (Tools->Accounts, or
    +the Accounts button on the start screen) to add the account of
    the appropriate messaging service. Use the checkbox in the
    -account editor to enable the account.
    +account editor to sign online.
    Q: How do I use Google Talk?
    @@ -283,32 +284,21 @@
    <a href="http://themes.freshmeat.net/">themes.freshmeat.net</a>,
    <a href="http://art.gnome.org/">art.gnome.org</a>, or searching on Google.
    </p>
    +<p>
    +If you're having a problem with the font size used by a specific person,
    +you can try turning on the Ignore Font Sizes preference in
    +Preferences-&gt;Message Text.
    +</p>
    <p>Similarly, the other font preferences are the defaults for outgoing
    messages, and gaim's global settings are controled by the gtk theme.
    Additionally, some settings to specific parts of gaim can be set by a Gtk+
    theme.</p>
    -Q: Where did my ability to use Ctrl-Enter to send a message go?
    +Q: How do I make gaim use emacs-like keybindings?
    -A: Gaim used to have an option in the preferences window which let you
    -choose whether to use Enter or Ctrl-Enter to send a message. This was less than
    -optimal for many reasons, not least of which was because it only let you
    -choose between those two options. It also caused large problems for people
    -who required an alternate input method (people who were typing in Chinese or
    -Japanese for example). On top of all this gtk provides an incredibly nice
    -mechanisms which allows keybindings to be set for things via the gtk theme
    -files. Gaim decided to use this gtk interface as a method of allowing
    -people to use Ctrl-Enter to send but to also allow people to use anything else
    -they felt like and to reduce the clutter in the User Interface. The gtk
    -interface is, unfortunately, not as immediately obvious as a simple checkbox,
    -however it is still simple. The example gtkrc file seen <a href="./gtkrc-2.0">here</a>
    -shows you how to do it (among other things).
    -
    -Q: How do I make gaim use emacs-like keybindings, or assign a custom
    -hotkey?
    -
    -A: You need to edit your <code>~/.gtkrc-2.0</code> to contain the appropriate line from <a href="./gtkrc-2.0">this example file</a>. If you are using <code>gtk-can-change-accels = 1</code>, then you hover over the menu item then press your desired key stroke.
    +A: You need to edit your <code>~/.gtkrc-2.0</code> to contain the keybindings line from
    +<a href="./gtkrc-2.0">this example file</a>.
    Q: How do I use smiley themes?
    @@ -439,7 +429,7 @@
    A: 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 mimicked by gaim for MSN and Jabber.
    +of the others, and is mimiced by gaim for MSN and Jabber.
    Q: Can I use Gaim for e-mail, blogging, an RSS feed, or something else
    that isn't IM-related?
    @@ -591,12 +581,12 @@
    Q: Can I set a buddy icon?
    -A: Yes. Go to the Account Menu, 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 smaller than 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: Yes. Go to the Account Editor (Tools-&gt;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 smaller than 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: I just changed my buddy icon, and I can't see the new one.
    --- /dev/null Thu Jan 01 00:00:00 1970 +0000
    +++ b/htdocs/faq2.php Tue Dec 20 20:11:55 2005 -0500
    @@ -0,0 +1,158 @@
    +<?
    + $page->title = 'FAQ';
    + require('template.inc.php');
    +
    + require_once('faq-functions.inc.php');
    +?>
    +
    +<h1>Frequently Asked Questions</h1>
    +<p><i>Frequently asked questions specific to Windows have their own <a href="/win32">FAQ</a>.</i></p>
    +<?
    + /* The Q&A begins here */
    + $faq = file("./faq2.txt");
    + $faq_lines = count($faq);
    + $sections = array();
    +
    + $qa = 1;
    + $in_section = 0;
    + $in_question = 0;
    +
    + /* Loop through once to get all the questions. */
    + for ($i = 0; $i < $faq_lines; $i++)
    + {
    + $line = $faq[$i];
    +
    + if ($line == "" || $line == "\n" || substr($line, 0,3) == "A:\t")
    + {
    + if ($in_question)
    + {
    + print "</a></li>\n";
    + $in_question = 0;
    + }
    +
    + continue;
    + }
    + elseif (substr($line, 0, 3) == "Q:\t")
    + {
    + if ($in_question)
    + {
    + print "</a></li>\n";
    + $in_question = 0;
    + }
    +
    + $question = substr($line, 3);
    + $question = preg_replace(
    + "/(<\/?(br|code|pre|div)( ?\/)?>|[\r\n\t])/", " ", $question);
    +
    + print " <li><a href=\"#q" . $qa . "\">";
    + print $question;
    +
    + $in_question = 1;
    +
    + $qa++;
    + }
    + elseif (substr($line, 0, 9) == "!SECTION\t")
    + {
    + if ($in_question)
    + {
    + print "</a></li>\n";
    + $in_question = 0;
    + }
    +
    + if ($in_section)
    + print "</ul>\n";
    +
    + print "<b>" . trim(substr($line, 9)) . "</b>\n";
    + print "<ul>\n";
    +
    + $in_section = 1;
    + }
    + elseif (substr($line, 0, 9) == "!COMMENT\t")
    + {
    + }
    + elseif ($in_question)
    + {
    + print preg_replace(
    + "/(<\/?(br|code|pre|div)( ?\/)?>|[\r\n\t])/", " ", $line);
    + }
    + }
    +
    + if ($in_question == 1)
    + {
    + print "</a></li>\n";
    + }
    +
    + if ($in_section == 1)
    + {
    + print "</ul>\n";
    + }
    +
    + /* Now we'll loop through again to print out the questions and answers. */
    + $qa = 1;
    + $in_section = 0;
    + $in_question = 0;
    + $in_answer = 0;
    + $anchor = "";
    +
    + for ($i = 0; $i < $faq_lines; $i++)
    + {
    + $line = $faq[$i];
    +
    + if (substr($line, 0, 3) == "Q:\t")
    + {
    + check_in_qa();
    +
    + start_q();
    + print substr($line, 3);
    +
    + $qa++;
    +
    + $in_question = 1;
    + }
    + elseif (substr($line, 0, 3) == "A:\t")
    + {
    + check_in_qa();
    +
    + start_a();
    + print substr($line, 3);
    +
    + $in_answer = 1;
    + }
    + elseif (substr($line, 0, 9) == "!SECTION\t")
    + {
    + check_in_qa();
    +
    + if ($in_section == 1)
    + {
    + print "</dl>\n";
    + }
    +
    + $name = trim(substr($line, 9));
    +
    + print "<a name=\"" . build_section_name($name) . "\"></a>\n";
    + print "<h2>$name</h2>";
    + print "<dl class=\"faq\">\n";
    +
    + $in_section = 1;
    + }
    + elseif (substr($line, 0, 8) == "!ANCHOR\t")
    + {
    + $anchor = trim(substr($line, 8));
    + }
    + elseif (substr($line, 0, 9) == "!COMMENT\t")
    + {
    + }
    + elseif ($in_question || $in_answer)
    + {
    + print $line;
    + }
    + }
    +
    + check_in_qa();
    +
    + if ($in_section == 1)
    + {
    + print "</dl>\n";
    + }
    +
    +?>
    --- /dev/null Thu Jan 01 00:00:00 1970 +0000
    +++ b/htdocs/faq2.txt Tue Dec 20 20:11:55 2005 -0500
    @@ -0,0 +1,1352 @@
    +!SECTION Compiling and Installing
    +
    +Q: What does "Gaim" stand for?
    +
    +A: For freedom! No, seriously, it doesn't stand for anything. It's
    +our name and we're sticking to it. The two acceptable forms of
    +capitalization are "Gaim" and "gaim" (and <i>not</i> "GAIM").
    +
    +Q: Why can't I compile Gaim?
    +
    +A: 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.
    +<p>
    + If you have Slackware &lt; 9.1, you need to get non-slack packages for autoconf,
    + automake, gettext, and libtool. You also have to copy the contents of
    + <code>/usr/local/share/aclocal</code> to <code>/usr/share/aclocal</code>. This is due to bugs in
    + Slackware and the auto* packages.
    +</p>
    +<p>
    +*BSD users may also have problems with libtool and will also have to remove
    +the <code>--no-verify</code> from the configure script.
    +</p>
    +<p>
    + Having problems getting SSL and MSN working? See
    +<a href="./faq-ssl.php">these notes</a> for distribution specific hints.
    +</p>
    +
    +Q: I'm trying to install Gaim, but it complains that I don't have
    +<code>libgtkspell.so.0</code>, from where can I get this?
    +
    +A: <code>libtgtkspell.so.0</code> 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 <a href="http://freshrpms.net/">freshrpms.net</a>. You
    +can find the source and a non-Red Hat specific RPM at <a
    +href="http://gtkspell.sourceforge.net/">gtkspell.sourceforge.net</a>.
    +
    +Q: What do I need to use the SILC protocol?
    +
    +A: You need to install the
    +<a href="http://silcnet.org/software/download/toolkit/">SILC toolkit</a>
    +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 <code>./configure --help</code> for specifying the SILC includes and libs.
    +If you're compiling an SRPM, use <code>--with silc</code> to build the gaim-silc RPM.
    +<p>
    + In Windows, the SILC toolkit is installed with Gaim.
    +</p>
    +<p>
    + Some distributions provide the SILC toolkit and include Gaim's
    + SILC plugin in their Gaim package.
    +</p>
    +
    +Q: Is there some way I can compile just Gaim, without all of these protocols?
    +
    +A: Yeah. There are actually three ways to do it.
    +<ol>
    + <li>
    + <p>
    + Use the <code>--with-static-prpls</code> option to <code>./configure</code> along with
    + <code>--disable-plugins</code>. This will let you choose which protocols are compiled in
    + with Gaim, but you will not be able to use any other protocols or plugins.
    + </p>
    + <p>
    + You'll need to compile any protocols that you specified in
    + <code>--with-static-prpls</code>. Oscar is the default.
    + </p>
    + </li>
    + <li>
    + <p>
    + Use the <code>--with-dynamic-prpls</code> option to
    + <code>./configure</code>
    + </p>
    + </li>
    + <li>
    + <p>
    + Change to the directories for the protocols you
    + want to compile (e.g. <code>src/protocols/jabber</code>), and
    + run <code>make</code> from there. Then after you've compiled all of
    + them, change back to <code>src/</code> and run <code>make gaim</code>.
    + </p>
    + </li>
    +</ol>
    +
    +Q: I installed a new version of Gaim, but the about window says I'm
    +still using the old version.
    +
    +A: If you compiled yourself, and you previously had an RPM or a
    +Debian package installed, you need to remove that first.
    +<code>rpm -e gaim</code> or <code>dpkg -p gaim</code> should work.
    +<p>
    + Likewise, if you want to use an RPM or deb and you have previously
    + compiled Gaim from source, you need to <code>make uninstall</code> to
    + remove all Gaim files from <code>/usr/local</code>.
    +</p>
    +
    +Q: Are the packages signed? If so, by who, and how can I get the key?
    +
    +A: Yes, all packages are signed. The signature for the
    +tarball and bzip2 archive are provided by separate downloads. The RPMs
    +we provide are signed by either Ethan Blanton, Mark Doliner, or Stu
    +Tomlinson. Usually the Mandrake RPMs are signed by, Mark Doliner, the
    +Fedora Core RPMs are signed by Stu Tomlinson, and the Red Hat 8 and 9 RPMs
    +are signed by Ethan Blanton.
    +The keys can be obtained from any key server.
    +<a href="http://pgp.mit.edu/">http://pgp.mit.edu/</a> is popular.
    +
    +!ANCHOR gtk1.2
    +Q: Can I use Gaim for GTK+ 1.2?
    +
    +A: 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.9, which is the last version of
    +Gaim that used GTK+1.2. We should warn you though, this version of
    +Gaim hasn't had any new features since the middle of 2002, and
    +some protocols likely do not work. Also, the 0.59.x releases
    +aren't breathtakingly beautiful.
    +
    +Q: Can I run Gaim on IRIX?
    +
    +A: It has been done before. Please see
    +<a href="http://sourceforge.net/forum/forum.php?thread_id=725839&amp;forum_id=665">this thread</a>
    +at our SourceForge Forum.
    +
    +Q: Can I run Gaim on MacOSX?
    +
    +A: Yes you can, but we do not provide a package for it. The reason
    +being that in order 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 <a href="http://fink.sf.net">http://fink.sf.net</a>. If you
    +would like a native aqua interface or a user-friendly installer, we
    +suggest trying <a href="http://www.adiumx.com/">Adium</a>.
    +
    +Q: How do I apply the patch "something.diff"?
    +
    +A: Type <code>patch -p0 &lt; something.diff</code> from inside the Gaim
    +directory. If that doesn't work, try <code>patch -p1 &lt; something.diff</code>.
    +
    +!ANCHOR crash-on-start
    +Q: Why is Gaim crashing when I start it?
    +
    +A: First of all make sure you are using the most recent version of Gaim.
    +If you still have problems, try the following:
    +<ul>
    + <li>
    + Make sure only one version of Gaim is installed. "whereis gaim"
    + can sometimes be useful for determining this.
    + </li>
    + <li>
    + "export GDK_USE_XFT=0" in a terminal and then run Gaim from the same
    + terminal.
    + </li>
    + <li>
    + 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.
    + </li>
    + <li>
    + Try disabling or deleting any 3rd party plugins, especially anything
    + related to encryption.
    + </li>
    + <li>If you use 0.75 or higher on win32, try deleting <code>tcl.dll</code>.</li>
    + <li>If you have ever installed 0.65, edit your <code>~/.gaimrc</code>, changing your auto away
    + preference from -1 to 0.</li>
    +</ul>
    +
    +!ANCHOR cvs
    +Q: Gaim &lt;non-current version&gt; is buggy. Gaim CVS is buggy. Why?
    +
    +A: 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.
    +
    +Q: Why do you always say not to use CVS?
    +
    +A: 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 are in a transitory state or which are not
    +yet well understood. These bad behaviors range from the harmless
    +(maybe a graphical glitch in a dialog box) to the irritating (a
    +particular protocol may not work), to the downright damaging (recently
    +a bug in CVS destroyed the user's buddy lists). While behaviors like
    +this are acceptable to some users (particularly developers, who are
    +used to such things), they tend to cause many Gaim CVS users to
    +contact Gaim developers and report the same (usually egregious) bug
    +over and over - using time which could be better spent fixing the
    +bugs.
    +<p>
    +A second major point involves public resources - a CVS checkout is not
    +a cheap operation. As many Sourceforge users are aware, at various
    +points in the recent past Sourceforge CVS has been less than pleasant
    +to work with. This is, of course, because Sourceforge hosts dozens
    +and dozens of useful and active projects which use CVS as a primary
    +method of source code collaboration. Unfortunately, when too many
    +users are poking around in that CVS just for the sake of poking
    +around, it prevents other users who are trying to do work to improve
    +those very same projects from accomplishing their tasks. It is better
    +for the community if an enterprising individual wishing to fix a
    +particular bug she has seen can get to the code and create a patch,
    +even if this means that some users have to wait a few weeks for the
    +next release to see what new features it might hold.
    +</p>
    +<p>
    +The third point is not a problem which has yet come up, but it is in
    +the back of the mind of the developers who bring you Gaim. As a
    +third-party IM client, Gaim is not a priority (and indeed may be an
    +irritant) for the IM service providers. We do our best to keep Gaim
    +playing nice and being friendly on the IM networks it uses; however,
    +at times there are bugs in the protocol support. If a few dozen
    +people are using this buggy client, the IM providers are not likely to
    +go out of their way to do anything about it. However, if hundreds of
    +people are pointing an ill-behaved client at an IM server, the server
    +administrators may be forced to take action. (This is particularly
    +likely if the buggy behavior is damaging in some way.) Gaim releases
    +represent code which the Gaim developers feel is relatively
    +well-behaved and stable. This includes not only the interface seen by
    +Gaim users, but the traffic seen by IM service providers. Gaim CVS
    +bears no such guarantees.
    +</p>
    +<p>
    +In short, there are a lot of good reasons to <i>not</i> use
    +Gaim CVS if one does not wish to develop Gaim, Gaim plugins, or a
    +codebase which interacts with Gaim in some intimate way. There are,
    +however, only a few reasons <i>to</i> use Gaim CVS outside of the
    +above. Please weigh these things carefully and decide whether you
    +wish to use Gaim CVS for a good reason which furthers the community, or
    +for selfish reasons which are not entirely important.
    +</p>
    +
    +!SECTION Using Gaim
    +
    +Q: How do I register for a new account?
    +
    +A: This depends on the protocol.
    +<p><b>AIM:</b> Go to <a href="http://my.screenname.aol.com/_cqr/login/login.psp?siteId=snshomepage&amp;authLev=1&amp;mcState=initialized&amp;createSn=1">this website</a>.</p>
    +<p><b>MSN</b> (including Hotmail email)<b>:</b> Go to <a href="http://registernet.passport.com/">http://registernet.passport.com/</a>.</p>
    +<p><b>MSN</b> (using your own email address)<b>:</b> Go to
    +<a href="http://register.passport.net/">http://register.passport.net/</a>.</p>
    +<p><b>Yahoo:</b> Go to <a href="http://edit.yahoo.com/config/eval_register">http://edit.yahoo.com/config/eval_register</a>.</p>
    +<p><b>Jabber:</b> See the question <a href="#jabber-register">How do I register a new Jabber account?</a> below.</p>
    +<p><b>ICQ:</b> Go to <a href="http://web.icq.com/register">http://web.icq.com/register</a>.</p>
    +<p><b>Gadu-Gadu:</b> Use the official client to create an account.</p>
    +<p><b>Novell:</b> See your Novell server administrator.</p>
    +
    +Q: How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other protocol?
    +
    +A: Use the Account Editor (Accounts-&gt;Add/Edit) to add the account of
    +the appropriate messaging service. Use the checkbox in the
    +account editor to enable the account.
    +
    +Q: How do I use Google Talk?
    +
    +A: Create a Jabber account as per <a
    +href="http://www.google.com/support/talk/bin/answer.py?answer=24073">Google's
    +FAQ</a>. The Audio component is not currently supported and will not be
    +until 1)the protocol is published and 2)<a href="http://gaim-vv.sf.net">Gaim-vv</a> is ready for
    +mainstream use.
    +
    +Q: How do I change the font Gaim uses? The empty left padding? The
    +background color?
    +
    +A: The font preference in Gaim is used only for the formatting of outgoing
    +messages. The display fonts used by the rest of Gaim are those specified
    +by GTK+. To change this font you need to edit your <code>~/.gtkrc-2.0</code> file.
    +If you need help you can see our example <a href="./gtkrc-2.0"><code>.gtkrc-2.0</code></a>
    +file. On Windows, this file is located at <code>C:\Documents and
    +Settings\username\.themes\Default\gtk-2.0\gtkrc</code>. If the file does
    +not exist, create it.
    +<p>
    +You can also just switch to a different GTK+ theme. You can find GTK+ themes
    +(and information on using them) by visiting
    +<a href="http://themes.freshmeat.net/">themes.freshmeat.net</a>,
    +<a href="http://art.gnome.org/">art.gnome.org</a>, or searching on Google.
    +</p>
    +
    +<p>Similarly, the other font preferences are the defaults for outgoing
    +messages, and gaim's global settings are controled by the gtk theme.
    +Additionally, some settings to specific parts of gaim can be set by a Gtk+
    +theme.</p>
    +
    +Q: Where did my ability to use Ctrl-Enter to send a message go?
    +
    +A: Gaim used to have an option in the preferences window which let you
    +choose whether to use Enter or Ctrl-Enter to send a message. This was less than
    +optimal for many reasons, not least of which was because it only let you
    +choose between those two options. It also caused large problems for people
    +who required an alternate input method (people who were typing in Chinese or
    +Japanese for example). On top of all this gtk provides an incredibly nice
    +mechanisms which allows keybindings to be set for things via the gtk theme
    +files. Gaim decided to use this gtk interface as a method of allowing
    +people to use Ctrl-Enter to send but to also allow people to use anything else
    +they felt like and to reduce the clutter in the User Interface. The gtk
    +interface is, unfortunately, not as immediately obvious as a simple checkbox,
    +however it is still simple. The example gtkrc file seen <a href="./gtkrc-2.0">here</a>
    +shows you how to do it (among other things).
    +
    +Q: How do I make gaim use emacs-like keybindings, or assign a custom
    +hotkey?
    +
    +A: You need to edit your <code>~/.gtkrc-2.0</code> to contain the appropriate line from <a href="./gtkrc-2.0">this example file</a>. If you are using <code>gtk-can-change-accels = 1</code>, then you hover over the menu item then press your desired key stroke.
    +
    +Q: How do I use smiley themes?
    +
    +A: 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 <a
    +href="http://sourceforge.net/tracker/?atid=746976&group_id=235&func=browse">Gaim Smiley Themes</a> tracker.
    +<p>
    + You can also install themes manually by uncompressing them to their own
    + directory in ~/.gaim/smileys/
    +</p>
    +
    +Q: Why are the status icons so big?
    +
    +A: 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 concisely and attractively. It shows more than one status
    +"emblem" for each buddy, indicating at the same time a mobile user who is
    +away. Most importantly, it puts the buddy icon in the list, making it far
    +easier to locate buddies within a large list where names are harder to pick
    +out than images. Due to the increased usability of this interface, we
    +have made it the default.
    +<p>
    + We are aware that some people feel more comfortable using an interface
    + more 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.
    +</p>
    +
    +Q: Why do the emblems move around the status icon?
    +
    +A: 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.
    +
    +Q: How do I get sound to work correctly?
    +
    +A: Gaim uses libao to play sounds. Playing sounds
    +directly through esound or arts is no longer supported.
    +<p>
    + <q>
    + 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).
    + </q>
    +</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 <code>Command</code> and use <code>esdplay %s</code>
    + or <code>artsplay %s</code>.
    +</p>
    +
    +Q: How do I make Gaim use ALSA or OSS for playing sounds? What does the
    +"Automatic" option do?
    +
    +A: 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.
    +<p>
    + If you choose "Automatic", you can create a file, either
    + <code>/etc/libao.conf</code> or <code>~/.libao</code>, and put <b>one</b> of the following lines
    + in it:
    +</p>
    +<pre><code>default_driver=alsa
    +default_driver=oss</code></pre>
    +<p>
    + Other drivers, like alsa09, arts, esd, irix, macosx, nas, and sun might
    + also be supported, depending on your platform and how libao was compiled.
    + See also <code>man 5 libao.conf</code>.
    +</p>
    +
    +Q: Why does Gaim use the same <code>WM_CLASS</code> for every window? It makes it
    +impossible to control window size and placement for the buddy list separately
    +from the conversations.
    +
    +A: Both strings in the <code>WM_CLASS</code> 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 <code>WM_CLASS</code> and
    +<code>WM_NAME</code> properties, then it should provide a <code>WM_WINDOW_ROLE</code> property."
    +<p>
    + Gtk+ sets these <code>WM_CLASS</code> values for us so that they are unique for Gaim
    + instances, and the documentation for the <code>gtk_window_set_wmclass</code> function
    + says explicitly not to use it for anything else. Gaim uses the
    + <code>WM_WINDOW_ROLE</code> hint to differentiate windows. If your window manager
    + is having problems differentiating between Gaim windows, please ensure
    + that it uses the <code>WM_WINDOW_ROLE</code> hint per the ICCCM.
    +</p>
    +
    +Q: I blocked someone accidentally, how can I unblock them?
    +
    +A: See the "Privacy" option under the "Tools" menu of the Buddy List.
    +
    +Q: What is a "Buddy Pounce"?
    +
    +A: 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 buddy pounce is much like a macro, or a recorded action. When you set a
    +pounce on someone, you choose from a number of events, such as sign on or
    +someone going away, and then you choose from a number of actions. These
    +actions include everything from playing a sound (like an Alert would do) to
    +sending a message to the person, to executing a command. This action will
    +occur the next time gaim detects the event, ie the next time the person in
    +your buddy list who you have pounced signs on.
    +
    +Q: Where does gaim store its logs?
    +
    +A: On unix, they are in <code>~/.gaim/logs</code>, on win32 they are in the
    +<code>C:\Documents and Settings\user\Application Data\.gaim\logs</code>
    +directory. (NOTE: <code>Application Data</code> is a hidden directory.) In
    +either case, new logs (new as of 0.73) are in subdirectories that correspond to
    +protocol/yourscreenname/theirscreenname.
    +
    +Q: How can I see my own status with Gaim?
    +
    +A: 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 mimicked by gaim for MSN and Jabber.
    +
    +Q: Can I use Gaim for e-mail, blogging, an RSS feed, or something else
    +that isn't IM-related?
    +
    +A: 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 undoubtedly do a better job.
    +
    +!SECTION Features
    +
    +Q: Does Gaim support file transfer?
    +
    +A: Somewhat, yeah. As of 1.2.1 The following is supported:
    +
    +<ul>
    +<li>Sending and receiving files on AIM (although it might be a bit
    +buggy)</li>
    +<li>Sending and receiving files on IRC</li>
    +<li>Sending and receiving files on Jabber</li>
    +<li>Sending and receiving files on MSN</li>
    +<li>Sending and receiving files on SILC</li>
    +<li>Sending and receiving files on Yahoo when not using an HTTP proxy (sending is
    +limited to an unknown file size)</li>
    +</ul>
    +<p>
    + 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.
    +</p>
    +
    +Q: Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon,
    +or <i>some</i>thing?
    +
    +A: Yeah, Gaim supports what is called a system tray icon that conforms to
    +the standards at
    +<a href="http://www.freedesktop.org/">www.freedesktop.org</a>.
    +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.
    +<p>
    + 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-&gt;Utility-&gt;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.
    +</p>
    +<p>
    + Due to a flaw in these specs, KDE users may experience trouble with the
    + background color of the docklet. There is unfortunately nothing we can
    + do about this.
    +</p>
    +
    +Q: What do those colors in the conversation tab mean?
    +
    +A: <ul>
    +<li><b>Red</b> - A message is waiting for you</li>
    +<li><b>Blue</b> - Someone sent a message containing your name</li>
    +<li><b>Green</b> - The buddy is typing</li>
    +<li><b>Yellow</b> - The buddy began typing, and then stopped</li>
    +<li><b>Gray</b> - There has been a join or a part in that chat,
    +or the buddy has signed off</li>
    +</ul>
    +
    +Q: Will Gaim save my buddy list to the server?
    +
    +A: Yes, Gaim saves your buddy list to the server for AIM, ICQ, Jabber,
    +MSN, Novell and Yahoo!.
    +
    +Q: Can I import or export my buddy list?
    +
    +A: 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.
    +
    +Q: Does Gaim support animated smileys?
    +
    +A: Yes, as of version 0.70 Gaim supports animated smileys.
    +
    +Q: Can I make Gaim group screen names by the person that owns them? You
    +know, like Trillian's Meta Contacts?
    +
    +A: 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.
    +<p>
    + You may need to turn off the preference option to automatically expand
    + Contacts in order to be able to edit an existing Contact.
    +</p>
    +
    +Q: How do I get the old logging back?
    +
    +A: 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.
    +
    +Q: How can I convert my old logs to the new format?
    +
    +A: 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).
    +<p>
    +It shouldn't be too difficult to do a rough conversion using a
    +small script, or using the <code>old_logger_*</code> functions in gaim itself.
    +</p>
    +<p>
    +Peter Johnson has written a python script to do just this, it is available
    +on <a href="http://tam.hiddenrock.com/projects/scripts/">his
    +website</a> (at the bottom).
    +</p>
    +
    +
    +
    +!SECTION AIM/ICQ (OSCAR) Protocol
    +
    +Q: How do I use ICQ?
    +
    +A: ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim.
    +To use it, simply put your account number in the "Screen Name" box and your
    +password in the "Password" box. Leave the server settings set to the default
    +(login.oscar.aol.com and port 5190).
    +
    +Q: Can I set my profile?
    +
    +A: In AIM, yes, you can. Go to Tools-&gt;Account Actions<br/>
    +In ICQ, this is not yet supported. Patches are welcome.
    +
    +Q: Can I set a status message?
    +
    +A: In AIM, yes, you can. In 1.x, go to Tools-&gt;Away and select either
    +an existing one or the option to create a new one. Statuses themselves are
    +supported for ICQ, but Status messages are not.
    +
    +Q: Does Gaim support available messages?
    +
    +A: See the above question, with the caveat that the UI for this is
    +somewhat different, it is from the account actions menu. This UI will
    +improve with gaim 2.0.0.
    +
    +Q: Can I set a buddy icon?
    +
    +A: Yes. Go to the Account Menu, 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 smaller than 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: I just changed my buddy icon, and I can't see the new one.
    +
    +A: 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.
    +
    +Q: Some of my buddies are not showing up as online, why is that?
    +
    +A: AOL has set a limit for the maximum number of people you can have in
    +your buddy list. This number is currently 500 for AIM, if you don't think
    +you are
    +anywhere near that limit, it is possible that your server-stored buddy
    +list is corrupt.
    +<p>
    + If you think this might be the case, you can try signing on with an
    + official AIM program from AOL. This will usually correct any problems
    + with the list.
    +</p>
    +
    +Q: Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
    +
    +A: 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 Programs" from the preferences menu. Add a service with protocol
    +"aim" and set the program to <code>gaim-remote uri "%s"</code>. This will
    +make AIM URIs work in Galeon 2. Also, not all types of AIM URI's are
    +supported. The ones that <i>are</i> supported are goim, addbuddy, and
    +gochat.
    +<p>
    + You'll need the &quot;Remote Control&quot; plugin loaded for this to work.
    +</p>
    +<p>
    + If you use wingaim, this will not work as gaim-remote has not yet been ported
    + over.
    +</p>
    +
    +Q: Does Gaim support file transfer?
    +
    +A: AIM and ICQ file transfer is partially implemented. Notably, it will
    +fail when the <b>sender</b> is behind a NAT device, and sometimes when the
    +sender is behind a firewall even if not behind a NAT.
    +<a href="http://gaim.sourceforge.net/summerofcode/jonathan/blog">Jonathan
    +Clark</a> is working on this as a Summer of Code project.
    +
    +Q: Does Gaim support DirectIM and IM Image?
    +
    +A: Yeah, kind of. This tends to be one of the buggier areas of Gaim.
    +If it's not working for you, make sure that at least one person is not
    +behind a firewall.
    +
    +!ANCHOR aimsms
    +Q: Can I send SMS messages?
    +
    +A: 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 screen name
    ++19195551234 We think this should work for countries with a country
    +code of 1 (the United States and Canada).
    +<p>
    + Sending SMS messages using "the ICQ method" is not yet supported.
    +</p>
    +
    +Q: Can I add SMS numbers to my buddy list?
    +
    +A: Yes. You should be able to add phone numbers to your buddy
    +list using the same format as above.
    +
    +Q: 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?
    +
    +A: 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 between AIM and ICQ, but <b>the person receiving the
    +message must support this</b>. Gaim, of course, supports this for both ICQ
    +and AIM accounts. Windows AIM version 5.2.3139 supports receiving messages
    +from ICQ users. It is unknown if earlier versions of Windows AIM support
    +this. Windows ICQ build 3800 does not support receiving messages from AIM
    +users. Windows ICQ Lite builds 1150 and later support receiving messages
    +from AIM users and sending messages to AIM users. MacAIM versions 4.6 beta,
    +build 1.1131 and newer support sending and receiving messages to and from
    +ICQ users.
    +<p>
    + The same clients that support receiving messages from the alternate
    + messaging network will also show up in buddy lists of people using the
    + alternate network. This means that if you can message an ICQ user from an
    + AIM account, 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.
    +</p>
    +
    +Q: 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?
    +
    +A: 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.
    +
    +Q: Can I set myself invisible?
    +
    +A: Yes. Go to Tools-&gt;Away-&gt;<i>account</i>-&gt;Invisible.
    +
    +
    +
    +!SECTION IRC Protocol
    +
    +Q: How do I join a channel with the IRC plugin?
    +
    +A: First create the account, then sign on. After you have signed on, you
    +can use File-&gt;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 use <code>/join</code> to connect to a new channel.
    +
    +Q: Is there a way to make Gaim automatically identify me and/or join IRC
    +chats on login?
    +
    +A: Yes. Add NickServ to your buddy list and place buddy pounces on
    +him/her/it. Do not include &quot;/msg nickserv&quot; as part of the
    +message to send.
    +<p>
    + 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.
    +</p>
    +
    +Q: Is it possible to change the user name that appears in
    +username@hostname?
    +
    +A: Yes. Go to Tools-&gt;Accounts. Select your IRC account and click
    +Modify. Expand the Show more options section. Enter a name in the
    +Username field.
    +
    +Q: How can I set/change my real name?
    +
    +A: Go to Tools-&gt;Accounts. Select your IRC account and click modify.
    +Expand the Show more options section. Enter a name in the Real name field.
    +
    +
    +!SECTION Jabber Protocol
    +
    +Q: How do I choose which Jabber server to use?
    +
    +A: The Jabber server name is part of your Jabber I.D., such as
    +<code>somebody@server.name</code>. So when entering your Jabber "screen
    +name", the server is specified as part of your JID.
    +
    +Q: How do I change my Jabber resource to be other than the default of "/Gaim"?
    +
    +A: When you create your account in Gaim, simply append the desired
    +resource identifier to your Jabber I.D. For example:
    +<code>somebody@server.name/resource</code>
    +
    +!ANCHOR jabber-register
    +Q: How do I register a new Jabber account?
    +
    +A: As of version 0.52 and up:
    +<ol>
    + <li>Click "Tools-&gt;Accounts-&gt;Add"</li>
    + <li>Select "Jabber" for the protocol.</li>
    + <li>Fill in screen name and password as you normally would. <b>THIS IS A REQUIRED STEP</b></li>
    + <li>Check the "Register with server" check-box, if present, else click
    + "Register" instead of "OK" below.</li>
    + <li>Click "OK".</li>
    +</ol>
    +<p>
    + <b>Note:</b> You are strongly recommended to check the "Remember password"
    + check-box as well, as Gaim presently does no password verification. So if you
    + don't type in what you thought you did, you're hosed.
    +</p>
    +
    +Q: How do I use invisibility?
    +
    +A: Jabber invisibility support is available in Gaim version 0.60 and later.
    +<p>
    + There are two ways to use Jabber invisibility: on a per-buddy and on a
    + per-server basis.
    +</p>
    +<p>
    + To use per-buddy invisibility: right-click on the buddy on the Online
    + buddy list and select "Temporarily Hide From." You will appear to that
    + buddy to be off-line. To make yourself seen by that buddy again:
    + right-click on the buddy and select "Un-hide From." Note that the menu
    + changes based on whether you're currently invisible to that buddy or
    + not.
    +</p>
    +<blockquote>
    + The "Temporarily" part is a dead give-away. Your invisibility to
    + that buddy will last only until the next time you log on or until
    + you set server invisibility (discussed next) on and off.
    +</blockquote>
    +<p>
    + To use per-server invisibility: click "Tools -&gt; Away," select the
    + Jabber server login for the server upon which you wish to become invisible
    + (if necessary) and select "Invisible." To become visible again: select
    + anything else from that same menu (such as "Online"), or set your away
    + status or log off the server and back on again.
    +</p>
    +<p>
    + You can set yourself invisible per-server and subsequently make yourself
    + visible to selected buddies only.
    +</p>
    +<p>
    + Gaim currently does not retain invisibility settings between logins,
    + just as it doesn't currently retain "away" status.
    +</p>
    +
    +Q: 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?
    +
    +A: With Gaim 0.60 or later, it might be continuing to
    + import the old buddy lists. Remove <code>~/.gaim/*.blist</code> - these
    + are no longer used, the buddy list is now stored in <code>~/.gaim/blist.xml</code>
    +
    +Q: Can I remove a buddy from my Jabber roster entirely?
    +
    +A: With Gaim 0.60 or later, the deletion code will do this.
    + Gaim currently does not retain invisibility settings between logins,
    + just as it doesn't currently retain "away" status.
    +
    +Q: What does "Cancel Presence Notification" do?
    +
    +A: This selection, available in Gaim version 0.60 and later, and found by
    +right-clicking on a buddy entry in the buddy list, prevents that
    +Jabber I.D. from receiving future presence notifications when you log on to
    +the server.
    +<p>
    + After you do this, that buddy will have to re-request a subscription to
    + your presence (and you will have to approve it) for them to again see you
    + on-line.
    +</p>
    +
    +
    +!SECTION Y!M (Yahoo) Protocol
    +
    +Q: I cannot connect to Yahoo! and get "Invalid Password" errors, or
    +I'm using a version of Gaim older than 0.79!
    +
    +A: Make sure you have at least 0.79.
    +
    +Q: 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?
    +
    +A: Yahoo!'s firewall with no proxy option connects to Yahoo! by wrapping
    +the YMSG protocol inside HTTP. Gaim currently doesn't support doing this.
    +<p>
    + Gaim does support changing the port it connects to. Try changing the
    + Pager&nbsp;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.
    +</p>
    +
    +Q: I blocked someone, but it doesn't seem to have worked.
    +
    +A: 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.
    +<p>
    + 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-&gt;Privacy dialog will often get things
    + working.
    +</p>
    +
    +Q: Can I get a list of Yahoo! Chat rooms? What about localized lists?
    +
    +A: Tools-&gt;Room List will let you list available Yahoo! Chat rooms.
    +Yahoo! has currently disabled user-created rooms. The option to create rooms
    +still exists in Gaim but is non-functional unless Yahoo! re-enables
    +user-created 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-&gt;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.
    +-->
    +<p>
    + Please note that defaults to US localized chat rooms. To get a localized room
    + list, you'll need to change the Chat Room Locale setting in the account editor,
    + under "Show more options". In previous releases, this was known as "Chat Room
    + List URL". The URL is no longer used; it has been replaced by a country code.
    + These codes are the same as the country codes previously used in the URLs.
    + Certain country codes no longer seem to work (most notably de).
    +</p>
    +<p>
    + The list of known country codes is:
    +</p>
    +<ul>
    +<li>aa =&gt; Asia</li>
    +<li>ar =&gt; Argentina</li>
    +<li>au =&gt; Australia</li>
    +<li>br =&gt; Brazil</li>
    +<li>ca =&gt; Canada</li>
    +<li>cf =&gt; Central African Republic</li>
    +<li>cn =&gt; China</li>
    +<li>dk =&gt; Denmark</li>
    +<li>es =&gt; Spain</li>
    +<li>fr =&gt; France</li>
    +<li>hk =&gt; Hong Kong</li>
    +<li>in =&gt; India</li>
    +<li>it =&gt; Italy</li>
    +<li>kr =&gt; Korea, Republic of</li>
    +<li>mx =&gt; Mexico</li>
    +<li>no =&gt; Norway</li>
    +<li>se =&gt; Sweden</li>
    +<li>sg =&gt; Singapore</li>
    +<li>tw =&gt; Taiwan</li>
    +<li>uk =&gt; United Kingdom</li>
    +<li>us =&gt; United States of America</li>
    +</ul>
    +<p>
    +If you discover any of these no longer work, or find other country codes that do work, please don't hesitate to contact the development team. (See the <a href="./contactinfo.php">Contact Information</a> page.)
    +</p>
    +
    +Q: What protocol does Gaim use to connect to Yahoo!?
    +
    +A: 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.
    +<p>
    + 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.
    +</p>
    +
    +
    +!SECTION MSN Protocol
    +
    +Q: Will Gaim support MSN video chat?
    +
    +A: See <a href="#vv">this question</a>.
    +
    +Q: Why are my file transfers so slow?
    +
    +A: 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.
    +
    +Q: I'm getting lots of "Already in Opposite list" errors on MSN, why?
    +
    +A: 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-&gt;Privacy, and
    +manually scan the list and remove the duplicate entries. The quick way is to
    +remove the blist.xml file from the <code>~/.gaim</code> directory. Be aware that this
    +contains your buddy list for <i>all</i> accounts, and also stores the
    +&quot;Contact&quot; grouping of Buddies.
    +
    +Q: Is there a way to invite more than one person to an MSN chat?
    +
    +A: 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.
    +
    +Q: Is MSNP9 (MSN6) going to be supported?
    +
    +A: MSNP9 support has existed in Gaim since 0.69. However, at this point,
    +features such as custom smileys aren't yet implemented.
    +
    +Q: Will I be able to use Gaim for MSN after October 15th 2003? (The day they're preventing third party clients from connecting)
    +
    +A: Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is
    +supported after October 15th 2003.
    +
    +Q: I just upgraded Gaim and the MSN plugin will not load. Why?
    +
    +A: 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 project. Install one or both of these and recompile Gaim,
    +and see the next question.
    +
    +Q: The MSN plugin won't load, but I have Mozilla NSS!
    +
    +A: Some distributions, including Slackware, install Mozilla NSS to a non-standard directory. The fix is
    +simple. Edit <code>/etc/ld.so.conf</code> and add <code>/usr/lib/mozilla-1.4</code> (or whatever
    +version you're using, but it's usually 1.4) to the file, and run ldconfig as root. Then re-run
    +configure and recompile Gaim. You may also need to specify where the
    +include file are for NSS and NSPR, see <code>./configure --help</code> for the options.
    +<p>
    + Mozilla 1.5 has a broken .pc file and does not install the necessary .h files, and so will not be detected.
    +</p>
    +<p>
    + See <a href="./faq-ssl.php">these notes</a> on getting SSL to work with Gaim.
    +</p>
    +
    +Q: What does "MSN: S: 911 3" in the debug window mean when I cannot
    +connect to MSN?
    +
    +A: See <a href="./911.txt">this explanation</a>.
    +
    +Q: How do I set an MSN avatar?
    +
    +A: Gaim calls these Buddy Icons. Go to Tools-&gt;Accounts and click to Modify
    +your MSN account. You can drag and drop a file to the resulting dialog, or use
    +the Open button.
    +
    +Q: What does &quot;Has you&quot; in the buddy tooltip mean?
    +
    +A: It shows you if that MSN user has added you to his/her buddy list.
    +&quot;Has you: No&quot; does <i>not</i> mean you can't talk to that person.
    +
    +Q: How do I set my MSN Friendly Name (the name other users see)?
    +
    +A: In the Buddy List window, go to Tools-&gt;Account
    +Actions-&gt;<i>account</i>-&gt;Set Friendly Name.
    +
    +Q: What does &quot;Error reading from switchboard server&quot; mean?
    +
    +A: 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 <a
    +href="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=1060205&amp;group_id=235&amp;atid=100235">
    +Bug 1060205</a> for further information.
    +
    +
    +!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/">www.gadu-gadu.pl</a>
    +(website in Polish).
    +
    +Q: Why doesn't it work right?
    +
    +A: We have not had a Gadu-Gadu maintainer in some time and are currently
    +struggling to keep this protocol functional. If you have any problems,
    +you will need to submit a patch for them, as we are unlikely to have much
    +luck fixing it. If things get too bad, we will be forced to remove this
    +protocol from the default builds.
    +
    +
    +!SECTION Zephyr Protocol
    +
    +Q: What is Zephyr?
    +
    +A: 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.
    +
    +Q: Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with "Couldn't initialize zephyr".
    +
    +A: Your site might require the use of Kerberos 4 for authentication, though
    +few 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 <code>/usr</code>, <code>/usr/local</code>, or <code>/usr/athena</code>, e.g.
    +
    +<code>./configure --with-krb4=/path/to/kerberosIV</code>
    +
    +Q: Gaim isn't working, but I never got any other Zephyr client working on this machine.
    +
    +A: You need to have zhm (which comes with the standard Zephyr distribution)
    +installed, and running, and pointed at your Zephyr servers. e.g.
    +<pre><code>zhm z1.example.com z2.example.com z3.example.com</code></pre>
    +<p>
    +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.
    +</p>
    +
    +Q: How do I use Zephyr from behind my firewall, or without recompiling with kerberos support if needed?
    +
    +A: 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 <a href="http://www.club.cc.cmu.edu/debian/dists/testing/contrib/source/tzc-cclub_001-3.tar.gz">here</a>. 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
    +<pre><code>/path/to/ssh username@hostname /path/to/tzc -e "%s"</code></pre>
    +
    +Alternately, if you have tzc working on your machine, you can enable "Use tzc", and set the tzc
    +command to
    +<pre><code>/path/to/tzc -e "%s"</code></pre>
    +
    +
    +!SECTION SILC Protocol
    +
    +Q: What is SILC?
    +
    +A: 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
    +<a href="http://www.silcnet.org">http://www.silcnet.org</a> for more details.
    +
    +
    +!SECTION Novell Protocol
    +
    +Q: Are there any public servers for Novell?
    +
    +A: Not really. This protocol is designed to connect to a Novell GroupWise
    +server running on a corporate LAN.
    +
    +Q: I can't seem to get it to work.
    +
    +A: Novell tells us that this protocol plugin will only work with either
    +the GroupWise Messenger for Linux server or the GroupWise Messenger SP2
    +(or higher) server for NetWare and Windows. In addition, the server must
    +be secure (SSL enabled). If you have any trouble, see the FAQ question
    +about submitting bugs, and they will be forwarded to Novell, who have
    +been kind enough to continue active maintenance to the protocol plugin
    +code they provided us.
    +
    +
    +!SECTION Scripts and Plugins
    +
    +Q: How do I use perl scripts with Gaim?
    +
    +A: Save the perl script to <code>~/.gaim/plugins/</code> or <code>$prefix/lib/gaim/</code>,
    +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?
    +
    +A: 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
    +<a href="./downloads.php">http://gaim.sourceforge.net/downloads.php</a>
    +and untar it with the command: <code>tar zxvf <i>filename</i></code> where
    +<i>filename</i> is the file you downloaded.
    +
    +<p>
    + After you have a Gaim source code tree:
    +</p>
    +<ol>
    + <li>
    + Change to the resulting directory and run the command:
    + <code>./configure</code> This will create the necessary make files.
    + </li>
    + <li>
    + Move the plugin you wish to compile into the <code>plugins/</code>
    + directory in the Gaim source code tree.
    + </li>
    + <li>
    + Change to the <code>plugins/</code> directory.
    + </li>
    + <li>
    + <p>On Unix/Linux Type:</p>
    + <pre><code>make <i>name</i>.so</code></pre>
    + <p>where the name of the file you wish to compile is <i>name</i>.c.</p>
    + <p>On Win32 Type:</p>
    + <pre><code>make -f Makefile.mingw <i>name</i>.dll</code></pre>
    + <p>where the name of the file you wish to compile is <i>name</i>.c.</p>
    + <p>
    + Note well the difference in the extensions. If you type <code>make
    + <i>name</i>.c</code> instead of <code><i>name</i>.so</code>, it won't work.
    + </p>
    + </li>
    + <li>
    + After <code>make</code> finishes, you can move the plugin to a place that is
    + more convenient. <code>$prefix/lib/gaim</code> is suggested. If you
    + installed Gaim by compiling it yourself, <code>$prefix</code> is
    + <code>/usr/local</code> by default. Otherwise, <code>$prefix</code> is
    + <code>/usr</code>.
    + </li>
    +</ol>
    +
    +Q: I have a plugin or perl script for Gaim that used to work, but does not
    +with the current version.
    +
    +A: 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 <code>$prefix/lib/gaim/</code> or in <code>~/.gaim/plugins/</code>,
    +and must implement the new API, as documented by the <code>make docs</code>
    +command from the root of the Gaim source code tree. This will generate
    +html documentation in the <code>doc/html</code> directory. Also note that plugins and perl
    +scripts are now controlled 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 with some details for C plugins. Also be sure
    +to check out our
    +<a href="./api/index.html">online documentation</a>.
    +Be especially sure to look at the Related Pages, which lists all of Gaim's
    +signals, as well as a nice perl script HOWTO.
    +<p>
    + This documentation can be generated directly from the Gaim source by
    + running <code>make docs</code>. You will need doxygen and graphviz
    + dot installed for this to work.
    +</p>
    +
    +
    +!SECTION Development
    +
    +Q: Can I help?
    +
    +A: 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 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 &quot;this is a duplicate of bug
    +#12345.&quot; As always, make sure you follow the same coding style used in
    +Gaim, and make sure you don't break the core/UI split.
    +
    +Q: Gaim never leaves a core file.
    +
    +A: On most installs core files are limited in size to 0 bytes, and are
    +therefore not created. To rectify this situation, add
    +<code>ulimit -c unlimited</code> to your startup scripts (<code>~/.bash_profile</code>
    +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
    +<code>gdb gaim</code>.
    +
    +!ANCHOR vv
    +Q: Will you support features such as voice chat, internet phones, or
    +video chat?
    +
    +A: In the short term we have no plans to work on or attempt to integrate
    +patches in these areas. However, one of our developers has created <a
    +href="http://gaim-vv.sf.net">Gaim-vv</a>, a "fork" of Gaim, which will be
    +merged into gaim when a decent subset of voice and video functionality is
    +implemented and stable. Having a separate sourceforge project allows
    +people interested in such features greater access to development while not
    +clogging the main thrust of gaim towards text instant messages.
    +
    +Q: Where should I report bugs?
    +
    +A: <a href="./bug.php">Here</a>.
    +
    +Q: Where should I submit patches?
    +
    +A: <a href="./patches.php">Here</a>.
    +
    +Q: Did you guys reverse engineer it?
    +
    +A: 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. Novell was
    +provided by Novell, and SILC was written by one of the developers of
    +the protocol.
    +
    +
    +!SECTION Miscellaneous Questions
    +
    +Q: Can I IM you guys?
    +
    +A: Sure! Look at the <a href="./contactinfo.php">Contact Information</a> page!
    +
    +!ANCHOR Hello
    +Q: Hello?
    +
    +A: We don't know how to answer this question. Stop asking it.
    +
    +Q: 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?
    +
    +A: 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. ;-)
    +
    +Q: Does Gaim support secure instant messaging (encrypted IMs)?
    +
    +A: Short answer: Yes, use the SILC protocol.<br/>
    +Long Answer (for other protocols): 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
    +not secure in any way; some other clients offer options like this, but we
    +feel that such measures instill a false sense of security that is more
    +harmful than helpful.
    +<p>
    + 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 &quot;web of
    + trust&quot; model available at
    + <a href="http://www.gnupg.org/">www.gnupg.org</a> and try out one of
    + these.
    +</p>
    +
    +!ANCHOR plaintext-passwords
    +Q: Why are the passwords in accounts.xml not encrypted?
    +
    +A: This is a case of a really long answer to a short question.
    +<a href="./plaintextpasswords.php">Read our explanation here</a>.
    +
    +Q: What is gaim-remote?
    +
    +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 to get
    +an idea of what we currently envision it doing.
    +
    +Q: When will the next version of Gaim be released?
    +
    +A: 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 will not be released if it still has a large number of serious
    +bugs). Therefore, some releases will take longer than others. Major
    +rewrites means lots of new bugs to work out. The new version will be
    +released as soon as it is possible to do so.
    +
    +!ANCHOR version-number
    +Q: What will the next version be?
    +
    +A: 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.
    +
    +Q: So, can I look forward to mega-sexy super functionality with Gaim?
    +
    +A: 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.
    +
    +Q: How do I change the language for the Highlight Misspelled words option?
    +
    +A: Gaim currently only supports spell checking in your locale language.
    +This is because gtkspell 2 does not offer a good way for us to know which
    +dictionaries are available or to switch between them. This functionality has
    +long been promised for gtkspell version 3, which has been delayed somewhat
    +indefinitely. See <a href="http://gtkspell.sf.net">gtkspell.sf.net</a>.
    +
    +Q: Can I make Gaim transparent/translucent?
    +
    +A: You can make Gaim translucent in most versions of Windows using
    +the "Transparency" plugin. It is not possible to make Gaim
    +translucent in Linux and other platforms that use X11.
    +<p>
    +X.org provides a COMPOSITE extension that allows
    +applications to have true translucency, but it is X.org-specific
    +and it requires support at the GTK+ level (if it is to be
    +per-widget). We do not wish to support this form of translucency
    +until it is supported by GTK+. We also do not wish to implement
    +the psuedo-translucency offered by other programs (by copying
    +a section of your background image, tinting it, and plastering
    +it onto a Gaim window).
    +</p>
    +
    +!COMMENT vim: syntax=gaimfaq tw=75