head	1.35;
access;
symbols
	v2_0_0beta3:1.35
	v2_0_0beta2:1.35
	v2_0_0beta1:1.35
	v1_5_0:1.31.2.4
	v1_4_0:1.31.2.4
	gaim-doodle:1.35.0.2
	v1_3_1:1.31.2.3
	v1_3_0:1.31.2.2
	v1_2_1:1.31.2.2
	v1_2_0:1.31.2.1
	v1_1_4:1.31
	v1_1_3:1.31
	v1_1_2:1.31
	v1_1_1:1.31
	v1_1_0:1.31
	v1_0_3:1.31
	v1_0_2:1.31
	v1_0_1:1.31
	v1_0_0:1.31
	oldstatus:1.31.0.2
	v0_82:1.31
	v0_81:1.31
	v0_80:1.30
	v0_79:1.30
	v0_78:1.29
	v0_77:1.29
	v0_76:1.28
	v0_75:1.28
	v0_74:1.26
	v0_74-branch:1.26.0.2
	v0_73:1.26
	v0_72:1.26
	v0_71:1.26
	v0_70:1.26
	v0_69:1.26
	v0_68:1.26
	v0_67:1.26
	v0_65:1.26
	v0_64:1.26
	v0_63:1.26
	v0_62:1.26
	gaim_0_60:1.26
	v0_60:1.26
	ZERO_DOT_FUCKING_SIXTY:1.26
	v0_59_9:1.21.2.1
	v0_59_8:1.21.2.1
	gaim_0_59_7:1.21.2.1
	v0_60alpha3:1.26
	v0_59_6:1.21.2.1
	v0_59_5:1.21.2.1
	v0_59_4:1.21.2.1
	v0_59_3:1.21.2.1
	v0_59_2:1.21.2.1
	gtk1-stable:1.21.0.2
	v059:1.21
	v058:1.20
	v057:1.20
	v056:1.20
	v055:1.19
	v0_54:1.19;
locks; strict;
comment	@# @;


1.35
date	2005.05.18.04.48.51;	author amc_grim;	state Exp;
branches;
next	1.34;

1.34
date	2005.04.11.12.21.11;	author lschiere;	state Exp;
branches;
next	1.33;

1.33
date	2005.03.22.16.32.33;	author lschiere;	state Exp;
branches;
next	1.32;

1.32
date	2005.01.05.01.52.41;	author lschiere;	state Exp;
branches;
next	1.31;

1.31
date	2004.07.31.15.27.39;	author lschiere;	state Exp;
branches
	1.31.2.1;
next	1.30;

1.30
date	2004.06.05.16.14.10;	author lschiere;	state Exp;
branches;
next	1.29;

1.29
date	2004.04.21.01.43.16;	author lschiere;	state Exp;
branches;
next	1.28;

1.28
date	2003.12.13.02.23.25;	author lschiere;	state Exp;
branches;
next	1.27;

1.27
date	2003.12.09.01.11.13;	author lschiere;	state dead;
branches;
next	1.26;

1.26
date	2002.08.26.00.07.19;	author chipx86;	state Exp;
branches;
next	1.25;

1.25
date	2002.07.19.04.06.20;	author chipx86;	state Exp;
branches;
next	1.24;

1.24
date	2002.07.10.18.58.21;	author chipx86;	state Exp;
branches;
next	1.23;

1.23
date	2002.06.30.05.25.57;	author chipx86;	state Exp;
branches;
next	1.22;

1.22
date	2002.06.29.12.13.25;	author jseymour;	state Exp;
branches;
next	1.21;

1.21
date	2002.06.20.04.00.52;	author chipx86;	state Exp;
branches
	1.21.2.1;
next	1.20;

1.20
date	2002.03.30.10.22.29;	author warmenhoven;	state Exp;
branches;
next	1.19;

1.19
date	2001.10.18.12.12.36;	author warmenhoven;	state Exp;
branches;
next	1.18;

1.18
date	2001.10.15.05.04.04;	author robflynn;	state Exp;
branches;
next	1.17;

1.17
date	2001.08.14.21.50.38;	author warmenhoven;	state Exp;
branches;
next	1.16;

1.16
date	2001.08.06.21.47.17;	author warmenhoven;	state Exp;
branches;
next	1.15;

1.15
date	2001.07.21.19.41.39;	author robflynn;	state Exp;
branches;
next	1.14;

1.14
date	2001.03.30.22.55.50;	author robflynn;	state Exp;
branches;
next	1.13;

1.13
date	2001.03.07.07.54.28;	author robflynn;	state Exp;
branches;
next	1.12;

1.12
date	2001.02.26.22.29.00;	author robflynn;	state Exp;
branches;
next	1.11;

1.11
date	2001.02.22.00.42.55;	author warmenhoven;	state Exp;
branches;
next	1.10;

1.10
date	2001.01.20.23.10.48;	author warmenhoven;	state Exp;
branches;
next	1.9;

1.9
date	2000.11.04.03.08.53;	author warmenhoven;	state Exp;
branches;
next	1.8;

1.8
date	2000.09.11.08.54.54;	author robflynn;	state Exp;
branches;
next	1.7;

1.7
date	2000.08.17.16.28.55;	author robflynn;	state Exp;
branches;
next	1.6;

1.6
date	2000.08.17.07.27.46;	author warmenhoven;	state Exp;
branches;
next	1.5;

1.5
date	2000.07.27.02.32.59;	author robflynn;	state Exp;
branches;
next	1.4;

1.4
date	2000.06.02.22.09.31;	author warmenhoven;	state Exp;
branches;
next	1.3;

1.3
date	2000.05.26.00.59.58;	author warmenhoven;	state Exp;
branches;
next	1.2;

1.2
date	2000.04.19.22.36.38;	author warmenhoven;	state Exp;
branches;
next	1.1;

1.1
date	2000.03.23.03.13.54;	author robflynn;	state Exp;
branches;
next	;

1.21.2.1
date	2002.08.26.00.07.53;	author chipx86;	state Exp;
branches;
next	;

1.31.2.1
date	2005.02.26.18.55.36;	author nosnilmot;	state Exp;
branches;
next	1.31.2.2;

1.31.2.2
date	2005.03.22.16.31.41;	author lschiere;	state Exp;
branches;
next	1.31.2.3;

1.31.2.3
date	2005.05.18.04.48.17;	author amc_grim;	state Exp;
branches;
next	1.31.2.4;

1.31.2.4
date	2005.07.07.18.26.13;	author lschiere;	state Exp;
branches;
next	;


desc
@@


1.35
log
@And on HEAD too
@
text
@Gaim: The Pimpin' Penguin IM Clone Thats Good For The Soul

1. Compiling and Installing

         1.1.  What does "Gaim" stand for?
         1.2.  Why can't I compile Gaim?
         1.3.  I'm trying to install Gaim, but it complains that I don't have
               libgtkspell.so.0, from where can I get this?
         1.4.  What do I need to use the SILC protocol?
         1.5.  Is there some way I can compile just Gaim, without all of these
               protocols?
         1.6.  I installed a new version of Gaim, but the about window says I'm
               still using the old version.
         1.7.  Are the packages signed? If so, by who, and how can I get the
               key?
         1.8.  Can I use Gaim for GTK+ 1.2?
         1.9.  Can I run Gaim on IRIX?
         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

         2.1.  How do I register for a new account?
         2.2.  How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other
               protocol?
         2.3.  How do I change the font Gaim uses?
         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.  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.10. it impossible to control window size and placement for the buddy
               list separately from the conversations.
         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

         3.1. Does Gaim support file transfer?
         3.2. Is there a Gaim tray icon, or docklet, or gnome applet, or panel
              icon, or something?
         3.3. What do those colors in the conversation tab mean?
         3.4. Will Gaim save my buddy list to the server?
         3.5. Can I import or export my buddy list?
         3.6. Does Gaim support animated smileys?
         3.7. Can I make Gaim group screen names by the person that owns them?
              You know, like Trillian's Meta Contacts?
         3.8. How do I get the old logging back?
         3.9. How can I convert my old logs to the new format?

4. ICQ Protocol

         4.1. How do I use ICQ?
         4.2. Can I send SMS messages?

5. TOC Protocol

         5.1. What is the TOC protocol?

6. AIM/ICQ (OSCAR) Protocol

         6.1.  Can I set my profile?
         6.2.  Can I set a buddy icon?
         6.3.  Some of my buddies are not showing up as online, why is that?
         6.4.  Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
         6.5.  I just changed my buddy icon, and I can't see the new one.
         6.6.  Does Gaim support DirectIM and IM Image?
         6.7.  Can I send SMS messages?
         6.8.  Can I add SMS numbers to my buddy list?
         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?
         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?
         6.12. Can I set myself invisible?

7. IRC Protocol

         7.1. How do I join a channel with the IRC plugin?
         7.2. Is there a way to make Gaim automatically identify me and/or join
              IRC chats on login?
         7.3. Is it possible to change the user name that appears in
              username@@hostname?
         7.4. How can I set/change my real name?

8. Jabber Protocol

         8.1. How do I choose which Jabber server to use?
         8.2. How do I change my Jabber resource to be other than the default
              of "/Gaim"?
         8.3. How do I register a new Jabber account?
         8.4. How do I use invisibility?
              I've a buddy that I keep removing from my buddy list but the
         8.5. entry keeps coming back every time I log in again! How can I stop
              this?
         8.6. Can I remove a buddy from my Jabber roster entirely?
         8.7. What does "Cancel Presence Notification" do?

9. Y!M (Yahoo) Protocol

         9.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.  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

         11.1. What is Gadu-Gadu?
         11.2. Why doesn't it work right?

12. Zephyr Protocol

         12.1. What is Zephyr?
         12.2. Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with
               "Couldn't initialize zephyr".
         12.3. Gaim isn't working, but I never got any other Zephyr client
               working on this machine.
         12.4. How do I use Zephyr from behind my firewall, or without
               recompiling with kerberos support if needed?

13. SILC Protocol

         13.1. What is SILC?

14. Novell Protocol

         14.1. Are there any public servers for Novell?
         14.2. I can't seem to get it to work.

15. Scripts and Plugins

         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?

16. Development

         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?

17. Misc. Questions

         17.1. Can I IM you guys?
         17.2. Hello?
               Can I give you money/hardware/other expensive things that can be
         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?
         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
+------------------------------------------------------------------------------

1.1  What does "Gaim" stand for?
 
  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 not "GAIM").

1.2  Why can't I compile Gaim?
 
  Make sure you have relatively recent versions of automake, autoconf, and
  gettext. HOWEVER, generally speaking, having the absolute newest of them is
  not as good as having one version short of newest since we might not have
  found work-arounds for the latest set of changes. Also, some versions of
  automake require certain ranges of gettext versions, and we are utterly
  unable to keep track of what versions will work with what other versions.

  If you have Slackware < 9.1, you need to get non-slack packages for autoconf,
  automake, gettext, and libtool. You also have to copy the contents of /usr/
  local/share/aclocal to /usr/share/aclocal. This is due to bugs in Slackware
  and the auto* packages.

  *BSD users may also have problems with libtool and will also have to remove
  the --no-verify from the configure script.

  Having problems getting SSL and MSN working? See http://gaim.sf.net/
  faq-ssl.php for distribution specific hints.

1.3  I'm trying to install Gaim, but it complains that I don't have
     libgtkspell.so.0, from where can I get this?
 
  libtgtkspell.so.0 is provided by gtkspell. This library is used by Gaim to
  provide the "Highlight misspelled words" feature. You can find an RPM of
  gtkspell at freshrpms.net. You can find the source and a non-Red Hat specific
  RPM at gtkspell.sourceforge.net.

1.4  What do I need to use the SILC protocol?
 
  You need to install the SILC toolkit (http://silcnet.org/software/download/
  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.

  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?
 
  Yeah. There are actually three ways to do it.

   1. Use the --with-static-prpls option to ./configure along with
      --disable-plugins. This will let you choose which protocols are compiled
      in with Gaim, but you will not be able to use any other protocols or
      plugins.

      You'll need to compile any protocols that you specified in
      --with-static-prpls. Oscar and TOC are defaults.

   2. Use the --with-dynamic-prpls option to ./configure

   3. Change to the directories for the protocols you want to compile (e.g. src
      /protocols/jabber), and run make from there. Then after you've compiled
      all of them, change back to src/ and run make gaim.

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
  installed, you need to remove that first. rpm -e gaim or dpkg -p gaim should
  work.

  Likewise, if you want to use an RPM or deb and you have previously compiled
  Gaim from source, you need to make uninstall to remove all Gaim files from /
  usr/local.

1.7  Are the packages signed? If so, by who, and how can I get the key?
 
  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 Christian Hammond. Usually the Mandrake and
  Fedora Core 1 RPMs are signed by Mark Doliner and the Red Hat 8 and 9 RPMs
  are signed by Ethan Blanton. The keys can be obtained from any key server.
  http://pgp.mit.edu/ is popular.

1.8  Can I use Gaim for GTK+1.2?
 
  As of version 0.60, Gaim has been completely converted to using GTK+2.0. We
  really really really recommend using the most current version of Gaim and not
  a GTK+1.2 version of Gaim. However, if you are living in the '90s, or you're
  afraid GTK+2.0 will insult your mother, you can use Gaim 0.59.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.

1.9  Can I run Gaim on IRIX?
 
  It has been done before. Please see http://sourceforge.net/forum/forum.php?
  thread_id=725839&forum_id=665 at our SourceForge Forum.

1.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.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:

    • Make sure only one version of Gaim is installed. "whereis gaim" can
      sometimes be useful for determining this.
    • "export GDK_USE_XFT=0" in a terminal and then run Gaim from the same
      terminal.
    • If gaim is not crashing, but is just sitting there not displaying
      anything, try turning off anything else that might be using the sound
      device (ie xmms) and then starting gaim. If this fixes the problem, it is
      a libao issue, not a gaim issue, and can be worked around by the use of
      esd or arts.
    • Try disabling or deleting any 3rd party plugins, especially anything
      related to encryption.
    • If you use 0.75 or higher on win32, try deleting tcl.dll.
    • If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto
      away preference from -1 to 0.

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.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
  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.

  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.

  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.

  In short, there are a lot of good reasons to not 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 to 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.

+------------------------------------------------------------------------------
| 2. Using Gaim
+------------------------------------------------------------------------------

2.1  How do I register for a new account?
 
  This depends on the protocol.

  AIM: Go to http://my.screenname.aol.com/_cqr/login/login.psp?siteId=
  snshomepage&authLev=1&mcState=initialized&createSn=1.

  MSN (including Hotmail email): Go to http://registernet.passport.com/.

  MSN (using your own email address): Go to http://register.passport.net/.

  Yahoo: Go to http://edit.yahoo.com/config/eval_register.

  Jabber: See the question How do I register a new Jabber account? below.

  ICQ: Go to http://web.icq.com/register.

  Gadu-Gadu: Use the official client to create an account.

  Novell: See your Novell server administrator.

2.2  How do I use AIM, MSN, Yahoo!, Jabber, ICQ, or any other protocol?
 
  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 sign online.

2.3  How do I change the font Gaim uses?
 
  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 ~/.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,
  art.gnome.org, or searching on Google.

  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->Message
  Text.

2.4  How do I make gaim use emacs-like keybindings?
 
  You need to edit your ~/.gtkrc-2.0 to contain the keybindings line from http:
  //gaim.sf.net/gtkrc-2.0.

2.5  How do I use smiley themes?
 
  To select a theme, open Gaim's preferences to the "Smiley Themes" page and
  click on whichever theme you want to use. To install a theme, simply drag it
  into the theme selector. You can find themes on the Gaim Smiley Themes (http:
  //gaim.sf.net/themes.php) page.

  You can also install themes manually by uncompressing them to their own
  directory in ~/.gaim/smileys/

2.6  Why are the status icons so big?
 
  We believe that, by adding a second line of text to each buddy list entry,
  we're able to show more information about each buddy on the buddy list. The
  'Big List,' as we call it, shows status text, idle time, and warning level
  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.

  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.

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.

  `Libao is a cross-platform library that allows programs to output PCM audio
  data to the native audio devices on a wide variety of platforms. It currently
  supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound
  Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts
  (Analog Realtime Synthesizer). '

  To compile Gaim with support for libao you need libao-devel and
  audiofile-devel. To use libao you need libao and audiofile. If you do not
  wish to install these packages you can also just change your sound playing
  method in preferences to Command and use esdplay %s or artsplay %s.

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.
  Choosing "ESD" or "Arts" forces libao to play sounds using that method, while
  choosing "Automatic" lets it decide for itself.

  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=oss

  Other drivers, like alsa09, arts, esd, irix, macosx, and sun might also be
  supported, depending on your platform and how libao was compiled. See also
  man 5 libao.conf.

2.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
  meant to be the same for all instances of the application, the other is meant
  to be unique to that instance of the application. ICCCM also states "If a
  client has multiple windows with identical WM_CLASS and WM_NAME properties,
  then it should provide a WM_WINDOW_ROLE property."

  GTK+ sets these WM_CLASS values for us so that they are unique for Gaim
  instances, and the documentation for the gtk_window_set_wmclass function says
  explicitly not to use it for anything else. Gaim uses the WM_WINDOW_ROLE hint
  to differentiate windows. If your window manager is having problems
  differentiating between Gaim windows, please ensure that it uses the
  WM_WINDOW_ROLE hint per the ICCCM.

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
  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.

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.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 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.

+------------------------------------------------------------------------------
| 3. Features
+------------------------------------------------------------------------------

3.1  Does Gaim support file transfer?
 
  Somewhat, yeah. As of 0.79 the following is supported:

    • Sending and receiving files on AIM (although it might be a bit buggy)
    • Sending and receiving files on IRC
    • Sending and receiving files on Jabber
    • Sending and receiving files on MSN
    • Sending and receiving files on SILC
    • Sending and receiving files on Yahoo (sending is limited to 1Mb)

  Most of the protocols themselves support file transfer, but Gaim has not been
  written to support it yet. If you would like file transfer to work better or
  be more complete, get CVS and submit a patch using the generic file transfer
  API.

3.2  Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or
     something?
 
  Yeah, Gaim supports what is called a system tray icon that conforms to the
  standards at www.freedesktop.org. This tray icon is supported by Windows, KDE
  3.1, Gnome 2.2, and Red Hat Gnome 2.0. All you have to do is load the "System
  Tray Icon" plugin by going to Preferences and then Plugins.

  If you're using Gnome you need to make sure that your panel has a
  Notification Area on it. To add one, right click on the panel, select Add To
  Panel->Utility->Notification Area. Gaim will insert the tray icon in any
  System Tray implementation that conforms to these standards, so feel free to
  write one for your window manager of choice.

  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.

3.3  What do those colors in the conversation tab mean?
 
    • Red - A message is waiting for you
    • Blue - Someone sent a message containing your name
    • Green - The buddy is typing
    • Yellow - The buddy began typing, and then stopped
    • Gray - There has been a join or a part in that chat, or the buddy has
      signed off

3.4  Will Gaim save my buddy list to the server?
 
  Yes, Gaim saves your buddy list to the server for AIM, ICQ, Jabber, MSN,
  Novell and Yahoo!.

3.5  Can I import or export my buddy list?
 
  Sorry, no. Old versions of Gaim supported this, but new versions do not. All
  the code for saving and loading buddy lists was rewritten, and support for
  importing and exporting buddy lists was never re-added. However, with all
  major protocols storing their buddy lists on the server, this feature is less
  useful today than in the past.

3.6  Does Gaim support animated smileys?
 
  Yes, as of version 0.70 Gaim supports animated smileys.

3.7  Can I make Gaim group screen names by the person that owns them? You know,
     like Trillian's Meta Contacts?
 
  Sure! Right click a buddy on your list and at the bottom of the menu click
  "Expand". Then just drag other screen names to the same person below it. When
  you're done, click on the arrow to collapse them. When the contact is
  collapsed, Gaim will select a buddy to display based on the status of the
  buddies in the contact, and their order.

  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
  no way in Gaim itself to revert to the old logging, but the new logging is so
  good you could implement something similar to the old logging as a plugin.

3.9  How can I convert my old logs to the new format?
 
  It's not possible to perfectly convert from the old format to the new format
  because the old format is missing some information necessary to do that (eg.
  which account the messages were sent from).

  It shouldn't be too difficult to do a rough conversion using a small script,
  or using the old_logger_* functions in gaim itself.

  Peter Johnson has written a python script to do just this, it is available on
  his website (at the bottom).

+------------------------------------------------------------------------------
| 4. ICQ Protocol
+------------------------------------------------------------------------------

4.1  How do I use ICQ?
 
  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).

4.2  Can I send SMS messages?
 
  Kind of. See our answer to this for the AIM/ICQ Protocol.

+------------------------------------------------------------------------------
| 5. TOC Protocol
+------------------------------------------------------------------------------

5.1  What is the TOC protocol?
 
  It's an AIM protocol used by Quick Buddy and AIM Express. It's recommended
  that you don't use it. You should use Gaim's OSCAR (AIM/ICQ) protocol
  instead. We keep TOC around in case OSCAR ever stops working. However, we are
  not actively supporting this code, and no longer distribute it in binaries.

+------------------------------------------------------------------------------
| 6. AIM/ICQ (OSCAR) Protocol
+------------------------------------------------------------------------------

6.1  Can I set my profile?
 
  Yes you can. Go to Tools->Account Actions

6.2  Can I set a buddy icon?
 
  Yes. Go to the Account Editor (Tools->Accounts from the buddy list), and
  click to "Modify" the AIM/ICQ account you wish to have an icon. Enter the
  full path to the image you wish to use in the box labeled "Buddy Icon File."
  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.

6.3  Some of my buddies are not showing up as online, why is that?
 
  AOL has set a limit for the maximum number of people you can have in your
  buddy list. This number is currently 200. If you don't think you are anywhere
  near that limit, it is possible that your server-stored buddy list is
  corrupt.

  If you think this might be the case, you can try signing on with an official
  AIM program from AOL. This will usually correct any problems with the list.

6.4  Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
 
  Yes, with Gaim 0.60 and higher, but it can be difficult to set up. You need
  to pass the entire URI to the gaim-remote program (included with gaim). To do
  this with Gnome 2, run gnome-file-types-properties or "File Types and
  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
  supported are goim, addbuddy, and gochat.

  You'll need the "Remote Control" plugin loaded for this to work.

  If you use wingaim, this will not work as gaim-remote has not yet been ported
  over.

6.5  I just changed my buddy icon, and I can't see the new one.
 
  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.

6.6  Does Gaim support DirectIM and IM Image?
 
  Yeah, kind of. This tends to be one of the buggier areas of Gaim. If it's not
  working for you, make sure that at least one person is not behind a firewall.

6.7  Can I send SMS messages?
 
  Yep, just send an IM to the person's phone number. For example, if the phone
  number is (919) 555-1234, you would IM the screen name +19195551234 We think
  this should work for countries with a country code of 1 (the United States
  and Canada).

  Sending SMS messages using "the ICQ method" is not yet supported.

6.8  Can I add SMS numbers to my buddy list?
 
  Not currently. This functionality has been broken since around September
  2003. There is no ETA for when it will be fixed.

6.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?
 
  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 the person receiving the message must support this.
  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.

  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.

6.10  Why can't I connect via either Oscar or TOC?
 
  If you are using Linux, your kernel may be using a network option called
  "ECN". It seems that the AOL servers are currently dropping packets marked as
  "ECN-capable". In order to turn this off, run the command

  echo 0 > /proc/sys/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.

6.12  Can I set myself invisible?

  Yes. Go to Tools->Away->account->Invisible.

+------------------------------------------------------------------------------
| 7. IRC Protocol
+------------------------------------------------------------------------------

7.1  How do I join a channel with the IRC plugin?
 
  First create the account, then sign on. After you have signed on, you can use
  File->Join A Chat on the buddy list to join a channel. In any window, either
  a conversation or a chat, in which your IRC user is the sender, you can also
  use /join to connect to a new channel.

7.2  Is there a way to make Gaim automatically identify me and/or join IRC
     chats on login?
 
  Yes. Add NickServ to your buddy list and place buddy pounces on him/her/it.
  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.

7.3  Is it possible to change the user name that appears in username@@hostname?

  Yes. Go to Tools->Accounts. Select your IRC account and click Modify. Expand
  the Show more options section. Enter a name in the Username field.

7.4  How can I set/change my real name?

  Go to Tools->Accounts. Select your IRC account and click modify. Expand the
  Show more options section. Enter a name in the Real name field.

+------------------------------------------------------------------------------
| 8. Jabber Protocol
+------------------------------------------------------------------------------

8.1  How do I choose which Jabber server to use?
 
  The Jabber server name is part of your Jabber I.D., such as
  somebody@@server.name. So when entering your Jabber "screen name", the server
  is specified as part of your JID.

8.2  How do I change my Jabber resource to be other than the default of "/
     Gaim"?
 
  When you create your account in Gaim, simply append the desired resource
  identifier to your Jabber I.D. For example: somebody@@server.name/resource

8.3  How do I register a new Jabber account?
 
  As of version 0.52 and up:

   1. Click "Tools->Accounts->Add"
   2. Select "Jabber" for the protocol.
   3. Fill in screen name and password as you normally would. THIS IS A
      REQUIRED STEP
   4. Check the "Register with server" check-box
   5. Click "OK".

  Note: 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.

8.4  How do I use invisibility?
 
  Jabber invisibility support is available in Gaim version 0.60 and later.

  There are two ways to use Jabber invisibility: on a per-buddy and on a
  per-server basis.

  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.

      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.

  To use per-server invisibility: click "Tools -> 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.

  You can set yourself invisible per-server and subsequently make yourself
  visible to selected buddies only.

  Gaim currently does not retain invisibility settings between logins, just as
  it doesn't currently retain "away" status.

8.5  I've a buddy that I keep removing from my buddy list but the entry keeps
     coming back every time I log in again! How can I stop this?
 
  With Gaim 0.60 or later, it might be continuing to import the old buddy
  lists. Remove ~/.gaim/*.blist - these are no longer used, the buddy list is
  now stored in ~/.gaim/blist.xml

8.6  Can I remove a buddy from my Jabber roster entirely?
 
  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.

8.7  What does "Cancel Presence Notification" do?
 
  This selection, available in Gaim version 0.60 and later, and found by
  right-clicking on a buddy entry in the buddy list, prevents that Jabber I.D.
  from receiving future presence notifications when you log on to the server.

  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.

+------------------------------------------------------------------------------
| 9. Y!M (Yahoo) Protocol
+------------------------------------------------------------------------------

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/".

  This has recently stopped working, we are investigating alternatives.

  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  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->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.3  Is there a way to invite more than one person to an MSN chat?
 
  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.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 aren't yet implemented.

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.6  I just upgraded Gaim and the MSN plugin will not load. Why?
 
  You did not compile with SSL support, or the SSL plugin failed to load. As of
  protocol version 9, the MSN protocol requires the use of SSL, which Gaim
  provides by either GnuTLS or the combination of NSS and NSPR from the Mozilla
  project. Install one or both of these and recompile Gaim, and see the next
  question.

10.7  The MSN plugin won't load, but I have Mozilla NSS!
 
  Some distributions, including Slackware, install Mozilla NSS to a
  non-standard directory. The fix is simple. Edit /etc/ld.so.conf and add /usr/
  lib/mozilla-1.4 (or whatever version you're using, but it's usually 1.4) to
  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
  ./configure --help for the options.

  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.

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
+------------------------------------------------------------------------------

11.1  What is Gadu-Gadu?
 
  Gadu-Gadu is an IM protocol popular in Poland. You can find more about it at
  www.gadu-gadu.pl (website in Polish).

11.2  Why doesn't it work right?
 
  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.

+------------------------------------------------------------------------------
| 12. Zephyr Protocol
+------------------------------------------------------------------------------

12.1  What is Zephyr?
 
  Zephyr is an IM protocol developed at MIT for use with Project Athena. Its
  features include Kerberos IV authentication, multi-level chats (aka
  "subscriptions"). You're probably using this because your college/employer/
  organization uses it as a local IM/chat system. If not, you probably don't
  have a server to connect to.

12.2  Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with "Couldn't
      initialize zephyr".
 
  Your site might require the use of Kerberos 4 for authentication, though few
  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
      this machine.
 
  You need to have zhm (which comes with the standard Zephyr distribution)
  installed, and running, and pointed at your Zephyr servers. e.g.

  zhm z1.example.com z2.example.com z3.example.com

  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.

12.4  How do I use Zephyr from behind my firewall, or without recompiling with
      kerberos support if needed?
 
  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"


+------------------------------------------------------------------------------
| 13. SILC Protocol
+------------------------------------------------------------------------------

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.

+------------------------------------------------------------------------------
| 14. Novell Protocol
+------------------------------------------------------------------------------

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.

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
  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.

+------------------------------------------------------------------------------
| 15. Scripts and Plugins
+------------------------------------------------------------------------------

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.

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.

  After you have a Gaim source code tree:

   1. Change to the resulting directory and run the command: ./configure This
      will create the necessary make files.
   2. Move the plugin you wish to compile into the plugins/ directory in the
      Gaim source code tree.
   3. Change to the plugins/ directory.
   4. 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
      instead of name.so, it won't work.

   5. After make finishes, you can move the plugin to a place that is more
      convenient. $prefix/lib/gaim is suggested. If you installed Gaim by
      compiling it yourself, $prefix is /usr/local by default. Otherwise,
      $prefix is /usr.

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 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 by the make docs command from the root
  of the Gaim source code tree. This will generate html documentation in the
  doc/html directory. Also note that plugins and perl scripts are now
  controlled from preferences.

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
  online documentation (http://gaim.sf.net/api/index.html). Be especially sure
  to look at the Related Pages, which lists all of Gaim's signals, as well as a
  nice perl script HOWTO.

  This documentation can be generated directly from the Gaim source by running
  make docs. You will need doxygen and graphviz dot installed for this to work.

+------------------------------------------------------------------------------
| 16. Development
+------------------------------------------------------------------------------

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
  try to tackle it and submit a patch. You could also help with general bug
  triage by going through the bug reports and leaving comments such as "this
  has been fixed" or "this is a duplicate of bug #12345." As always, make sure
  you follow the same coding style used in Gaim, and make sure you don't break
  the core/UI split.

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
  directly in gdb with gdb gaim.

16.3  Where should I report bugs?
 
  http://gaim.sf.net/bug.php.

16.4  Where should I submit patches?
 
  http://gaim.sf.net/patches.php.

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
  reverse engineered by other people. Novell was provided by Novell, and SILC
  was written by one of the protocol's developers.

+------------------------------------------------------------------------------
| 17. Misc. Questions
+------------------------------------------------------------------------------

17.1  Can I IM you guys?
 
  Sure! Look at the Contact Information (http://gaim.sf.net/contactinfo.php)
  page!

17.2  Hello?
 
  We don't know how to answer this question. Stop asking it.

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?
 
  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. ;-)

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 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.

  There are a number of 3rd party plugin developers working on developing a
  secure IM framework, the better ones using the GnuPG and the OpenPGP trust
  model for authentication. If you are serious about secure instant messaging,
  read the documentation on the "web of trust" model available at www.gnupg.org
  and try out one of these.

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.php.

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.

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
  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.

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.

@


1.34
log
@same thing here, changing to consistently using GTK+, by rlaager
@
text
@d83 2
a84 2
               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
d86 1
d93 3
d805 4
d829 10
d969 2
d1248 1
a1248 1
  of the Gaim source code tree. This will generated html documentation in the
d1324 1
a1324 1
  Long Answer(for other protocols): Not natively. Doing secure instant
@


1.33
log
@Might as well update it here also
@
text
@d16 1
a16 1
         1.8.  Can I use Gaim for GTK+1.2?
d425 1
a425 1
  You can also just switch to a different GTK theme. You can find GTK themes
d520 1
a520 1
  Gtk+ sets these WM_CLASS values for us so that they are unique for Gaim
@


1.32
log
@(20:47:05) Viper168: hmm, are there more than one faq somewhere?
(20:47:32) LSchiere: the one at gaim.sf.net/faq.php has that answer.
(20:47:46) LSchiere: i don't know of any other
(20:48:03) LSchiere: oh, there is the one in the tarballs, which i tend to
forget to sync to the one on the website
@
text
@d118 2
a119 1
         10.1.  I'm getting lots of "Already in Opposite list" errors on MSN,
d121 2
a122 2
         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?
d124 1
a124 1
         10.4.  (The day they're preventing third party clients from
d126 3
a128 3
         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
d130 4
a133 4
         10.8.  How do I set an MSN avatar?
         10.9.  What does "Has you" in the buddy tooltip mean?
         10.10. How do I set my MSN Friendly Name (the name other users see)?
         10.11. What does "Error reading from switchboard server" mean?
d236 6
a241 1
  compiling an SRPM, use "--with silc" to build the gaim-silc RPM.
d398 1
a398 3
  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
d422 2
d472 1
a472 1
  emblem is the only emblem that shows up when "Small list" is on, and only one
d489 1
a489 1
  method in preferences to Command and use "esdplay %s" or "artsplay %s."
d501 1
d503 1
a503 3
     default_driver=alsa

     default_driver=oss
d506 2
a507 2
  supported, depending on your platform, and how libao was compiled. See also
  'man 5 libao.conf'.
d784 9
a792 3
  "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.
d953 21
a973 21
  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
d994 8
a1001 1
10.1  I'm getting lots of "Already in Opposite list" errors on MSN, why?
d1009 1
a1009 3
  Buddies. Also, 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.
d1011 1
a1011 1
10.2  Is there a way to invite more than one person to an MSN chat?
d1013 4
a1016 2
  Not at this time. When the conversation framework gets another rewrite, it is
  possible that it will be worked on. Until that time, sorry. :)
d1018 1
a1018 1
10.3  Is MSNP9 (MSN6) going to be supported?
d1023 1
a1023 1
10.4  Will I be able to use Gaim for MSN after October 15th 2003? (The day
d1029 1
a1029 1
10.5  I just upgraded Gaim and the MSN plugin will not load. Why?
d1037 1
a1037 1
10.6  The MSN plugin won't load, but I have Mozilla NSS!
d1051 1
a1051 1
10.7  What does "MSN: S: 911 3" in the debug window mean when I cannot connect
d1056 1
a1056 1
10.8  How do I set an MSN avatar?
d1062 1
a1062 1
10.9  What does "Has you" in the buddy tooltip mean?
d1067 1
a1067 1
10.10  How do I set my MSN Friendly Name (the name other users see)?
d1072 1
a1072 1
10.11  What does "Error reading from switchboard server" mean?
d1113 2
a1114 2
  usually one of /usr, /usr/local, or /usr/athena , e.g. ./configure
  --with-krb4=/path/to/kerberosIV
d1146 1
d1191 2
a1192 5
  untar it with the command:

  tar zxvf filename

  where filename is the file you downloaded.
d1196 2
a1197 5
   1. Change to the resulting directory and run the command:

      ./configure

      This will create the necessary make files.
d1320 1
a1320 1
  explanation at http://gaim.sf.net/plaintextpasswords.txt.
@


1.31
log
@(11:27:49) nosnilmot: LSchiere: I regenerated the text FAQ and brought the
man page up to date with the preference changes

once again, nosnilmot is picking up the slack and doing things i should
have done :-)
@
text
@d18 5
a22 4
         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?
d33 3
a35 2
         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
d38 1
a38 1
         2.9.  it impossible to control window size and placement for the buddy
d40 5
a44 3
         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
d83 3
d108 7
a114 1
         9.1. I cannot connect to yahoo!
d118 15
a132 10
         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?
d142 1
a142 1
         12.2. Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with
d144 1
a144 1
         12.3. Gaim isn't working, but I never got any other zephyr client
d146 2
d149 1
a149 1
13. Trepia Protocol
d151 1
a151 3
         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?
d153 1
a153 1
14. SILC Protocol
d155 2
a156 1
         14.1. What is SILC?
d158 1
a158 1
15. Novell Protocol
d160 5
a164 10
         15.1. Are there any public servers for Novell?
         15.2. I can't seem to get it to work.

16. 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
d167 1
a167 1
17. Development
d169 5
a173 5
         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?
d175 1
a175 1
18. Misc. Questions
d177 2
a178 2
         18.1. Can I IM you guys?
         18.2. Hello?
d180 1
a180 1
         18.3. hocked for cash what with you all being students/
d183 7
a189 4
         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?
d196 1
a196 1

d202 1
a202 1

d223 1
a223 1

d230 1
a230 1

d238 1
a238 1

d257 2
a258 2

  If you compiled yourself, and you previously had an rpm or a Debian package
d267 1
a267 1

d276 1
a276 1

d287 1
a287 1

d291 8
a298 1
1.10  How do I apply the patch "something.diff"?
d300 2
d305 2
a306 2
1.11  Why is gaim crashing when I start it?

d310 1
a310 1
    * Make sure only one version of Gaim is installed. "whereis gaim" can
d312 1
a312 1
    * "export GDK_USE_XFT=0" in a terminal and then run Gaim from the same
d314 1
a314 1
    * If gaim is not crashing, but is just sitting there not displaying
d319 1
a319 1
    * Try disabling or deleting any 3rd party plugins, especially anything
d321 2
a322 2
    * If you use 0.75 or higher on win32, try deleting tcl.dll.
    * If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto
d325 2
a326 2
1.12  Gaim <non-current version> is buggy. Gaim CVS is buggy. Why?

d332 2
a333 2
1.13  Why do you always say not to use CVS?

d384 1
a384 1

d407 1
a407 1

d413 1
a413 1

d428 1
a428 1

d433 1
a433 1

d443 1
a443 1

d458 10
a467 1
2.7  How do I get sound to work correctly?
d469 2
d474 1
a474 1
  Libao is a cross-platform library that allows programs to output PCM audio
d478 1
a478 1
  (Analog Realtime Synthesizer).
d485 1
a485 1
2.8  How do I make Gaim use ALSA or OSS for playing sounds? What does the
d487 1
a487 1

d495 1
d499 1
d504 4
a507 4
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.

d522 3
a524 1
2.10  What is a "Buddy Pounce"?
d526 2
d539 2
a540 2
2.11  Where does gaim store its logs?

d546 7
a552 1
2.12  Can I use Gaim for e-mail, blogging, an RSS feed, or something else that
d554 4
a557 4

  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
d568 1
a568 1

d571 6
a576 6
    * Sending and receiving files on AIM (although it might be a bit buggy)
    * Sending and receiving files on IRC
    * Sending and receiving files on Jabber
    * Sending and receiving files on MSN
    * Sending and receiving files on SILC
    * Sending and receiving files on Yahoo (sending is limited to 1Mb)
d585 1
a585 1

d602 6
a607 6

    * Red - A message is waiting for you
    * Blue - Someone sent a message containing your name
    * Green - The buddy is typing
    * Yellow - The buddy began typing, and then stopped
    * Gray - There has been a join or a part in that chat, or the buddy has
d611 1
a611 1

d616 1
a616 1

d624 1
a624 1

d629 1
a629 1

d636 3
d640 1
a640 1

d646 1
a646 1

d662 1
a662 1

d669 1
a669 1

d677 1
a677 1

d688 1
a688 1

d692 1
a692 1

d701 1
a701 1

d711 1
a711 1

d717 1
a717 1
  Galeon 2. Also, not all types of aim URI's are supported. The ones that are
d726 1
a726 1

d736 1
a736 1

d741 1
a741 1

d750 1
a750 1

d756 1
a756 1

d776 1
a776 1

d783 7
d795 1
a795 1

d803 1
a803 1

d805 1
d808 1
a808 1
  it, and tell gaim to auto-join it.
d815 1
a815 1

d822 1
a822 1

d827 1
a827 1

d842 1
a842 1

d872 1
a872 1

d878 1
a878 1

d884 1
a884 1

d896 4
a899 1
9.1  I cannot connect to yahoo!
d901 77
a977 1
  Make sure you have at least 0.79.
d983 2
a984 2
10.1  I'm getting lots of "Already in Opposite list" errors on msn, why?

d987 7
a993 9
  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
  Buddies.
d996 1
a996 1

d1001 1
a1001 1

d1003 1
a1003 1
  features such as custom smileys and buddy icons aren't yet implemented.
d1007 1
a1007 1

d1012 1
a1012 1

d1014 1
a1014 1
  protocol version 9, the MSN protocol requires the use of SSL, which gaim
d1020 1
a1020 1

d1031 1
a1031 1
  See http://gaim.sf.net/faq-ssl.php on getting SSL to work with gaim.
d1034 3
a1036 1
      to msn?
d1038 21
a1058 1
  See http://gaim.sf.net/911.txt.
d1065 1
a1065 1

d1070 1
a1070 1

d1082 1
a1082 1

d1089 1
a1089 1
12.2  Other Zephyr clients (zwgc,owl,tzc) work, but gaim dies with "Couldn't
d1091 1
a1091 1

d1093 4
a1096 4
  (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
d1098 1
a1098 1
12.3  Gaim isn't working, but I never got any other zephyr client working on
d1100 3
a1102 3

  You need to have zhm (which comes with the standard zephyr distribution)
  installed, and running, and pointed at your zephyr servers. e.g.
d1106 3
a1108 3
  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.
d1110 10
a1119 5
+------------------------------------------------------------------------------
| 13. Trepia Protocol
+------------------------------------------------------------------------------

13.1  I heard Trepia was going to be in 0.65. Where is it?
d1121 1
a1121 2
  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.
d1123 2
a1124 2
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?
d1126 1
a1126 4
  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.
d1129 1
a1129 1
| 14. SILC Protocol
d1132 2
a1133 2
14.1  What is SILC?

d1139 1
a1139 1
| 15. Novell Protocol
d1142 2
a1143 2
15.1  Are there any public servers for Novell?

d1147 2
a1148 2
15.2  I can't seem to get it to work.

d1158 1
a1158 1
| 16. Scripts and Plugins
d1161 2
a1162 2
16.1  How do I use perl scripts with Gaim?

d1167 2
a1168 2
16.2  How do I compile a plugin for Gaim?

d1173 1
d1175 1
d1181 1
d1183 1
d1188 2
a1189 1
   4. Type:
d1191 7
d1208 5
a1212 5
16.3  I have a plugin or perl script for Gaim that does not work with 0.60 or
      higher.

  The plugin and perl script API has changed in 0.60, which means plugins and
  perl scripts must be modified in order to work. The plugin or perl script
d1214 4
a1217 4
  implement the new API, as documented in the HOWTO file in the plugins
  directory. Plugins and perl scripts are now controlled from preferences.

16.4  Where can I find documentation on writing plugins and Perl scripts?
d1219 2
d1231 1
a1231 1
| 17. Development
d1234 2
a1235 2
17.1  Can I help?

d1244 2
a1245 2
17.2  Gaim never leaves a core file.

d1249 1
a1249 1
  terminal before starting gaim from that terminal. You can also run Gaim
d1252 7
a1258 9
17.3  Where should I report bugs?

  http://gaim.sf.net/".

17.4  Where should I submit patches?

  http://gaim.sf.net/".

17.5  Did you guys reverse engineer it?
d1260 2
d1268 1
a1268 1
| 18. Misc. Questions
d1271 2
a1272 2
18.1  Can I IM you guys?

d1276 2
a1277 2
18.2  Hello?

d1280 1
a1280 1
18.3  Can I give you money/hardware/other expensive things that can be hocked
d1283 1
a1283 1

d1288 9
a1296 9
18.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
  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.
d1304 2
a1305 2
18.5  Why are the passwords in accounts.xml not encrypted?

d1309 2
a1310 2
18.6  What is gaim-remote?

d1316 2
a1317 2
18.7  When will the next version of Gaim be released?

d1325 20
@


1.31.2.1
log
@Sync the in-tree FAQ with reality
@
text
@d18 4
a21 5
         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?
d32 2
a33 3
         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
d36 1
a36 1
         2.10. it impossible to control window size and placement for the buddy
d38 3
a40 5
         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
a78 3
               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?
d101 1
a101 7
         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!?
d105 10
a114 16
         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?
d124 1
a124 1
         12.2. Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with
d126 1
a126 1
         12.3. Gaim isn't working, but I never got any other Zephyr client
a127 2
         12.4. How do I use Zephyr from behind my firewall, or without
               recompiling with kerberos support if needed?
d129 1
a129 1
13. SILC Protocol
d131 3
a133 1
         13.1. What is SILC?
d135 1
a135 1
14. Novell Protocol
d137 1
a137 2
         14.1. Are there any public servers for Novell?
         14.2. I can't seem to get it to work.
d139 1
a139 1
15. Scripts and Plugins
d141 10
a150 5
         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
d153 1
a153 1
16. Development
d155 5
a159 5
         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?
d161 1
a161 1
17. Misc. Questions
d163 2
a164 2
         17.1. Can I IM you guys?
         17.2. Hello?
d166 1
a166 1
         17.3. hocked for cash what with you all being students/
d169 4
a172 7
         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?
d218 1
a218 6
  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.
d241 1
a241 1
  If you compiled yourself, and you previously had an RPM or a Debian package
d274 1
a274 10
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"?
d279 1
a279 1
1.12  Why is gaim crashing when I start it?
d299 1
a299 1
1.13  Gaim <non-current version> is buggy. Gaim CVS is buggy. Why?
d306 1
a306 1
1.14  Why do you always say not to use CVS?
d366 3
a368 1
  MSN (using your own email address): Go to http://register.passport.net/.
a391 2
  On Windows, this file is located at C:\Documents and Settings\username
  \.themes\Default\gtk-2.0\gtkrc.
d432 1
a432 12
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?
d446 1
a446 1
  method in preferences to Command and use esdplay %s or artsplay %s.
d448 1
a448 1
2.9  How do I make Gaim use ALSA or OSS for playing sounds? What does the
d458 1
a458 3
  default_driver=alsa

  default_driver=oss
d460 1
d462 2
a463 2
  supported, depending on your platform and how libao was compiled. See also
  man 5 libao.conf.
d465 3
a467 3
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.
d483 1
a483 5
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"?
d496 1
a496 1
2.13  Where does gaim store its logs?
d503 1
a503 7
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
d506 3
a508 3
  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
a586 3
  You may need to turn off the preference option to automatically expand
  Contacts in order to be able to edit an existing Contact.

d665 1
a665 1
  Galeon 2. Also, not all types of AIM URI's are supported. The ones that are
d727 3
a729 12
  "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.
a745 1
  Do not include "/msg nickserv" as part of the message to send.
d748 1
a748 1
  it, and tell Gaim to auto-join it.
d836 1
a836 2
9.1  I cannot connect to Yahoo! and get "Invalid Password" errors, or I'm using
     a version of Gaim older than 0.79!
a839 78
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.

d844 1
a844 8
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?
d848 8
a855 4
  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
d858 1
a858 1
10.3  Is there a way to invite more than one person to an MSN chat?
d860 2
a861 4
  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.
d863 1
a863 1
10.4  Is MSNP9 (MSN6) going to be supported?
d866 1
a866 1
  features such as custom smileys aren't yet implemented.
d868 1
a868 1
10.5  Will I be able to use Gaim for MSN after October 15th 2003? (The day
d874 1
a874 1
10.6  I just upgraded Gaim and the MSN plugin will not load. Why?
d877 1
a877 1
  protocol version 9, the MSN protocol requires the use of SSL, which Gaim
d882 1
a882 1
10.7  The MSN plugin won't load, but I have Mozilla NSS!
d894 1
a894 1
  See http://gaim.sf.net/faq-ssl.php on getting SSL to work with Gaim.
d896 2
a897 2
10.8  What does "MSN: S: 911 3" in the debug window mean when I cannot connect
      to MSN?
a900 22
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.

d930 1
a930 1
12.2  Other Zephyr clients (zwgc,owl,tzc) work, but Gaim dies with "Couldn't
d934 4
a937 4
  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
d939 1
a939 1
12.3  Gaim isn't working, but I never got any other Zephyr client working on
d942 3
a944 2
  You need to have zhm (which comes with the standard Zephyr distribution)
  installed, and running, and pointed at your Zephyr servers. e.g.
d947 20
a966 18
  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.

12.4  How do I use Zephyr from behind my firewall, or without recompiling with
      kerberos support if needed?

  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"
d969 1
a969 1
| 13. SILC Protocol
d972 1
a972 1
13.1  What is SILC?
d979 1
a979 1
| 14. Novell Protocol
d982 1
a982 1
14.1  Are there any public servers for Novell?
d987 1
a987 1
14.2  I can't seem to get it to work.
d998 1
a998 1
| 15. Scripts and Plugins
d1001 1
a1001 1
15.1  How do I use perl scripts with Gaim?
d1007 1
a1007 1
15.2  How do I compile a plugin for Gaim?
d1012 3
a1014 2
  untar it with the command: tar zxvf filename where filename is the file you
  downloaded.
d1018 3
a1020 2
   1. Change to the resulting directory and run the command: ./configure This
      will create the necessary make files.
d1024 1
a1024 2
   4. On Unix/Linux Type:

a1025 7

      where the name of the file you wish to compile is name.c.

      On Win32 Type:

      make -f Makefile.mingw name.dll

d1036 2
a1037 2
15.3  I have a plugin or perl script for Gaim that used to work, but does not
      with the current version.
d1039 2
a1040 2
  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
d1042 2
a1043 4
  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.
d1045 1
a1045 1
15.4  Where can I find documentation on writing plugins and Perl scripts?
d1057 1
a1057 1
| 16. Development
d1060 1
a1060 1
16.1  Can I help?
d1070 1
a1070 1
16.2  Gaim never leaves a core file.
d1075 1
a1075 1
  terminal before starting Gaim from that terminal. You can also run Gaim
d1078 1
a1078 1
16.3  Where should I report bugs?
d1080 1
a1080 1
  http://gaim.sf.net/bug.php.
d1082 1
a1082 1
16.4  Where should I submit patches?
d1084 1
a1084 1
  http://gaim.sf.net/patches.php.
d1086 1
a1086 1
16.5  Did you guys reverse engineer it?
d1094 1
a1094 1
| 17. Misc. Questions
d1097 1
a1097 1
17.1  Can I IM you guys?
d1102 1
a1102 1
17.2  Hello?
d1106 1
a1106 1
17.3  Can I give you money/hardware/other expensive things that can be hocked
d1114 1
a1114 1
17.4  Does Gaim support secure instant messaging (encrypted IMs)?
d1130 1
a1130 1
17.5  Why are the passwords in accounts.xml not encrypted?
d1133 1
a1133 1
  explanation at http://gaim.sf.net/plaintextpasswords.php.
d1135 1
a1135 1
17.6  What is gaim-remote?
d1142 1
a1142 1
17.7  When will the next version of Gaim be released?
a1150 20
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.

@


1.31.2.2
log
@(11:25:59) ari: the thing about plaintext passwords should be updated in
the faq to http://gaim.sourceforge.net/plaintextpasswords.php
(11:26:30) rlaager: ari: What's out of date with it?
(11:26:59) ari: it links to .txt
(11:27:01) LSchiere2: the url
(11:27:04) ari: in the faq
nomeata novas0x2a nosnilmot
(11:27:17) LSchiere2: I forgot that noif made the pretty version
(11:27:21) ari: with the thing
(11:27:28) rlaager: ahh, sorry, I shouldn't have commented just after
waking up
(11:27:56) LSchiere2: except my version shows it already updated
(11:28:45) ari: maybe not cvs
(11:28:51) ari: in doc/FAQ
(11:28:55) LSchiere2: oh that.
@
text
@d197 1
a197 1
 
d203 1
a203 1
 
d224 1
a224 1
 
d231 1
a231 1
 
d244 1
a244 1
 
d263 1
a263 1
 
d273 1
a273 1
 
d282 1
a282 1
 
d293 1
a293 1
 
d298 1
a298 1
 
d307 1
a307 1
 
d312 1
a312 1
 
d316 1
a316 1
    • Make sure only one version of Gaim is installed. "whereis gaim" can
d318 1
a318 1
    • "export GDK_USE_XFT=0" in a terminal and then run Gaim from the same
d320 1
a320 1
    • If gaim is not crashing, but is just sitting there not displaying
d325 1
a325 1
    • Try disabling or deleting any 3rd party plugins, especially anything
d327 2
a328 2
    • If you use 0.75 or higher on win32, try deleting tcl.dll.
    • If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto
d332 1
a332 1
 
d339 1
a339 1
 
d390 1
a390 1
 
d411 1
a411 1
 
d417 1
a417 1
 
d434 1
a434 1
 
d439 1
a439 1
 
d449 1
a449 1
 
d465 1
a465 1
 
d476 1
a476 1
 
d480 1
a480 1
  `Libao is a cross-platform library that allows programs to output PCM audio
d484 1
a484 1
  (Analog Realtime Synthesizer). '
d493 1
a493 1
 
d512 1
a512 1
 
d528 1
a528 1
 
d532 1
a532 1
 
d545 1
a545 1
 
d552 1
a552 1
 
d559 1
a559 1
 
d573 1
a573 1
 
d576 6
a581 6
    • Sending and receiving files on AIM (although it might be a bit buggy)
    • Sending and receiving files on IRC
    • Sending and receiving files on Jabber
    • Sending and receiving files on MSN
    • Sending and receiving files on SILC
    • Sending and receiving files on Yahoo (sending is limited to 1Mb)
d590 1
a590 1
 
d607 6
a612 6
 
    • Red - A message is waiting for you
    • Blue - Someone sent a message containing your name
    • Green - The buddy is typing
    • Yellow - The buddy began typing, and then stopped
    • Gray - There has been a join or a part in that chat, or the buddy has
d616 1
a616 1
 
d621 1
a621 1
 
d629 1
a629 1
 
d634 1
a634 1
 
d645 1
a645 1
 
d651 1
a651 1
 
d667 1
a667 1
 
d674 1
a674 1
 
d682 1
a682 1
 
d693 1
a693 1
 
d697 1
a697 1
 
d706 1
a706 1
 
d716 1
a716 1
 
d731 1
a731 1
 
d741 1
a741 1
 
d746 1
a746 1
 
d755 1
a755 1
 
d761 1
a761 1
 
d781 1
a781 1
 
a784 1

a785 1

a786 1

a787 1

d793 1
a793 1
 
d802 1
a802 1
 
d810 1
a810 1
 
d822 1
a822 1
 
d829 1
a829 1
 
d834 1
a834 1
 
d849 1
a849 1
 
d879 1
a879 1
 
d885 1
a885 1
 
d891 1
a891 1
 
d905 1
a905 1
 
d910 1
a910 1
 
d921 1
a921 1
 
d934 1
a934 1
 
d949 21
a969 21
    • 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
d972 1
a972 1
 
d991 1
a991 1
 
d998 1
a998 1
 
d1008 1
a1008 1
 
d1015 1
a1015 1
 
d1021 1
a1021 1
 
d1026 1
a1026 1
 
d1034 1
a1034 1
 
d1049 1
a1049 1
 
d1053 1
a1053 1
 
d1059 1
a1059 1
 
d1064 1
a1064 1
 
d1069 1
a1069 1
 
d1079 1
a1079 1
 
d1084 1
a1084 1
 
d1096 1
a1096 1
 
d1105 1
a1105 1
 
d1114 1
a1114 1
 
a1116 1

d1125 1
a1125 1
 
a1132 1

a1133 1

a1135 1

a1137 1

d1143 1
a1143 1
 
d1153 1
a1153 1
 
d1158 1
a1158 1
 
d1172 1
a1172 1
 
d1178 1
a1178 1
 
d1214 1
a1214 1
 
d1224 1
a1224 1
 
d1239 1
a1239 1
 
d1249 1
a1249 1
 
d1257 1
a1257 1
 
d1261 1
a1261 1
 
d1265 1
a1265 1
 
d1276 1
a1276 1
 
d1281 1
a1281 1
 
d1287 1
a1287 1
 
d1293 8
a1300 8
 
  Short answer: Yes, use the SILC protocol.
  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.
d1309 1
a1309 1
 
d1314 1
a1314 1
 
d1321 1
a1321 1
 
d1330 1
a1330 1
 
d1342 1
a1342 1
 
@


1.31.2.3
log
@some FAQ syncing from John Bailey
@
text
@d83 2
a84 2
         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
a85 1
         6.12. Can I set myself invisible?
a91 3
         7.3. Is it possible to change the user name that appears in
              username@@hostname?
         7.4. How can I set/change my real name?
a800 4
6.12  Can I set myself invisible?

  Yes. Go to Tools->Away->account->Invisible.

a820 10
7.3  Is it possible to change the user name that appears in username@@hostname?

  Yes. Go to Tools->Accounts. Select your IRC account and click Modify. Expand
  the Show more options section. Enter a name in the Username field.

7.4  How can I set/change my real name?

  Go to Tools->Accounts. Select your IRC account and click modify. Expand the
  Show more options section. Enter a name in the Real name field.

a950 2
  This has recently stopped working, we are investigating alternatives.

d1228 1
a1228 1
  of the Gaim source code tree. This will generate html documentation in the
d1304 1
a1304 1
  Long Answer (for other protocols): Not natively. Doing secure instant
@


1.31.2.4
log
@release day :-)
@
text
@d16 1
a16 1
         1.8.  Can I use Gaim for GTK+ 1.2?
d83 2
a84 2
               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
a86 1
         6.13. I am having trouble with file transfer. What's up?
d122 2
a123 3
         10.1.  Will Gaim support MSN video chat?
         10.2.  Why are my file transfers so slow?
         10.3.  I'm getting lots of "Already in Opposite list" errors on MSN,
d125 2
a126 2
         10.4.  Is there a way to invite more than one person to an MSN chat?
         10.5.  Is MSNP9 (MSN6) going to be supported?
d128 1
a128 1
         10.6.  (The day they're preventing third party clients from
d130 3
a132 3
         10.7.  I just upgraded Gaim and the MSN plugin will not load. Why?
         10.8.  The MSN plugin won't load, but I have Mozilla NSS!
         10.9.  What does "MSN: S: 911 3" in the debug window mean when I
d134 4
a137 4
         10.10. How do I set an MSN avatar?
         10.11. What does "Has you" in the buddy tooltip mean?
         10.12. How do I set my MSN Friendly Name (the name other users see)?
         10.13. What does "Error reading from switchboard server" mean?
d176 3
a178 5
         16.3. Will you support features such as voice chat, internet phones,
               or video chat?
         16.4. Where should I report bugs?
         16.5. Where should I submit patches?
         16.6. Did you guys reverse engineer it?
d285 1
a285 1
1.8  Can I use Gaim for GTK+ 1.2?
d304 1
a304 1
  to use gaim on MacOSX, you need to install an X server and GTK+, which we are
d424 4
a427 4
  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. If the file does not exist, create it.
d429 1
a429 1
  You can also just switch to a different GTK+ theme. You can find GTK+ themes
d578 1
a578 1
  Somewhat, yeah. As of 1.2.1 The following is supported:
d585 1
a585 2
    • Sending and receiving files on Yahoo when not using an HTTP proxy
      (sending is limited to an unknown file size)
d698 1
a698 2
  In AIM, yes, you can. Go to Tools->Account Actions
  In ICQ, this is not yet supported. Patches are welcome.
d712 3
a714 3
  buddy list. This number is currently 250 for AIM, if you don't think you are
  anywhere near that limit, it is possible that your server-stored buddy list
  is corrupt.
d760 2
a761 3
  Yes. You should be able to add phone numbers to your buddy list using the
  same format as above. This recently started working again--we're not sure
  why.
d806 1
a806 1
 
a808 7
6.13  I am having trouble with file transfer. What's up?
 
  AIM file transfer is only partially implemented. Notably, it will fail when
  the *sender* is behind a NAT device, and sometimes when the sender is behind
  a firewall even if not behind a NAT. ICQ file transfer is not implemented as
  yet. Patches for both of these are welcome.

d830 1
a830 1
 
d835 1
a835 1
 
d863 1
a863 2
   4. Check the "Register with server" check-box, if present, else click
      "Register" instead of "OK" below.
d1014 1
a1014 5
10.1  Will Gaim support MSN video chat?
 
  See #vv.

10.2  Why are my file transfers so slow?
d1021 1
a1021 1
10.3  I'm getting lots of "Already in Opposite list" errors on MSN, why?
d1031 1
a1031 1
10.4  Is there a way to invite more than one person to an MSN chat?
d1038 1
a1038 1
10.5  Is MSNP9 (MSN6) going to be supported?
d1043 1
a1043 1
10.6  Will I be able to use Gaim for MSN after October 15th 2003? (The day
d1049 1
a1049 1
10.7  I just upgraded Gaim and the MSN plugin will not load. Why?
d1057 1
a1057 1
10.8  The MSN plugin won't load, but I have Mozilla NSS!
d1071 1
a1071 1
10.9  What does "MSN: S: 911 3" in the debug window mean when I cannot connect
d1076 1
a1076 1
10.10  How do I set an MSN avatar?
d1082 1
a1082 1
10.11  What does "Has you" in the buddy tooltip mean?
d1087 1
a1087 1
10.12  How do I set my MSN Friendly Name (the name other users see)?
d1092 1
a1092 1
10.13  What does "Error reading from switchboard server" mean?
d1285 1
a1285 12
16.3  Will you support features such as voice chat, internet phones, or video
      chat?
 
  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 gaim-vv (http://
  gaim-vv.sf.net), 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.

16.4  Where should I report bugs?
d1289 1
a1289 1
16.5  Where should I submit patches?
d1293 1
a1293 1
16.6  Did you guys reverse engineer it?
@


1.30
log
@resync. i need to do this far more often
@
text
@d5 17
a21 12
         1.1. Why can't I compile Gaim?
         1.2. I'm trying to install Gaim, but it complains that I don't have
              libgtkspell.so.0, from where can I get this?
         1.3. Is there some way I can compile just Gaim, without all of these
              protocols?
         1.4. I installed a new version of Gaim, but the about window says I'm
              still using the old version.
         1.5. Can I use Gaim for GTK+1.2?
         1.6. Can I run Gaim on IRIX?
         1.7. How do I apply the xxxx patch (name.diff)?
         1.8. Why is gaim crashing when I start it?
         1.9. Gaim CVS is buggy. Gaim <non-current version> is buggy.
d26 4
a29 4
         2.2.  How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu(GG), Napster, or
               Zephyr?
         2.3.  How do I make gaim use emacs-like keybindings?
         2.4.  How do I change the font Gaim uses?
a34 2
         2.9.  I just changed my buddy icon, and I can't see the new one.
         2.10. Why is everything at such small/large font sizes?
d36 1
a36 1
         2.11. it impossible to control window size and placement for the buddy
d38 3
a40 4
         2.12. Why is the toggle to disable tabs not working?
         2.13. What is a "Buddy Pounce"?
         2.14. Where does gaim store its logs?
         2.15. Can I use Gaim for e-mail, blogging, an RSS feed, or something
d45 11
a55 12
         3.1.  Does Gaim support file transfer?
         3.2.  Is there a Gaim tray icon, or docklet, or gnome applet, or panel
               icon, or something?
         3.3.  What do those colors in the conversation tab mean?
         3.4.  Will Gaim save my buddy list to the server?
         3.5.  Can I import or export my buddy list?
         3.6.  Does Gaim support animated smileys?
         3.7.  Can I make Gaim group screen names by the person that owns them?
               You know, like Trillian's Meta Contacts?
         3.8.  How do I get the old logging back?
         3.9.  How can I convert my old logs to the new format?
         3.10. Where has the system log gone?
d68 11
a78 10
         6.1. Can I set my profile?
         6.2. Can I set a buddy icon?
         6.3. Some of my buddies are not showing up as online, why is that?
         6.4. Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
         6.5. Does Gaim support DirectIM and IM Image?
         6.6. Can I send SMS messages?
         6.7. Can I add SMS numbers to my buddy list?
         6.8. I heard AOL is combining ICQ and AIM, does that mean I can send a
              message from an AIM account to an ICQ account and vice-versa?
         6.9. Why can't I connect via either Oscar or TOC?
d82 2
a83 3
         7.1. Why am I getting disconnected when I try to connect to IRC?
         7.2. How do I join a channel with the IRC plugin?
         7.3. Is there a way to make Gaim automatically identify me and/or join
d107 3
a109 5
         10.2. I'm getting an "Invalid User" popup whenever I sign on. How can
               I make this go away?
         10.3. Is there a way to invite more than one person to an MSN chat?
         10.4. Is MSNP9 (MSN6) going to be supported?
         10.5. Will I be able to use Gaim for MSN after October 15th 2003? (The
d111 3
a113 3
         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
d119 1
d135 1
a135 1
14. Scripts and Plugins
d137 12
a148 3
         14.1. How do I use perl scripts with Gaim?
         14.2. How do I compile a plugin for Gaim?
         14.3. I have a plugin or perl script for Gaim that does not work with
d150 1
a150 1
         14.4. Where can I find documentation on writing plugins and Perl
d153 1
a153 1
15. Development
d155 5
a159 5
         15.1. Can I help?
         15.2. Gaim never leaves a core file.
         15.3. Where should I report bugs?
         15.4. Where should I submit patches?
         15.5. Did you guys reverse engineer it?
d161 1
a161 1
16. Misc. Questions
d163 2
a164 2
         16.1. Can I IM you guys?
         16.2. Hello?
d166 1
a166 1
         16.3. hocked for cash what with you all being students/
d169 4
a172 4
         16.4. Does Gaim support secure instant messaging (encrypted IMs)?
         16.5. Why are the passwords in accounts.xml not encrypted?
         16.6. What is gaim-remote?
         16.7. When will the next version of Gaim be released?
d178 8
a185 2
1.1  Why can't I compile Gaim?
 
d204 1
a204 1
1.2  I'm trying to install Gaim, but it complains that I don't have
d206 1
a206 1
 
d212 10
a221 2
1.3  Is there some way I can compile just Gaim, without all of these protocols?
 
d238 1
a238 1
1.4  I installed a new version of Gaim, but the about window says I'm still
d240 1
a240 1
 
d249 11
a259 2
1.5  Can I use Gaim for GTK+1.2?
 
d263 4
a266 3
  afraid GTK+2.0 will insult your mother, you can use Gaim 0.59.x, which is
  GTK+1.2 based. We should warn you though, the 0.59.x releases haven't had new
  features since the middle of 2002. Also, the 0.59.x releases aren't
d269 2
a270 2
1.6  Can I run Gaim on IRIX?
 
d274 6
a279 4
1.7  How do I apply the xxxx patch (name.diff)?
 
  Type patch -p0 < name.diff from inside the gaim directory. If that doesn't
  work, try patch -p1 < name.diff.
a280 2
1.8  Why is gaim crashing when I start it?
 
d282 1
a282 1
  still have problems, try the things in the following list:
d284 4
a287 2
    * Try running gaim with GDK_USE_XFT=0 set (type that in a terminal and then
      run Gaim from the same terminal).
d295 1
a295 4
    * If you use 0.75 on win32, try deleting tcl.dll.
    * If you use 0.70 or lower, make sure only one version of Gaim is
      installed.
    * If you use 0.67 and do not have yourself on your buddy list, upgrade.
a297 2
    * If you use MSN, and have a version 0.64, downgrade to 0.63 or upgrade to
      0.65.
d299 53
a351 9
1.9  Gaim CVS is buggy. Gaim <non-current version> is buggy.
 
  Yes, it is! CVS is often unsupported by Gaim, as are non-current versions.
  This is because non-current versions have old bugs which may be fixed in the
  current version, and CVS is frequently unusable because of the changes in the
  code (and it has new bugs). If you are using either and have a problem,
  upgrade/install the current stable version of Gaim before posting a bug or
  asking for help in Gaim's IRC channel. If the bug does not exist in the
  current version, then please do not ask for help.
d358 1
a358 1
 
d364 5
a368 1
  ICQ: Go to http://web.icq.com/register.
d372 1
a372 1
  MSN (including hotmail email): Go to http://registernet.passport.com/.
d374 1
a374 1
  MSN (using your own email address): Go to this website
d378 1
a378 1
  Jabber: See the question How do I register a new Jabber account? below.
d380 1
a380 1
  Novell: See your novell server administrator.
a381 2
2.2  How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu(GG), Napster, or Zephyr?
 
d383 19
a401 2
  screen) to add the account of the appropriate messaging service. The protocol
  plugin is loaded automatically.
a402 2
2.3  How do I make gaim use emacs-like keybindings?
 
d406 1
a406 7
2.4  How do I change the font Gaim uses?
 
  The font preference in Gaim is used only for the formatting of outgoing
  messages, and that only on the few protocols we support outgoing format on.
  The display fonts used by the rest of Gaim are those specified by GTK. To
  change this font you need to edit your ~/.gtkrc-2.0 file. If you need help
  you can see our example .gtkrc-2.0 (http://gaim.sf.net/gtkrc-2.0) file.
a407 2
2.5  How do I use smiley themes?
 
d417 1
a417 1
 
d425 1
a425 1
  images. Due to the increased usability of this UI, we have made it the
d429 2
a430 3
  similar to IM clients they may have used in the past. 'Big List' can be
  disabled by un-checking "Show buddy icons in list" in the Buddy List
  preferences.
d433 1
a433 1
 
d437 1
a437 1
  `Libao is a cross-platform library that allows programs to output PCM audio
d441 1
a441 1
  (Analog Realtime Synthesizer). '
d450 1
a450 1
 
d455 1
a455 1
  If you choose Automatc, you can create a file, either /etc/libao.conf or ~
a457 1

a460 1

d465 3
a467 9
2.9  I just changed my buddy icon, and I can't see the new one.
 
  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.
a468 13
2.10  Why is everything at such small/large font sizes?
 
  You need to edit your .gtkrc-2.0 in your home directory. This is almost
  certainly a gtk theme thing. You can find more gtk themes by visiting
  themes.freshmeat.net, art.gnome.org, or searching on Google. If it is a
  particular message window, you can also try ignoring font sizes (Tools->
  Preferences->Message Text), though that will only have limited effects. See
  an example .gktrc-2.0 at http://gaim.sf.net/gtkrc-2.0.

2.11  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.
 
d478 6
a483 11
  explicitly not to use it for anything else. Before we released Gaim 0.60, we
  replaced all calls to this function with calls to gtk_window_set_role(),
  which sets the WM_WINDOW_ROLE hint instead. If your window manager is having
  problems differentiating between Gaim windows, please ensure that your window
  managers uses the WM_WINDOW_ROLE hint per the ICCCM.

2.12  Why is the toggle to disable tabs not working?
 
  Because your conversation placement setting is incorrect. Go to Preferences->
  Conversation->Placement and set this to "New Window." Bada bing. Although, I
  don't know why anyone would not want to use tabs.
a484 2
2.13  What is a "Buddy Pounce"?
 
d489 1
a489 1
  pounce on someone, you choose from a number of events, such as signon or
d492 1
a492 1
  sending a messsage to the person, to executing a command. This action will
d496 6
a501 6
2.14  Where does gaim store its logs?
 
  On unix, they are in ~/.gaim/logs, on win32 they are in the $drive/documents
  and settings/user/application data/.gaim/logs directory. In either case, new
  logs (new as of 0.73) are in subdirectories that correspond to protocol\
  yourscreenname\theirscreenname.
d503 1
a503 1
2.15  Can I use Gaim for e-mail, blogging, an RSS feed, or something else that
d505 3
a507 3
 
  No, you can't. We get requests for this often, but Gaim is indeed an instant
  messenger client. Aside from the capabilities each protocol may support, the
d512 1
a512 1
  undoubtably do a better job.
d519 2
a520 3
 
  Somewhat, yeah. Yahoo! supports sending and receiving files in Gaim 0.75 and
  higher. As of 0.76 the following is supported:
d525 2
d536 1
a536 1
 
d548 4
d553 7
a559 5
 
  A red tab means a message is waiting for you; green means the buddy is
  typing; yellow means the buddy began typing, and then stopped. Gray means
  that there has been a join or a part in that chat, or the buddy has signed
  off.
d562 3
a564 3
 
  Yes, Gaim saves your buddy list to the server for AIM, ICQ, MSN, Yahoo, TOC
  and Jabber.
d567 1
a567 1
 
d575 1
a575 1
 
d580 1
a580 1
 
d588 1
a588 1
 
d590 1
a590 1
  no way in gaim itself to revert to the old logging, but the new logging is so
d594 1
a594 1
 
a604 9
3.10  Where has the system log gone?
 
  The system log had to be removed when the new logging was implented. It will
  make a return someday, just be patient. Or if you're brave there is a patch
  in the patch tracker on sourceforge that re-implements system logging.

  The system log has returned with 0.77. There are still some bugs in it of
  course, please search the bug tracker before submitting new ones.

d610 1
a610 1
 
d612 2
a613 2
  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
d617 1
a617 1
 
d625 5
a629 4
 
  It's an AIM protocol used by quickbuddy and aimexpress. It's recommended that
  you don't use it. You should use Gaim's OSCAR (AIM/ICQ) protocol, instead. We
  keep TOC around in case OSCAR ever stops working.
d636 2
a637 2
 
  Yes you can. Go to Tools->Protocol Actions
d640 1
a640 1
 
d649 1
a649 1
 
d655 2
a656 13
  If you think this might be the case, you can try the following steps to
  "clean" your list (be careful doing this, if you do something wrong you could
  lose your buddy list!):

   1. Exit Gaim
   2. mv ~/.gaim/blist.xml ~/
   3. rm ~/.gaim/*.blist
   4. Start Gaim and sign on your AIM account
   5. Delete everyone from your buddy list then sign off
   6. Repeat the above two steps until you are sure your list is empty
   7. Exit Gaim
   8. cp ~/blist.xml ~/.gaim/
   9. Start Gaim and sign on your AIM account
d659 1
a659 1
 
d673 12
a684 2
6.5  Does Gaim support DirectIM and IM Image?
 
d686 1
a686 2
  working for you make sure that the person requesting the DirectIM is not
  behind a firewall.
d688 1
a688 2
  IM Image is currently very broken, we are hoping to get it working again
  soon, but we'll see.
a689 2
6.6  Can I send SMS messages?
 
d691 3
a693 3
  number is (919) 555-1234, you would IM the screenname +19195551234 We think
  this should work for contries with a country code of 1 (the United States and
  Canada).
d697 2
a698 2
6.7  Can I add SMS numbers to my buddy list?
 
d702 1
a702 1
6.8  I heard AOL is combining ICQ and AIM, does that mean I can send a message
d704 1
a704 1
 
d723 2
a724 2
6.9  Why can't I connect via either Oscar or TOC?
 
d735 1
a735 5
7.1  Why am I getting disconnected when I try to connect to IRC?
 
  You will be disconnected if the nickname you chose is already in use on that
  IRC server. Try again with a different nickname. In 0.60 or later, Gaim will
  prompt you to change your screenname in this situation.
a736 2
7.2  How do I join a channel with the IRC plugin?
 
d742 1
a742 1
7.3  Is there a way to make Gaim automatically identify me and/or join IRC
d744 1
a744 1
 
d755 1
a755 1
 
d762 1
a762 1
 
d767 1
a767 1
 
d782 1
a782 1
 
a811 3
 
  As of Gaim version 0.59 and later: Select the Edit Buddies tab, right-click
  on the offending entry, and select "Remove From Roster".
d813 1
a813 1
  If you're Gaim 0.60 or later, it might be continuing to import the old buddy
d818 4
a821 10
 
  As of Gaim version 0.59 and later: yes. In the Edit Buddies tab, right-click
  on a buddy and Select "Remove From Roster.

  The buddy will disappear from your buddy list and also will no longer receive
  presence notifications from you.

  In 0.60, the deletion code will do this. Gaim currently does not retain
  invisibility settings between logins, just as it doesn't currently retain
  "away" status.
d824 1
a824 1
 
d826 2
a827 3
  right-clicking on a buddy entry in the Edit Buddies tab, prevents that Jabber
  I.D. from receiving future presence notifications when you log on to the
  server.
d837 2
a838 2
 
  Make sure you have at least 0.76.
d845 2
a846 2
 
  The reason this happens is because you have a screenname in both your permit
d851 8
a858 17
  directory. This will have a side effect: the msn server stores the
  screennames of your contacts, but does not store what group they are in, so
  you will have to re-sort your msn contacts into the appropriate groups. The
  buddy list is ~/.gaim/blist.xml in 0.60 and later, but be aware that this
  contains your buddy list for all accounts, and also stores the "Contact"
  grouping of Buddies.

10.2  I'm getting an "Invalid User" popup whenever I sign on. How can I make
      this go away?
 
  Delete your buddy list. On unix, this will be at ~/.gaim/blist.xml (or ~
  /.gaim/USERNAME.0.blist pre-v0.60). Note that you will lose buddy groups and
  aliases when you do this. Alternatively, since this will delete ALL buddy
  lists, not just the msn one, you can hand edit the ~/.gaimrc to remove the
  msn account. Start gaim up, which will remove the entries from the account
  that no longer exists, and re-add your account. For most users, this will be
  the better temporary solution.
a859 2
10.3  Is there a way to invite more than one person to an MSN chat?
 
d863 2
a864 2
10.4  Is MSNP9 (MSN6) going to be supported?
 
d868 1
a868 1
10.5  Will I be able to use Gaim for MSN after October 15th 2003? (The day
d870 1
a870 1
 
d874 2
a875 2
10.6  I just upgraded Gaim and the MSN plugin will not load. Why?
 
d882 2
a883 2
10.7  The MSN plugin won't load, but I have Mozilla NSS!
 
d896 1
a896 1
10.8  What does "MSN: S: 911 3" in the debug window mean when I cannot connect
d898 1
a898 1
 
d906 1
a906 1
 
d910 8
d923 1
a923 1
 
d932 1
a932 1
 
d941 1
a941 1
 
d947 2
a948 2
  Alternately, there might be a firewall or a NAT between you and the zephyr
  servers Zephyr doesn't work in an environment where incoming connections
d956 1
a956 1
 
d962 1
a962 1
 
d969 11
a979 1
| 14. Scripts and Plugins
d982 21
a1002 2
14.1  How do I use perl scripts with Gaim?
 
d1007 2
a1008 2
14.2  How do I compile a plugin for Gaim?
 
a1012 1

a1013 1

a1018 1

a1019 1

a1024 1

a1025 1

d1036 1
a1036 1
14.3  I have a plugin or perl script for Gaim that does not work with 0.60 or
d1038 1
a1038 1
 
d1043 3
a1045 1
  directory. Plugins and perl scripts are now controled from preferences.
a1046 2
14.4  Where can I find documentation on writing plugins and Perl scripts?
 
d1057 1
a1057 1
| 15. Development
d1060 4
a1063 4
15.1  Can I help?
 
  But of course. Just find something that's bugging you and fix it. There is a
  slew of a bug reports in Gaim's bug report tracker, you could pick one and
d1070 2
a1071 2
15.2  Gaim never leaves a core file.
 
d1078 9
a1086 7
15.3  Where should I report bugs?
 
  http://gaim.sf.net/bug.php.

15.4  Where should I submit patches?
 
  http://gaim.sf.net/patches.php.
a1087 2
15.5  Did you guys reverse engineer it?
 
d1090 2
a1091 1
  reverse engineered by other people.
d1094 1
a1094 1
| 16. Misc. Questions
d1097 2
a1098 2
16.1  Can I IM you guys?
 
d1102 2
a1103 2
16.2  Hello?
 
d1106 1
a1106 1
16.3  Can I give you money/hardware/other expensive things that can be hocked
d1109 1
a1109 1
 
d1114 3
a1116 2
16.4  Does Gaim support secure instant messaging (encrypted IMs)?
 
d1130 2
a1131 2
16.5  Why are the passwords in accounts.xml not encrypted?
 
d1135 2
a1136 2
16.6  What is gaim-remote?
 
d1142 3
a1144 3
16.7  When will the next version of Gaim be released?
 
  The schedule for releases is every other Thursday. However, a new version
@


1.29
log
@(21:37:35) nosnilmot: LSchiere: do you want this?
http://nosnilmot.com/patches/gaim-0.77cvs-doclove.patch
(21:38:43) LSchiere: oh wow
(21:38:44) LSchiere: sure
(21:38:56) nosnilmot: oh crap, does that spelling nonsense conflict with
it?
(21:40:22) nosnilmot: LSchiere: apparently the spelling police avoided doc/
, so that patch should still apply
(21:40:29) KingAnt: :-)
(21:40:31) LSchiere: nosnilmot: commit message?
(21:40:44) KingAnt: "Dr. Love"
(21:40:54) nosnilmot: "I never knew EvilDennisR did anything, now I do"
(21:41:05) LSchiere: and the serious commit message?


but apparently we aren't being serious tonight.
@
text
@d170 1
a170 1

d191 1
a191 1

d198 1
a198 1

d217 1
a217 1

d227 1
a227 1

d237 1
a237 1

d242 1
a242 1

d247 1
a247 1

d270 1
a270 1

d284 1
a284 1

d302 2
d305 1
a305 1

d311 1
a311 1

d316 1
a316 1

d324 1
a324 1

d334 1
a334 1

d351 1
a351 1

d355 1
a355 1
  Libao is a cross-platform library that allows programs to output PCM audio
d359 1
a359 1
  (Analog Realtime Synthesizer).
d368 1
a368 1

d376 1
d380 1
d386 1
a386 1

d396 1
a396 1

d407 1
a407 1

d424 1
a424 1

d430 1
a430 1

d443 1
a443 1

d451 1
a451 1

d465 1
a465 1

d481 1
a481 1

d494 1
a494 1

d501 1
a501 1

d506 1
a506 1

d514 1
a514 1

d519 1
a519 1

d527 1
a527 1

d533 1
a533 1

d545 1
a545 1

d550 3
d558 1
a558 1

d565 1
a565 1

d573 1
a573 1

d583 1
a583 1

d587 1
a587 1

d596 1
a596 1

d617 1
a617 1

d632 1
a632 1

d637 3
d641 1
a641 1

d650 1
a650 1

d656 1
a656 1

d676 1
a676 1

d688 1
a688 1

d694 1
a694 1

d702 1
a702 1

d713 1
a713 1

d720 1
a720 1

d725 1
a725 1

d740 1
a740 1

d770 1
a770 1

d779 1
a779 1

d791 1
a791 1

d805 1
a805 1

d813 1
a813 1

d828 1
a828 1

d838 1
a838 1

d843 1
a843 1

d849 1
a849 1

d854 1
a854 1

d862 1
a862 1

d877 1
a877 1

d885 1
a885 1

d894 1
a894 1

d903 1
a903 1

d912 1
a912 1

d927 1
a927 1

d933 1
a933 1

d944 1
a944 1

d950 1
a950 1

d955 1
d957 1
d963 1
d965 1
d971 1
d973 1
d986 1
a986 1

d994 1
a994 1

d1009 1
a1009 1

d1019 1
a1019 1

d1027 1
a1027 1

d1031 1
a1031 1

d1035 1
a1035 1

d1045 1
a1045 1

d1050 1
a1050 1

d1056 1
a1056 1

d1062 1
a1062 1

d1077 1
a1077 1

d1082 1
a1082 1

d1089 1
a1089 1

@


1.28
log
@re-adding this since wing gave me a script to generate it with
@
text
@d8 1
a8 2
         1.3. How do I get sound to work correctly?
         1.4. Is there some way I can compile just Gaim, without all of these
d10 7
a16 4
         1.5. I compiled Gaim, but when I restart, it did not update.
         1.6. I have a question about GTK1.2.
         1.7. I'd like to use Gaim on IRIX.
         1.8. How do I apply the xxxx patch (name.diff)?
d27 3
a29 2
         2.7.  Why is Gaim crashing when somebody sends me an IM?
         2.8.  Why is gaim crashing when I start it?
d32 3
a34 1
         2.11. Gaim CVS is buggy. Gaim <non-current version> is buggy.
d37 3
a39 1
         2.14. How do I get rid of the buddy icons in the taskbar?
d43 2
a44 4
         3.1.  Can Gaim send files?
         3.2.  When will file transfer be supported? Is it being worked on?
         3.3.  File Transfer for xxxx doesn't seem to be working.
         3.4.  Is there a Gaim tray icon, or docklet, or gnome applet, or panel
d46 9
a54 6
         3.5.  What do those colors in the conversation tab mean?
         3.6.  Will Gaim save my buddy list to the server?
         3.7.  How come there's no Export Buddy List?
         3.8.  Can Gaim import my buddy list?
         3.9.  Does Gaim support animated smileys?
         3.10. Can I make Gaim group screen names by the person that owns them?
d59 1
a59 2
         4.2. ICQ doesn't work.
         4.3. Gaim 0.60 pops up a bunch of authorization request Dialogs.
d65 1
a65 1
6. AIM/ICQ (Oscar) Protocol
d67 8
a74 7
         6.1. Can I set a buddy icon?
         6.2. Some of my buddies are not showing up as online, why is that?
         6.3. Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
         6.4. IM Image doesn't work, why?
         6.5. I sent an IM Image, but only a blank line shows up, why?
         6.6. Can I add SMS numbers to my buddy list?
         6.7. I heard AOL is combining ICQ and AIM, does that mean I can send a
d76 1
a76 1
         6.8. Why can't I connect via either Oscar or TOC?
d89 1
a89 1
              of "/GAIM"?
d98 1
a98 1
9. Y!M (yahoo) Protocol
d106 1
a106 1
         10.2. I'm getting an "Invalid User" popop whenever I sign on. How can
d110 2
a111 2
         10.5. Will I be able to use Gaim for MSN after October 15th? (The day
               they're preventing third party clients from connecting)
d114 2
d121 1
a121 1
12. Trepia Protocol
d123 10
a132 2
         12.1. I heard Trepia was going to be in 0.65. Where is it?
         12.2. Trepia is showing people in Japan, England, etc. on my buddy
d135 1
a135 1
13. Scripts and Plugins
d137 3
a139 3
         13.1. How do I use perl scripts with Gaim?
         13.2. How do I compile a plugin for Gaim?
         13.3. I have a plugin or perl script for Gaim that does not work with
d141 1
a141 1
         13.4. Where can I find documentation on writing plugins and Perl
d144 7
a150 1
14. Development
d152 4
a155 13
         14.1. Where should I report bugs?
         14.2. Gaim never leaves a core file.
         14.3. Where should I submit patches?
         14.4. Did you guys reverse engineer it?
         14.5. Will Gaim be ported to Windows 95/98/Me/2000/XP?

15. Misc. Questions

         15.1. Does AOL's attempts at blocking Trillian affect Gaim?
         15.2. Is Gaim affected by the vulnerability found in Windows AIM or
               Yahoo Instant Messenger clients?
         15.3. Can I IM you guys?
         15.4. Hello?
d157 1
a157 1
         15.5. hocked for cash what with you all being students/
d160 4
a163 4
         15.6. Does Gaim support secure instant messaging (encrypted IMs)?
         15.7. Why are the passwords in accounts.xml not encrypted?
         15.8. What is gaim-remote?
         15.9. When will the next version of Gaim be released?
a169 9
 
  Make sure you have gettext <= 0.10.40 or gettext >= 0.11.3, autoconf 2.11 or
  >= 2.53, and automake >= 1.4px (tested up to automake 1.6.3). If you are
  still having problems, make sure that your gettext package includes the
  program gettextize (for gettext <= 0.10.40) or autopoint (for gettext >=
  0.11.3). If it does not, look for another package.

  We don't support gettext 0.11.0 through 0.11.2 or 0.12.1. It may work for
  you, but we make no promises.
d171 6
a176 2
  If you are using autoconf 2.50+, do not use a version of gettext lower than
  0.11.3. You will get errors in the po/ directory.
d178 1
a178 1
  If you have Slackware, you need to get non-slack packages for autoconf,
d186 3
d191 1
a191 1
 
d197 1
a197 4
1.3  How do I get sound to work correctly?
 
  Gaim 0.60 and higher support playing sounds via libao. Playing sounds
  directly through esound or arts is no longer supported.
d199 1
a199 14
  `Libao is a cross-platform library that allows programs to output PCM audio
  data to the native audio devices on a wide variety of platforms. It currently
  supports OSS (Open Sound System), ESD (ESounD), ALSA (Advanced Linux Sound
  Architecture), Sun audio system (used in Solaris, OpenBSD, and NetBSD), aRts
  (Analog Realtime Synthesizer). '

  To compile Gaim with support for libao you need libao-devel and
  audiofile-devel. To use libao you need libao and audiofile. If you do not
  wish to install these packages you can also just change your sound playing
  method in preferences to Command and use "esdplay %s" or "artsplay %s."

1.4  Is there some way I can compile just Gaim, without all of these protocols?
 
  Sort of, yeah. There are actually two ways to do it.
d209 3
a211 1
   2. Change to the directories for the protocols you want to compile (e.g. src
d215 2
a216 1
  The static prpls option is broke in 0.64 and higher.
d218 3
a220 7
1.5  I compiled Gaim, but when I restart, it did not update.
 
  If you previously had an rpm or a Debian package installed, you need to
  remove that first. rpm -e gaim or dpkg -p gaim should work. If you are using
  0.59.x or lower, you will receive some errors about your plugins when you
  restart Gaim. This is normal. Simply go into the Plugins dialog (Tools->
  Plugins) and reload them. These errors will only happen once.
d226 16
a241 13
1.6  I have a question about GTK1.2.
 
  Our GTK2 port is now complete, the 0.59.x release series uses only GTK1.2,
  and it is also entirely devoid of new features. 0.60 is the first release
  with GTK2 support. 0.60 and all future Gaim versions will no longer support
  GTK1.2. With the release of 0.60, the gtk1-stable tree that the 0.59.x
  releases were from has been discontinued. If you want anything new in that
  tree, you will have to maintain it yourself.

1.7  I'd like to use Gaim on IRIX.
 
  Please see http://sourceforge.net/forum/forum.php?thread_id=725839&forum_id=
  665 at our SourceForge Forum.
a242 2
1.8  How do I apply the xxxx patch (name.diff)?
 
d246 33
d284 1
a284 1
 
d294 3
a296 1
  MSN: Go to http://registernet.passport.com.
d303 4
a306 14
 
  In Gaim 0.60 and higher, use the Account Editor (Tools->Accounts, or the
  Accounts button on the start screen) to add the account. The appropriate
  protocol plugin is loaded automatically.

  In Gaim 0.59 and lower, you must first load the protocol plugin for the
  protocol that you want to use. These plugins come with Gaim, so just go to
  the Plugins dialog (Tools->Plugins, or the Plugins button on the start
  screen). The list of plugins on this screen is a listing of plugins you have
  already loaded and does not included unloaded but available plugins. To load
  a new plugin, click "Load." The protocol plugins are named libprotocol.so, so
  MSN for instance is provided by libmsn.so, and Gadu-Gadu is provided by
  libgg.so. Now you can use the Account Editor to add an account with the
  desired protocol.
d309 1
a309 1
 
d314 1
a314 1
 
d318 2
a319 3
  change this font you need to edit your ~/.gktrc (Gaim 0.59.9 and lower) or ~
  /.gtkrc-2.0 (Gaim 0.60 and newer). An example ~/.gtkrc-2.0 is available http:
  //gaim.sf.net/gtkrc-2.0.
d322 5
a326 6
 
  Gaim 0.60 and higher support themable smileys. To select a theme, open Gaim's
  preferences to the "Smiley Themes" page and click on whichever theme you want
  to use. To install a theme, simply drag it into the theme selector. You can
  find themes on the Gaim Smiley Themes (http://gaim.sourceforge.net/
  themes.php) page.
d332 1
a332 1
 
d348 1
a348 29
2.7  Why is Gaim crashing when somebody sends me an IM?
 
  If you're using a version older than 0.55 (or Ximian or Debian's 0.54
  package), you can be crashed remotely through an IM using one of two strings.
  The solution is to upgrade to the latest version, where both exploits are
  fixed.

  If you use Yahoo with Gaim 0.59.8 or lower, you need to upgrade. Yahoo
  changed the protocol in a way that broke Gaim, Trillian, Everybuddy, and
  their own linux client.

  If you use Gaim 0.59.5 and Gaim segfaults as soon as it signs on, you do not
  have a valid ~/.gtkrc file. This is fixed in debian's 0.59.5-2 package, and
  is fixed in 0.59.6 for the rest of the world.

  If you are using a version newer than 0.59.6 and Gaim still crashes, please
  let us know.

2.8  Why is gaim crashing when I start it?
 
  With 0.60 and higher, try running gaim with GDK_USE_XFT=0 set. If this does
  not fix the problem, please submit a bug report. If gaim is not crashing, but
  is just sitting there not displaying anything, try turning off anything else
  that might be using the sound device (ie xmms) and then starting gaim. If
  this fixes the problem, it is a libao issue, not a gaim issue, and can be
  worked around by the use of esd or arts.

  If you use MSN, and have a version 0.64, downgrade to 0.63 or upgrade to
  0.65.
d350 2
a351 2
  If you have ever installed 0.65, edit your ~/.gaimrc, changing your auto away
  preference from -1 to 0.
d353 10
a362 1
  If you use 0.67 and do not have yourself on your buddy list, upgrade.
d364 16
a379 1
  If you use 0.70 or lower, make sure only one version of Gaim is installed.
d382 8
a389 8
 
  First, try IMing yourself. Buddy icons are checked when you IM people, so
  depending on the protocol, that may work. If it still doesn't update, check
  the file size (buddy icons must be smaller than 4kb) and the image size (it
  should be 48x48 or 50x50 in most cases). Also, check the file type. GIF or
  JPEG images are best supported; most other formats do not work at all. If all
  of that checks out and it still doesn't work, and you're sure the protocol
  supports it, try restarting Gaim.
d392 1
a392 1
 
d400 18
a417 9
2.11  Gaim CVS is buggy. Gaim <non-current version> is buggy.
 
  Yes, it is! CVS is often unsupported by Gaim, as are non-current versions.
  This is because non-current versions have old bugs which may be fixed in the
  current version, and CVS is frequently unusable because of the changes in the
  code (and it has new bugs). If you are using either and have a problem,
  upgrade/install the current version of Gaim before posting a bug or asking
  for help in Gaim's IRC channel. If the bug does not exist in the current
  version, then please do not ask for help.
d420 4
a423 4
 
  You have told gaim (or have neglected to change the default) to place tabs in
  the "Last Created Window" instead of in a "New Window." Change this tab
  placement option and you will be all set.
d426 1
a426 1
 
d438 17
a454 3
2.14  How do I get rid of the buddy icons in the taskbar?
 
  As of 0.71, you do not.
d460 4
a463 20
3.1  Can Gaim send files?
 
  TOC can, in a limited way, and OSCAR can send files over AIM in 0.60 and
  higher. Most protocols are capable of it, but Gaim hasn't implemented
  anything yet. Support is being worked on and may partially work for MSN and
  Jabber.

3.2  When will file transfer be supported? Is it being worked on?
 
  Gaim 0.60 includes preliminary file transfer support. It likely contains a
  few bugs that will be fixed in time. Currently, Gaim supports sending and
  receiving files via AIM, receiving files via Jabber and IRC. File transfer
  receive code exists for MSN, but it is very flakey, and files are often
  corrupt. If you would like support for another protocol, get CVS and submit a
  patch using the generic file transfer API.

3.3  File Transfer for xxxx doesn't seem to be working.
 
  File transfer for all protocols is still buggy. This is being worked on, but
  has no set date for completion.
d465 11
a475 1
3.4  Is there a Gaim tray icon, or docklet, or gnome applet, or panel icon, or
d477 9
a485 5
 
  In 0.59.x and below, Gaim only has support for Gnome's panel. Gaim 0.60 and
  higher have replaced the gnome-applet with a tray icon that conforms to the
  standards at www.freedesktop.org. This tray icon is supported in KDE 3.1,
  Gnome 2.2, and Red Hat Gnome 2.0. Gaim will insert the tray icon in any
d487 1
a487 2
  write one for your window manager of choice. For Gnome, you must have a
  Notification Area in your Gnome panel.
d489 1
a489 4
  This docklet is the only supported way of putting Gaim in a Gnome2 panel. The
  panel applet (the gaim-applet rpm, the gaim-gnome deb package and compiling
  with the --enable-panel flag) is only supported with Gaim 0.59.x and Gnome
  1.x, the GTK1.2 versions of Gnome.
a490 2
3.5  What do those colors in the conversation tab mean?
 
d493 9
a501 1
  that there has been a join or a part in that chat.
d503 7
a509 28
3.6  Will Gaim save my buddy list to the server?
 
  Yes, as of 0.60 Gaim saves your buddy list to the server for AIM, ICQ, MSN,
  Yahoo, TOC and Jabber. Gaim 0.59.x supports this for AIM, MSN, Yahoo, TOC and
  Jabber.

3.7  How come there's no Export Buddy List?
 
  In 0.59 and earlier you can use cp to copy your buddy list. It is stored in
  the $HOME/.gaim directory. The file name is your screen name, in all capital
  letters. Gaim 0.60 does not support exporting your buddy list.

  Import and export code will hopefully be reintroduced for one of the 0.6x
  releases, due to the introduction of the unified xml buddy list in 0.60.

3.8  Can Gaim import my buddy list?
 
  Unfortunately, no, you cannot import your buddy list with Gaim 0.60 and
  later. However, as Gaim will read the server copy of the buddy list, this is
  most likely not necessary unless you use a 3rd party client that is broken
  (aka trillian).

  With Gaim 0.59 and earlier, this depends on the format of the buddy list.
  Gaim has mixed success importing Windows AIM buddy lists. If you want to try,
  click File->Import. This is accessible after you sign on. If you want to
  import an Licq (http://licq.org/) contact list, you can try using the
  licq2gaim.pl perl script, which comes with the Gaim source code, but we do
  not support this.
a510 2
3.9  Does Gaim support animated smileys?
 
d513 3
a515 2
3.10  Can I make Gaim group screen names by the person that owns them?
 
d522 24
d551 9
a559 18
 
  ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in Gaim (see the
  question ICQ doesn't work for why). To use it, simply put your account number
  in the Screenname box and your password in the Password box. Leave the server
  settings set to the default (login.oscar.aol.com and port 5190).

4.2  ICQ doesn't work.
 
  Use AIM/ICQ for ICQ. AOL stopped supporting the older versions of the ICQ
  protocol. The newer versions are extensions of Oscar, which is labeled AIM/
  ICQ in Gaim. Currently, Oscar supports as much of ICQ as the ICQ plugin used
  to. To use Oscar for ICQ, put your UIN in the Screenname box, and leave the
  server information alone.

4.3  Gaim 0.60 pops up a bunch of authorization request Dialogs.
 
  This is a side effect of enabling support for the server side lists. Yes, you
  must re-request authorization, we can't find a way around this requirement.
d566 4
a569 5
 
  It's an AIM protocol used by quickbuddy and aimexpress. It's not particularly
  recommended that you use it unless you know what it is. :) The only time it
  would be useful in Gaim is if Gaim's OSCAR (AIM/ICQ) protocol stopped working
  for some reason, such as being blocked.
d572 1
a572 1
| 6. AIM/ICQ (Oscar) Protocol
d575 6
a580 2
6.1  Can I set a buddy icon?
 
d588 2
a589 2
6.2  Some of my buddies are not showing up as online, why is that?
 
d591 17
a607 18
  buddy list. This number is currently 200. Gaim 0.58 and newer give you a
  warning if you are over the limit, but if you are using something prior to
  0.58, make sure you are not over the limit (and upgrade to something more
  recent!).

  The other possibility is that your server-stored buddy list is corrupt.
  Unfortunately, Gaim 0.53 had a bug that caused it to corrupt some entries,
  especially group names. While this corruption doesn't show in Gaim unless you
  remove the SCREENNAME.0.blist file from ~/.gaim, it does affect how long the
  server thinks your list is. The best way to fix this, is to:

  mv ~/.gaim/SCREENNAME.0.blist ~/

  where SCREENNAME is your screenname, without spaces and in all caps. Then
  signon, delete all groups, signoff, and signon again to verify that your list
  is empty. Once it is empty, signoff, mv your SCREENNAME.0.blist file back
  into ~/.gaim, then sign on again. This should not be necessary in Gaim 0.60
  and higher.
d609 1
a609 1
  If you have 0.60 or higher, move ~/.gaim/blist.xml instead.
a610 2
6.3  Can I use AIM URI's such as "aim:goim?screenname=robflynn"?
 
d619 2
d624 16
a639 17
6.4  IM Image doesn't work, why?
 
  IM Image is very sensitive, even from windows. Gaim currently only supports
  sending IM Images if the sender is not behind a firewall or NAT device. Given
  that the windows version of AIM also has trouble in this situation, we are
  not sure this is entirely fixable. A work around that is sometimes effective
  is to have the receiver, not being behind a firewall, request a direct
  connection, then send the image.

  In cvs, the html widget is being re-written. it currently does not support
  many features of the old widget we used with GTK1.2, including images.

6.5  I sent an IM Image, but only a blank line shows up, why?
 
  For Gaim 0.59.x and lower, You need to have gdk-pixbuf installed to view IM
  Images. If the receiver is also using Gaim, [s]he also needs to have this
  installed.
a640 2
6.6  Can I add SMS numbers to my buddy list?
 
d644 1
a644 1
6.7  I heard AOL is combining ICQ and AIM, does that mean I can send a message
d646 1
a646 1
 
d665 2
a666 2
6.8  Why can't I connect via either Oscar or TOC?
 
d678 1
a678 1
 
d684 1
a684 1
 
d692 1
a692 1
 
d703 1
a703 1
 
d709 2
a710 2
     GAIM"?
 
d715 1
a715 1
 
d730 1
a730 1
 
d760 1
a760 1
 
d762 5
a766 1
  on the offending entry, and select "Remove From Roster.
d769 1
a769 1
 
d781 1
a781 1
 
d791 1
a791 1
| 9. Y!M (yahoo) Protocol
d795 2
a796 3
 
  Make sure you have at least 0.70. If you still cannot connect, change the
  host you connect to from scs.yahoo.com to scs.msg.yahoo.com
d803 1
a803 1
 
d811 4
a814 1
  you will have to re-sort your msn contacts into the appropriate groups.
d816 1
a816 1
10.2  I'm getting an "Invalid User" popop whenever I sign on. How can I make
d818 1
a818 1
 
d828 1
a828 1
 
d833 1
a833 1
 
d837 3
a839 3
10.5  Will I be able to use Gaim for MSN after October 15th? (The day they're
      preventing third party clients from connecting)
 
d841 1
a841 1
  after October 15th.
d844 1
a844 1
 
d852 1
a852 1
 
d863 6
a868 1
  See http://gaim.sf.net/faq-ssl.php on getting ssl to work with gaim.
d875 1
a875 1
 
d877 34
a910 1
  http://www.gadu-gadu.pl (website in Polish).
d913 1
a913 1
| 12. Trepia Protocol
d916 2
a917 2
12.1  I heard Trepia was going to be in 0.65. Where is it?
 
d921 1
a921 1
12.2  Trepia is showing people in Japan, England, etc. on my buddy list. I
a922 23
 
  We believe this to be the protocol, not Gaim. As Trepia continues to update
  and refine their protocol, it will become more accurate. If we find out
  otherwise, we will attempt to incorporate the changes necessary to act like
  the official client.

+------------------------------------------------------------------------------
| 13. Scripts and Plugins
+------------------------------------------------------------------------------

13.1  How do I use perl scripts with Gaim?
 
  Save the perl script to ~/.gaim/ or $prefix/lib/gaim/, restart Gaim, and load
  the perl script by checking the check box next to its name on the Plugins
  page in preferences.

13.2  How do I compile a plugin for Gaim?
 
  To compile a plugin for Gaim, you must have Gaim's source code. There are two
  ways to get this: Tarballs, and CVS. To work with a tarball, follow the
  instructions below. To use CVS, follow the instructions on the CVS (http://
  gaim.sf.net/cvs.php) page. Please note that often, CVS is much less stable
  than the tarballs! Do not use CVS unless you are writting a patch.
d924 4
a927 2
  To work with a tarball, download the latest source code from http://
  gaim.sf.net/ and untar it with the command:
d929 16
a945 1

d948 1
a948 1
  After you have a Gaim source code tree, either through tarballs or CVS:
a950 1

a951 1

a956 1

a957 1

d968 1
a968 1
13.3  I have a plugin or perl script for Gaim that does not work with 0.60 or
d970 1
a970 1
 
d973 5
a977 3
  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.
a978 2
13.4  Where can I find documentation on writing plugins and Perl scripts?
 
d980 4
a983 1
  HOWTO file for C plugins and a PERL-HOWTO for Perl scripts.
d985 2
a986 3
  In 0.68 or later, get the source code and run make docs. You will need
  doxygen and graphviz dot installed for this to work. This will produce an api
  reference and both the perl and plugin documentation.
d989 1
a989 1
| 14. Development
d992 20
a1011 2
14.1  Where should I report bugs?
 
d1014 1
a1014 6
14.2  Gaim never leaves a core file.
 
  On most installs, for some odd reason, core files are limited in size to 0
  bytes, and so are not created. To rectify this situation, add ulimit -c
  unlimited to your startup scripts or run it manually in a terminal before
  starting gaim from that terminal.
a1015 2
14.3  Where should I submit patches?
 
d1018 2
a1019 2
14.4  Did you guys reverse engineer it?
 
a1023 4
14.5  Will Gaim be ported to Windows 95/98/Me/2000/XP?
 
  Gaim has released a Windows version.

d1025 1
a1025 1
| 15. Misc. Questions
d1028 1
a1028 3
15.1  Does AOL's attempts at blocking Trillian affect Gaim?
 
  No.
d1030 2
a1031 4
15.2  Is Gaim affected by the vulnerability found in Windows AIM or Yahoo
      Instant Messenger clients?
 
  No.
d1033 1
a1033 4
15.3  Can I IM you guys?
 
  Sure! Look at the Contact Information (http://gaim.sf.net//contactinfo.php)
  page!
a1034 2
15.4  Hello?
 
d1037 1
a1037 1
15.5  Can I give you money/hardware/other expensive things that can be hocked
d1040 1
a1040 1
 
d1045 2
a1046 2
15.6  Does Gaim support secure instant messaging (encrypted IMs)?
 
d1054 7
a1060 5
  The gaim-e project (http://gaim-e.sourceforge.net/) is working on developing
  a secure IM framework that uses the GnuPG and the OpenPGP trust model for
  authentication. If you are serious about secure instant messaging, read the
  documentation on the "web of trust" model available at http://www.gnupg.org/
  and try out gaim-e.
a1061 2
15.7  Why are the passwords in accounts.xml not encrypted?
 
d1065 2
a1066 2
15.8  What is gaim-remote?
 
d1072 2
a1073 2
15.9  When will the next version of Gaim be released?
 
@


1.27
log
@i never remember to update this anyway
@
text
@d3 1
a3 92
1  Compiling
	1.1  Is there some way I can compile just Gaim, without all of
	     these protocols?
	1.2  I'm getting an error: ./au2h.c BuddyArrive.h open: No such
	     file or directory
	1.3  I compiled Gaim, but when I restart, it did not update.
	1.4  I can't compile Gaim CVS.
	1.5  I have a question about GTK2.

2  Using Gaim
	2.1  How do I register for a new account?
	2.2  Why is gaim crashing when somebody sends me an IM?

3  Features
	3.1  How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu, Napster, or Zephyr?
	3.2  Can Gaim send files?
	3.3  When will file transfer be supported? Is it being worked on?
	3.4  How come there's no Export Buddy List?
	3.5  Will Gaim save my buddy list to the server?
	3.6  Can Gaim import my buddy list?
	3.7  Can I set a buddy icon?

4  ICQ Protocol
	4.1  How do I use ICQ?
	4.2  ICQ doesn't work.

5  AIM/ICQ (Oscar) Protocol
	5.1  Some of my buddies are not showing up as online, why is that?
	5.2  IM Image doesn't work, why?
	5.3  I sent an IM Image, but only a blank line shows up, why?

6  IRC Protocol
	6.1  Why am I getting disconnected when I try to connect to IRC?

7  Jabber Protocol
	7.1  How do I choose which Jabber server to use?
	7.2  How do I change my Jabber resource to be other than the
	     default of "/GAIM"?
	7.3  How do I register a new Jabber account?
	7.4  How do I use invisibility?
	7.5  I've a buddy that I keep removing from my buddy list, but
	     he keeps coming back!  How can I stop this?
	7.6  What does "Remove From Roster" do?
	7.7  What does "Cancel Presence Notification" do?

8  Scripts and Plugins
	8.1  Where can I find documentation on writing plugins and
	     Perl scripts?
	8.2  How do I compile a plugin for Gaim?

9  Development
	9.1  Where should I report bugs?
	9.2  Where should I submit patches?
	9.3  Did you guys reverse engineer it?
	9.4  Will Gaim be ported to Windows 95/98/Me/2000/XP?
	9.5  Will there be a QT dock app?

10  Misc. Questions
	10.1  Does AOL's attempts at blocking Trillian affect Gaim?
	10.2  Is Gaim affected by the vulnerability found in Windows
	      AIM or Yahoo Instant Messenger clients?
	10.3  Can I IM you guys?
	10.4  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?


+--------------------------------------------------------------------------
| 1  Compiling
+--------------------------------------------------------------------------

1.1  Is there some way I can compile just Gaim, without all of
     these protocols?

  Sort of, yeah. There's actually two ways to do it.

	1.  Use the --with-static-prpls option to ./configure along with
	    --disable-plugins. This will let you choose which protocols are
	    compiled in with Gaim, but you will not be able to use any other
	    protocols or plugins.

	    You'll need to compile any protocols that you specified in
	    --with-static-prpls. Oscar and TOC are defaults.

	2.  Change to the directories for the protocols you
	    want to compile (e.g. src/protocols/jabber), and
	    run make from there. Then after you've compiled all
	    of them, change back to src/ and run make gaim.


1.2  I'm getting an error:
d5 156
a160 2
     ./au2h.c BuddyArrive.h
     open: No such file or directory
d162 2
a163 1
  You're not using gmake, are you? You need to be using gmake
d165 2
a166 22

1.3  I compiled Gaim, but when I restart, it did not update.

  If you previously had an rpm or a Debian package installed, you need to
  remove that first. When you restart Gaim, it will give some errors about
  your plugins. This is normal. Simply go into the Plugins dialog
  (Tools->Plugins) and reload them. These errors will only happen once.


1.4  I can't compile Gaim CVS.

  Make sure you have gettext <= 0.10.40 or gettext >= 0.11.3, autoconf 2.11
  or 2.53, and automake 1.4px. If you are still having problems, make sure
  that your gettext package includes the program gettextize (for gettext <=
  0.10.40) or autopoint (for gettext >= 0.11.3). If it does not, look for
  another package.

  We don't support gettext 0.11.0 through 0.11.2. It may work for you, but
  we make no promises.

  If you are using autoconf 2.50+, do not use a version of gettext lower
  than 0.10.39. You will get errors in the po/ directory. 
d169 46
a214 3
  automake, gettext, and libtool. You also have to copy the contents of
  /usr/local/share/aclocal to /usr/share/aclocal. This is due to bugs in
  Slackware and the auto* packages.
d216 1
d218 34
a251 8
1.5  I have a question about GTK2.

  Don't ask untill the changelog says it works.


+--------------------------------------------------------------------------
| 2  Using Gaim
+--------------------------------------------------------------------------
d254 1
a254 1

d257 2
a258 5
	AIM: Go to http://aim.AOL.com/aimnew/Aim/register.adp.

	ICQ: Go to http://web.icq.com/register.

	Yahoo: Go to http://edit.yahoo.com/config/eval_register.
d260 1
a260 1
	MSN: Go to http://registernet.passport.com.
d262 1
a262 1
	Gadu-Gadu: Use the official client to create an account.
d264 1
a264 2
	Jabber: See the question "How do I register a new Jabber account?"
	        below.
d266 61
d328 2
a329 2
2.2  Why is gaim crashing when somebody sends me an IM?

d331 11
a341 3
  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.
d343 1
a343 1
  If you are using a version newer than 0.55 and gaim still crashes, please
d346 162
a507 64

+--------------------------------------------------------------------------
| 3  Features
+--------------------------------------------------------------------------

3.1  How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu, Napster, or Zephyr?

  First load the plugin. Protocol plugins come with Gaim, so just go to the
  Plugins dialog (Tools->Plugins, or the Plugins button on the start
  screen) and then click "Load." The protocol plugins are named
  lib<protocol>.so, so MSN for instance is provided by libmsn.so.

  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.


3.2  Can Gaim send files?

  TOC can, in a limited way. Most protocols are capable of it, but Gaim
  hasn't implemented anything yet.


3.3  When will file transfer be supported? Is it being worked on?

  File transfer is not currently being worked on. It will be supported if
  someone writes a patch using a generic user interface and without adding
  any GTK+ to the protocol plugins.


3.4  How come there's no Export Buddy List?

  It would be the same as the cp command. Gaim stores your buddy list in
  the $HOME/.gaim directory. You can copy it out of there.


3.5  Will Gaim save my buddy list to the server?

  Gaim already does this in MSN, Yahoo, and TOC. As of version 0.53, this
  support exists for Oscar as well. Improved Jabber support is being worked
  on.


3.6  Can Gaim import my buddy list?

  This depends on the format of the buddy list. Gaim cannot import Licq
  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.


3.7  Can I set a buddy icon?

  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.


+--------------------------------------------------------------------------
| 4  ICQ Protocol
+--------------------------------------------------------------------------
d510 5
a514 6

  ICQ support is part of the OSCAR protocol, labeled AIM/ICQ in gaim (see
  the question "ICQ doesn't" work for why). To use it, simply put your
  account number in the ScreenName box and your password in the password
  box. Leave the server settings alone. 

d517 1
a517 1

d519 24
a542 4
  protocol. The newer versions are extensions of Oscar, which is labled
  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.
d544 8
d553 2
a554 6
+--------------------------------------------------------------------------
| 5  AIM/ICQ (Oscar) Protocol
+--------------------------------------------------------------------------

5.1  Some of my buddies are not showing up as online, why is that?

d556 3
a558 3
  buddy list. This number is currently 200. 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 more
d562 4
a565 5
  Unfortunately, Gaim 0.53 had a bug that caused it to corrupt some
  entries, especially group names. While this corruption doesn't show in
  gaim unless you remove the SCREENNAME.0.blist file from ~/.gaim, it does
  affect how long the server thinks your list is. The best way to fix this,
  is to:
d567 1
a567 1
mv ~/.gaim/SCREENNAME.0.blist ~/
d570 100
a669 36
  signon, delete all groups, signoff, and signon again to verify that your
  list is empty. Once it is empty, signoff, mv your SCREENNAME.0.blist file
  back into ~/.gaim, then sign on again.


5.2  IM Image doesn't work, why?

  IM Image is very sensitive, even from windows. Gaim currently only
  supports sending IM Images if the sender is not behind a firewall or nat
  device.  Given that the windows version of AIM also has trouble in this
  situation, we are not sure this is entirely fixable. A work around that
  is sometimes effective is to have the reciever, not being behind a
  firewall, request a direct connection, then send the immage.


5.3  I sent an IM Image, but only a blank line shows up, why?

  You need to have gdk-pixbuf installed to send IM Images, if the reciever
  is also using gaim, [s]he also needs to have this installed.


+--------------------------------------------------------------------------
| 6  IRC Protocol
+--------------------------------------------------------------------------

6.1  Why am I getting disconnected when I try to connect to IRC?

  You will be disconnected if the nickname you chose is already in use on
  that IRC server. Try again with a different nickname.


+--------------------------------------------------------------------------
| 7  Jabber Protocol
+--------------------------------------------------------------------------

7.1  How do I choose which Jabber server to use?
d671 2
d674 2
a675 6
  somebody@@server.name. So when entering your Jabber "screen name", the
  server is specified as part of your JID.


7.2  How do I change my Jabber resource to be other than the default of
     "/GAIM"?
d677 3
d681 1
a681 4
  identifier to your Jabber I.D. For example: somebody@@server.name/resource 


7.3  How do I register a new Jabber account?
d683 2
d687 10
a696 15
	1. Click "Tools->Accounts->Add"
	2. Select "Jabber" for the protocol.
	3. Fill in screen name and password as you normally would.
	4. Check the "Register with server" check-box
	5. Click "OK".

  A pop-up will tell you whether the registration succeeded or not.

  Note: 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.


7.4  How do I use invisibility?
d698 2
d705 9
a713 10
  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.

    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.
d717 3
a719 3
  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.
d724 2
a725 15
  Gaim currently does not retain invisibility settings between logins,
  just as it doesn't currently retain "away" status.


7.5  I've a buddy that I keep removing from my buddy list but the entry
     keeps coming back every time I log in again!  How can I stop this?

  As of Gaim version 0.59 and later: Select the Edit Buddies tab, right-
  click on the offending entry, and select "Remove From Roster."


7.6  Can I remove a buddy from my Jabber roster entirely?

  As of Gaim version 0.59 and later: yes.  In the Edit Buddies tab, right-
  click on a buddy and Select "Remove From Roster."
d727 17
a743 5
  The buddy will disappear from your buddy list and also will no longer
  receive presence notifications from you.


7.7  What does "Cancel Presence Notification" do?
d745 2
d748 123
a870 17
  right-clicking on a buddy entry in the Edit Buddies tab, prevents that
  Jabber I.D. from receiving future presence notifications when you log on
  to the server.

  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.


+--------------------------------------------------------------------------
| 8  Scripts and Plugins
+--------------------------------------------------------------------------

8.1  Where can I find documentation on writing plugins and Perl scripts?

  If you look in the plugins/ directory in the Gaim source, you should see
  a HOWTO file for C plugins and a PERL-HOWTO for Perl scripts.
d872 2
d875 1
a875 12
8.2  How do I compile a plugin for Gaim?

  To compile a plugin for Gaim, you must have Gaim's source code. There are
  two ways to get this: Tarballs, and CVS. To work with a tarball, follow
  the instructions below. To use CVS, follow the instructions on the CVS
  page.  Please note that normally, CVS is much more stable than the
  tarballs!

  To work with a tarball, download the latest source code from
  http://gaim.sf.net/ and untar it with the command:

	tar zxvf filename
d881 1
a881 11
	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:
d883 1
a883 1
	   make name.so
d885 68
a952 52
	   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
	   nstead of name.so, it won't work.

	5. After make finishes, you can move the plugin to a place that is more
	   convenient. $prefix/lib/gaim is suggested. If you installed Gaim by
	   compiling it yourself, $prefix is /usr/local by default. Otherwise,
	   $prefix is /usr.


+--------------------------------------------------------------------------
| 9  Development
+--------------------------------------------------------------------------

9.1  Where should I report bugs?

  http://gaim.sf.net/bug.php


9.2  Where should I submit patches?

  http://gaim.sf.net/patches.php


9.3  Did you guys reverse engineer it?

  TOC, Jabber, MSN, Napster, and IRC are published protocols, so we didn't
  have to reverse engineer those. Oscar, ICQ, and Yahoo are not published,
  and were reverse engineered by other people.


9.4  Will Gaim be ported to Windows 95/98/Me/2000/XP?

  When GTK+ 2.0 comes out and compiles well against Cygwin, and Gaim has
  been ported to it, Gaim should work. It will not happen before GTK+ 2.0
  is ported to Windows, though.


9.5  Will there be a QT dock app?

  Right now Gaim, is done entirely in C and GTK+, so a QT dock app is not
  in planned. You can either write a patch to do this yourself, or wait
  until the core and UI of Gaim are split. A QT UI will probably be
  considered at that time.


+--------------------------------------------------------------------------
| 10  Misc. Questions
+--------------------------------------------------------------------------

10.1  Does AOL's attempts at blocking Trillian affect Gaim?
d954 2
d958 1
a958 2

10.2  Is Gaim affected by the vulnerability found in Windows AIM or Yahoo
d960 1
a960 1

d963 16
d980 35
a1014 14
10.3  Can I IM you guys?

  Sure! Look at the Contact Information
  (http://gaim.sf.net/contactinfo.php) page!


10.4  Can I give you money/hardware/other expensive things that can be
      hocked for cash what with you all being students/full-time-workers
      and helping to produce this wonderful software instead of
      studying/sleeping?

  No. We're completely fool-hardy and won't accept any gratuities with no
  strings attached for just being good guys. That and we'd have to share
  with everyone who has submitted patches. ;-)
@


1.26
log
@Updated the FAQ for gettext 0.11.x info.
@
text
@@


1.25
log
@Don't forget Jabber! Jabber is our friend. Unlike that horrible ICQ where
everybody is out to steal your number!!

No, I'm not bitter. Why?
@
text
@d112 4
a115 3
  Make sure you have gettext <= 0.10.40, autoconf 2.11 or 2.53, and
  automake 1.4px. If you are still having problems, make sure that your
  gettext package includes the program gettextize. If it does not, look for
d117 6
@


1.24
log
@Updated the FAQ.
@
text
@d17 1
a17 1
	3.1  How do I use MSN, Yahoo, IRC, Gadu-Gadu, Napster, or Zephyr?
d165 1
a165 1
3.1  How do I use MSN, Yahoo, IRC, Gadu-Gadu, Napster, or Zephyr?
@


1.23
log
@Slight fix.
@
text
@d55 4
a58 3
	9.2  Did you guys reverse engineer it?
	9.3  Will Gaim be ported to Windows 95/98/Me/2000/XP?
	9.4  Will there be a QT dock app?
d451 6
a456 1
9.2  Did you guys reverse engineer it?
d463 1
a463 1
9.3  Will Gaim be ported to Windows 95/98/Me/2000/XP?
d470 1
a470 1
9.4  Will there be a QT dock app?
@


1.22
log
@Added support for Jabber invisibility.
@
text
@d43 1
a43 1
        7.5  I've a buddy that I keep removing from my buddy list, but
@


1.21
log
@Chip is making a commit!

This makes the FAQ basically identical to the one on the website. I'll look
through the old version in the gaim/docs dir soon and see if some things
should be salvaged and merged into the new one and the website.
@
text
@d42 5
d328 59
@


1.21.2.1
log
@Synced the FAQ.
@
text
@d17 1
a17 1
	3.1  How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu, Napster, or Zephyr?
a41 5
	7.4  How do I use invisibility?
	7.5  I've a buddy that I keep removing from my buddy list, but
	     he keeps coming back!  How can I stop this?
	7.6  What does "Remove From Roster" do?
	7.7  What does "Cancel Presence Notification" do?
d50 3
a52 4
	9.2  Where should I submit patches?
	9.3  Did you guys reverse engineer it?
	9.4  Will Gaim be ported to Windows 95/98/Me/2000/XP?
	9.5  Will there be a QT dock app?
d106 3
a108 4
  Make sure you have gettext <= 0.10.40 or gettext >= 0.11.3, autoconf 2.11
  or 2.53, and automake 1.4px. If you are still having problems, make sure
  that your gettext package includes the program gettextize (for gettext <=
  0.10.40) or autopoint (for gettext >= 0.11.3). If it does not, look for
a110 6
  We don't support gettext 0.11.0 through 0.11.2. It may work for you, but
  we make no promises.

  If you are using autoconf 2.50+, do not use a version of gettext lower
  than 0.10.39. You will get errors in the po/ directory. 

d159 1
a159 1
3.1  How do I use MSN, Yahoo, Jabber, IRC, Gadu-Gadu, Napster, or Zephyr?
a324 59
7.4  How do I use invisibility?

  Jabber invisibility support is available in Gaim version 0.60 and later.

  There are two ways to use Jabber invisibility: on a per-buddy and on a
  per-server basis.

  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.

    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.

  To use per-server invisibility: click "Tools -> 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.

  You can set yourself invisible per-server and subsequently make yourself
  visible to selected buddies only.

  Gaim currently does not retain invisibility settings between logins,
  just as it doesn't currently retain "away" status.


7.5  I've a buddy that I keep removing from my buddy list but the entry
     keeps coming back every time I log in again!  How can I stop this?

  As of Gaim version 0.59 and later: Select the Edit Buddies tab, right-
  click on the offending entry, and select "Remove From Roster."


7.6  Can I remove a buddy from my Jabber roster entirely?

  As of Gaim version 0.59 and later: yes.  In the Edit Buddies tab, right-
  click on a buddy and Select "Remove From Roster."

  The buddy will disappear from your buddy list and also will no longer
  receive presence notifications from you.


7.7  What does "Cancel Presence Notification" do?

  This selection, available in Gaim version 0.60 and later, and found by
  right-clicking on a buddy entry in the Edit Buddies tab, prevents that
  Jabber I.D. from receiving future presence notifications when you log on
  to the server.

  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.


d386 1
a386 6
9.2  Where should I submit patches?

  http://gaim.sf.net/patches.php


9.3  Did you guys reverse engineer it?
d393 1
a393 1
9.4  Will Gaim be ported to Windows 95/98/Me/2000/XP?
d400 1
a400 1
9.5  Will there be a QT dock app?
@


1.20
log
@"God I'm stoned." -- "Kermit the Frog"
"God I'm drunk." -- Eric Warmenhoven
@
text
@d3 8
a10 9
1  The Basics
	1.1  What does 'gaim' stand for?
	1.2  Where are my log files stored?
	1.3  What are GtkHTML and GtkIMHtml, and why not just use GNOME's
	     GtkHTML?
	1.4  How do I load plugins/perl scripts?
	1.5  I'm not a native English speaker and I would like a translated
	     version of gaim.
	1.6  Why can I import my buddylist but not export it?
d12 3
a14 6
2  Multiple Connections
	2.1  What do you mean by "multiple connections"?
	2.2  How do I sign on more than one account?
	2.3  How do buddy lists work for multiple connections?
	2.4  What's a PRPL?
	2.5  How do I use a different protocol?
d16 8
a23 10
3  About the Protocols (what they support, and how to do things with them)
	3.0  Introduction
	3.1  TOC
	3.2  Oscar
	3.3  Yahoo!
	3.4  IRC
	3.5  ICQ
	3.6  MSN
	3.7  Jabber
	3.8  Napster
d25 3
a27 5
4  Problems
	4.1  Sound doesn't work
	4.2  Clicking on URLs doesn't open Netscape
	4.3  I don't use Netscape
	4.4  I have a bug not described here
d29 4
a32 4
5  Programming
	5.1  I have a patch for gaim!
	5.2  I have a plugin/perl script for gaim!
	5.3  Can you teach me how to program GTK?
d34 2
a35 13
6  Miscellaneous
	6.1  Can I talk to you on IM?
	6.2  I want to write an IM client. Will you help me?
	6.3  I have money. I need software written. Can you help?
	6.4  I have hardware here that's not being used. Can you use it?
	6.5  I would like to send you beer.
	6.6  Are you going to port this to Windows?
	6.7  Why no AOL logo?
	6.8  Why the GPL?
	6.9  What is a wagii?
	6.10 What window manager/distribution/other crap do you use?
	6.11 Is XX a good hard drive, YY a good monitor and ZZ a good CPU?
	6.12 I want to contribute to the effort. Where can I send beer to?
d37 5
a41 1
---
d43 4
a46 1
1  The Basics
d48 5
a52 1
1.1  What does 'gaim' stand for?
d54 9
a62 3
It's basically the letter 'g' tacked on to the beginning of 'AIM' (which is
fairly obvious). G stands for all sorts of good things. Girls, Godzilla, GTK,
graham crackers, whatever.
a63 1
1.2  Where are my log files stored?
d65 3
a67 2
Your logs are stored in $HOME/.gaim/logs/. They had previously been stored in
$HOME/.gaim/YourScreenName/ (e.g. $HOME/.gaim/EWarmenhoven).
d69 2
a70 1
1.3  What are GtkHTML and GtkIMHtml, and why not just use GNOME's GtkHTML?
d72 1
a72 4
The widget Gaim had previously used to display HTML was called GtkHTML, and
was written by Mark and Jim specifically for Gaim. Over time, Rob and Eric
hacked at it (read: broke it) and it's gotten to be very fragile and fairly
buggy.
d74 4
a77 4
One day Eric got pissed off at GtkHTML and decided to rewrite it, and called
it GtkIMHtml (IM to indicate that it should be used in IM clients). He made
it its own separate project, so that other IM clients (like Jabber clients)
could use it. He based it somewhat off of the old GtkHTML and GNOME's GtkHTML.
d79 2
a80 6
GNOME's GtkHTML is a very powerful HTML viewer. Because of this, it isn't
well-suited for Gaim. It wouldn't be very good if we let you have IFrames in
your conversation, for example. Also, GNOME's GtkHTML depends on a lot of
GNOME libraries that we don't want to force people to use in Gaim. (There is
a strip-down version, CSCHTML, which doesn't use the GNOME libraries; but the
first objection (that it supports too many tags) still applies.)
d82 4
a85 1
1.4  How do I load plugins/perl scripts?
a86 8
Plugins you had loaded when you quit gaim are loaded again when you start
gaim. To load a new plugin, either click 'Plugins' on the login screen, or
select 'Plugins' from the 'Tools' menu in the buddy list. From there, you
can load and unload plugins, and configure certain ones. If you click on
the 'Load Plugin' button, it will present you with a file dialog, asking
which file you want to load; it will default to looking for a .so file in
the directory plugins get installed to, though you don't have to load a .so
file, and you don't have to load it from that directory.
d88 1
a88 5
When you start gaim, all the .pl files in ~/.gaim will be loaded
automatically. You can also load new scripts from the 'Perl' menu in 'Tools'.
From that menu, you can load a new script (similarly to how you loaded a
plugin above), unload all your loaded scripts, and list which scripts you have
loaded.
d90 2
a91 2
1.5  I'm not a native English speaker and I would like a translated version of
gaim.
d93 1
a93 4
Gaim currently has a few translations (French, Spanish, Korean, and Simplified
Chinese); however, most of them are out of date. If you would like to update
or add a translation of gaim, email or IM either Rob or Eric and they can tell
you how to go about it.
a94 1
1.6  Why can I import my buddylist but not export it?
d96 1
a96 5
Because you don't have to.  Gaim, out of the kindness of its sweet little 
heart, automagically exports your buddylist for you.  You can find a copy
of your list in ~/.gaim/YOURNAME.PROTO.BLIST.  For example, if you're
using AIM, and your name is JoeUser, then your buddy list could be found
in: ~/.gaim/JOEUSER.0.blist.
d98 4
a101 1
2  Multiple Connections
a102 1
2.1  What do you mean by "multiple connections"?
d104 1
a104 3
Multiple Connections means that it's possible to connect to the AOL servers
using more than one screenname at a time. It's just a way of not having to run
three copies of gaim for each of your screennames.
d106 4
a109 1
2.2  How do I sign on more than one account?
d111 4
a114 7
The Account Editor controls all of your accounts, and lets you add, delete,
modify, and sign on/off accounts. It is accessible from the login window or
from the 'Tools' menu in the buddy list as 'Accounts'. Simply highlight the
account you want to sign on, and click the 'Sign On/Off' button. To sign on
another account, highlight it and click the 'Sign On/Off' button. There is a
column labeled 'Currently Online' to let you know if the account is online or
not.
a115 1
2.3  How do buddy lists work for multiple connections?
d117 1
a117 5
"The same as they did before" is the simple answer. Each account you have will
have its own buddy list, which you can add buddies to and remove from. In the
'Edit Buddies' tab of your buddy list, you'll see the name of each of your
online accounts (unless if you only have one), with its buddy list nested
underneath it.
d119 1
a119 1
2.4  What's a PRPL?
a120 4
PRPL stands for Protocol Plugin. It's a way to dynamically add new protocols
to gaim. This allows you to use gaim as your AIM, ICQ, Yahoo, and even IRC
client, all at the same time. Loading a PRPL is just like loading any other
plugin - simply load the .so file from the plugins dialog.
d122 3
a124 1
2.5  How do I use a different protocol?
d126 1
a126 7
In the Account Editor,  click the 'Add' button to add a new account. Below the
password entry, you should see a menu labeled 'Protocol', with a list of the
protocols available for you to use. (If you don't see the protocol you want to
use, make sure you have the proper PRPL loaded.) Enter in your username (for
ICQ this should be your UIN) and password, and you're set. You can then sign
the account on by clicking the 'Sign On/Off' button when the account is
highlighted.
d128 1
d130 1
a130 1
3  About the Protocols (what they support, and how to do things with them)
d132 1
a132 1
3.0  Introduction
d134 1
a134 3
This really only describes the protocol, and how gaim is able to use it. For
a listing of what gaim has implemented with each protocol, please read the
STATUS file.
d136 1
a136 1
3.1  TOC
d138 1
a138 5
TOC is an open protocol (meaning that there's open documentation from the
people who developed it), developed by AOL, for clients to use to connect to
the AIM server. It has stopped being supported by AOL (though they do still
make changes to the TOC server). It is a strip-down and simplified version of
their "real" protocol, Oscar.
d140 2
a141 4
TOC is a TCP protocol, and will only ever make one TCP connection (unless if
you accept a file transfer request). Your buddy list is stored on the server,
and gaim keeps a locally cached copy as well. When you sign on the server and
local lists are merged.
a142 1
3.2  Oscar
d144 1
a144 4
Oscar is the protocol that the Windows version of AIM uses (and actually,
ICQ2000 uses it too). It's a closed protocol, meaning that in order for gaim
to use it, someone had to reverse-engineer it. For gaim, the libfaim authors
did this, and wrote a library so that we could use it.
d146 4
a149 6
Oscar is a TCP protocol, but it makes several connections: the authorizor (the
initial connection, who you send your screenname/password to), the BOS (which
is the "main" connection, through which all your messages go), ChatNav (which
lets you join chat rooms), as well as one for each chat room you join. Oscar
does let you store your buddy list on the server, but libfaim hasn't added
that functionality yet.
d151 2
a152 1
3.3  Yahoo!
a153 5
Yahoo! uses a closed protocol; the authors of libyahoo reverse-engineered it
and gaim uses that library. It is a TCP protocol, and makes several
connections, though I'm not entirely sure at which points. It stores your
buddy list on the server, and gaim keeps a locally cached copy. When you sign
on the server and local lists are merged.
d155 3
a157 1
3.4  IRC
d159 1
a159 3
IRC is an open protocol (though I've heard that some servers deviate slightly
from it). It's a TCP protocol, and will only ever make one connection (outside
of DCC connections).
d161 4
a164 1
3.5  ICQ
d166 3
a168 6
ICQ is a closed protocol, though there have been several groups of people who
have reverse-engineered it, and there are several libraries available. Gaim
uses icqlib (which supports multiple connections, as opposed to libicq, which
does not). It is a mix of UDP and TCP: the connection to the server is UDP,
and conversations are TCP unless if they are sent through the server. This
means you'll make one UDP connection, and possibly very many TCP connections.
a169 1
3.6  MSN
d171 1
a171 2
MSN is a weird TCP protocol written by Microsoft.  It requires multiple
connections and is a real headache :).
d173 2
a174 1
3.7  Jabber
a175 8
Jabber is an open protocol, developed by the Jabber team, and is XML-encoded.
It is a TCP protocol, and you will only ever make one TCP connection. Jabber
has a feature it calls 'transports', where the server tells you which services
it has available (such as AIM or ICQ), and you tell it which service you would
like to use. This way you can have only one connection, but be connected to
AIM and ICQ (among others) several times. Anyone who gives a damn about Open
Source, especially open messaging, should use Jabber. They have the only Open
Source IM server.
d177 1
a177 1
3.8  Napster
d179 3
a181 9
Napster is, as you know, the protocol used by that wonderful little program
called napster.  You know the one!  It's what millions of college kids across
america are using to sastisfy their longing for music :-D.  Anyways, gaim supports
it.  It's kind of fiunky, though. Napster is a TCP protocol and only requires one
connection to the server.  All file transfers, however, are explicitly client to
client.  The plugin currently only supports one way file transfer (downloading)
from people who are _not_ firewalled.  You can also send private messages to each
other, join chat rooms, browse a user's files, and search.  More implementation
coming soon.
a182 1
4  Problems
d184 1
a184 1
4.1  Sound doesn't work
d186 2
a187 5
./configure should autodetect whether or not you have ESD libraries. If you
have them it will compile with them; if not it won't. If it compiles with them
you don't need to be running the ESD daemon; it'll automatically fall back to
using /dev/dsp. Make sure gaim has the proper permissions to talk to /dev/dsp
and /dev/audio though!
a188 1
4.2  Clicking on URLs doesn't open Netscape
d190 1
a190 2
Netscape either needs to be running on the current display (though gaim should
handle remote netscape windows OK), or 'netscape' needs to be in your path.
d192 3
a194 1
4.3  I don't use Netscape
a195 3
There's the option to manually enter which browser you'd like to use. We're
interested in supporting browsers other than Netscape though; send us some
information about how to send a URL to your browser (source is nice :) ).
d197 1
a197 1
4.4  I have a bug not described here
d199 4
a202 2
We have a page at http://sourceforge.net/projects/gaim/, and from there you
can report your bug.
d205 1
a205 1
5  Programming
d207 6
a212 1
5.1  I have a patch for gaim!
a213 3
Great! Send it over to the Patches section on our sourceforge page,
http://sourceforge.net/projects/gaim/. From there we'll take a look at it (no
promises that it'll get in, but we'll at least take a look at it).
d215 3
a217 1
5.2  I have a plugin/perl script for gaim!
d219 1
a219 4
Great! Post it to the Patches section on our sourceforge page, and mark it as
a plugin. Then other people will be able to see it and use it. (Make sure that
you understand that your plugin is necessarily GPL'd, and you must provide
source to your plugin.)
d221 4
a224 1
5.3  Can you teach me how to program GTK?
a225 3
Actually, I can't. I'm a very bad teacher. I'm much too impatient. There is a
really great tutorial and API reference on the GTK website though,
http://www.gtk.org/. That's how I learned, anyway.
d227 1
d229 5
a233 1
6  Miscellaneous
a234 1
6.1  Can I talk to you on IM?
d236 3
a238 7
Sure. Our IM names can be found in the AUTHORS file. Keep in mind though that
we're busy people. We use those screennames as our main screen names, not just
to talk to gaim users. So please, don't IM us for us to answer questions about
Linux. We'd like to be able to answer everyone's questions, but we just don't
have the time. We aren't paid to hack gaim; we do have other jobs.  Also,
please don't waste our time with a simple "hi" or "hello."  Don't ask if
you can ask a question, just ask it.  We'll usually respond.
d240 1
a240 1
6.2  I want to write an IM client. Will you help me?
d242 5
a246 1
I'll give you advice, but other than that, no (unless you'd like to pay me).
d248 6
a253 1
6.3  I have money. I need software written. Can you help?
d255 1
a255 2
Oh yes. Our email addresses are bj91704@@binghamtom.edu (SeanEgn) and
rob@@marko.net (RobFlynn).
d257 4
a260 1
6.4  I have hardware here that's not being used. Can you use it?
a261 2
Most certainly. IM me or email me and I'll tell you where you can ship it to
(I might be able to scratch together shipping money even).
d263 1
a263 1
6.5  I would like to send you beer.
d265 6
a270 1
OK.
a271 1
6.6  Are you going to port this to Windows?
d273 1
a273 2
No. If you'd like to work on a port help yourself; but I really really dislike
Windows (in all its closed-source evilness).
d275 2
a276 1
6.7  Why no AOL logo?
a277 1
AOL's legal staff told us no-no.
d279 3
a281 1
6.8  Why the GPL?
d283 1
a283 1
I like the GPL.
d285 2
a286 1
6.9  What is a wagii?
a287 5
Interesting question that you ask, there. 'Wagii' is the official celebratory
cry of gaim. Anytime you are feeling happy or excited, just remember all of
the hard work that we have done to provide you with this wonderful, free piece
of software -- as the pure, raw, emotion flows through you, maybe you too will
let out the cry of -- Wagii.
d289 3
a291 1
It is also the sound a Penguin Samurai makes :)
d293 1
a293 1
6.10 What window manager/distribution/other crap do you use?
d295 3
a297 3
Rob uses Red Hat, with Ximian GNOME on top.  I dont really like Ximian but I like
Gnome.  On top of my Ximian Gnome is Sawfish.  Eric hates saw fish.  I kinda of
like it even though it makes me mad. 
a298 3
Eric uses debian woody. He uses Enlightenment as his window manager; though
the only reason it would seem that Eric uses X at all is to support having
his 20 Eterms and 4 Mozilla windows open. Oh yeah, and gaim_applet.
d300 2
a301 1
6.11 Is XX a good hard drive, YY a good monitor and ZZ a good CPU?
d303 2
a304 1
You could send us one and we could tell you... :)
a305 1
6.12 I want to contribute to the effort. Where can I send beer to?
d307 131
a437 1
IM RobFlynn or email him at rob@@marko.net.
@


1.19
log
@I got an itty bitty diff for you now ;-)
@
text
@d320 1
a320 1
Oh yes. Our email addresses are warmenhoven@@yahoo.com (EWarmenhoven) and
@


1.18
log
@Please stop asking me this. :-)
@
text
@d1 1
a1 1
GAIM: The Pimpin' Penguin IM Clone Thats Good For The Soul
d73 2
a74 2
The widget GAIM had previously used to display HTML was called GtkHTML, and
was written by Mark and Jim specifically for GAIM. Over time, Rob and Eric
d84 1
a84 1
well-suited for GAIM. It wouldn't be very good if we let you have IFrames in
d86 1
a86 1
GNOME libraries that we don't want to force people to use in GAIM. (There is
@


1.17
log
@I'm EWarmenhoven.
@
text
@d11 1
d115 7
@


1.16
log
@i'm EricWarmenhoven. other misc. things.
@
text
@d68 1
a68 1
$HOME/.gaim/YourScreenName/ (e.g. $HOME/.gaim/EricWarmenhoven).
d312 1
a312 1
Oh yes. Our email addresses are warmenhoven@@yahoo.com (EricWarmenhoven) and
@


1.15
log
@lalal
@
text
@d68 1
a68 1
$HOME/.gaim/YourScreenName/ (e.g. $HOME/.gaim/EWarmenhoven).
d312 1
a312 1
Oh yes. Our email addresses are warmenhoven@@yahoo.com (EWarmenhoven) and
@


1.14
log
@Screw it...
@
text
@d312 2
a313 2
Oh yes. My email address is warmenhoven@@yahoo.com and my screen name is
EWarmenhoven.
@


1.13
log
@lala la
@
text
@d363 1
a363 1
IM RobFlynn or email him at rflynn@@blueridge.net.
@


1.12
log
@blah
@
text
@d302 3
a304 1
have the time. We aren't paid to hack gaim; we do have other jobs.
@


1.11
log
@hrm.
@
text
@d219 2
a220 1
Rob?
d235 9
a243 2
Rob?

d347 3
a349 1
Rob uses Red Hat, with Ximian GNOME on top. Rob?
@


1.10
log
@dum de dum dum,
dum de dum dum duh!
@
text
@d6 1
a6 2
	1.3  Will you be adding a log viewer?
	1.4  What are GtkHTML and GtkIMHtml, and why not just use GNOME's
d8 2
a9 2
	1.5  How do I load plugins/perl scripts?
	1.6  I'm not a native English speaker and I would like a translated
d70 1
a70 11
1.3  Will you be adding a log viewer?

Yes! As a matter of fact, we will be. Here's what needs to happen before then
though:
	GtkIMHtml has to be finished and added to gaim
	The option to not log, and to strip HTML from logs, will be removed
	HTML-matching must be done (e.g. if you get a message "<u>hi", it
		should be logged as "<U>hi</U>" to prevent later logs from
		being underlined)

1.4  What are GtkHTML and GtkIMHtml, and why not just use GNOME's GtkHTML?
d89 1
a89 1
1.5  How do I load plugins/perl scripts?
d106 1
a106 1
1.6  I'm not a native English speaker and I would like a translated version of
@


1.9
log
@updated HACKING to describe gaim_connection/aim_user/prpl.
updated FAQ to answer some questions about multiple connections.
made it so you're not able to send a message in a chat room that you're no longer in (i.e. when you were in the room but sign off)
free'd the buddy list when the connection is destroyed
tried to prevent set_buddy from being called before the buddy list is drawn
i think there was something else
@
text
@d1 1
a1 1
GAIM: The Pimpin' Penguin IM Clone Thats Good For The Soul 
d3 9
a11 369
Welcome to the GAIM FAQ.  Please read this document to insure that you
are not asking us a question that has already been answered.  We will
most likely become slightly irritated with you and will either point
you to this FAQ or ignore you.  Of course, no harm is meant by this.  
We're two college aged kids, we both work and are very short on time.
If you have any comments, praise, or ideas please don't hesitate to 
contact us.  But please, don't initiate a conversation with "Hi" or 
"Can I ask you a question?"  We generally do not respond to these
comments because it takes too much time to get to the point of your
statement.  Simply say what you need to say and you'll more than
likely get a quick response :-). 

I. The Protocol
	1. Is it the same protocol as the Windows client uses?
	2. Where can I find info on TOC?
	3. What other clients use this protocol?
	4. TCP or UDP?
	5. So the buddy list is stored on the server?

II. The Client
	1. What does 'gaim' stand for?
	2. How do I make multiple groups?
	3. How come there's no file transfer?
	4. Why no AOL logo?
	5. Where are my log files stored?
	6. Can I use my Windows 95 Buddylist with Gaim?
	7. I'm not a native English speaker and I would like a translated
	   version of gaim.
        8. I've got a proxy, and I'd like to use GAIM.

III. Multiple Connections
	1. What do you mean by "multiple connections"?
	2. What's a PRPL?
	3. What happens when I load a new protocol?
	4. So how do I add accounts?
	5. This sucks. I want my old gaim back.

IV. Problems
	1. WAAAAAH!  My sound doesn't work!
	2. My buddy list disappeared!
	3. I click on URLs, but Netscape doesn't popup!
	4. I don't use Netscape.
	5. I'm using the GNOME client.  I have a bug. 
	6. I have a bug not described here.
	7. I have Mandrake 6.0 and GAIM doesnt work!

V. Programming
	1. I have a patch for gaim!
	2. I have a plugin for gaim!
	3. Can you teach me how to program GTK?

VI. Miscellaneous
	1. Can I talk to you on IM?
	2. I want to write an IM client.  Will you help me?
	3. I have money.  I need some software written.  Can you help?
	4. I have hardware here that's not being used, or money.  Can 
	   you use it?
	5. I would like to send you beer.
	6. Are you going to port this thing to Windows?
	7. Why the GPL?
	8. I use *BSD and I hate the penguin! I want daemon images!
	9. Can I design a logo for you?
       10. What is a wagii?
       11. Speaking of the penguin, I heard a rumour you have a tattoo of
	   it.  Is that true?
       12. What Window Manager do you use?  What distribution do you use?
	   What other stupid things can you ask me that don't really matter
	   but ya'll ask me anyway?
       13. Is XX a good Harddrive, YY a good monitor and ZZ a good CPU?
       14. Who designed the new logo?	
       15. I want to contribute to the effort.  Where can I send beer to?

I. The Protocol
	1. Is it the same protocol as the Windows client uses?
		No.  The Windows client uses Oscar, which is proprietary
and undocumented.  Some people have used network tools and such to figure
it mostly out -- Look for 'faim'.  We use TOC, which is completely open and
documented. 
		There is some support for libfaim now, which allows gaim to
use Oscar, and it's even becoming usable. Maybe one day it'll be the default
protocol, but it doesn't look like that's going to happen soon.

	2. Where can I find info on TOC?
		In the document called PROTOCOL. It's the version that was
published with AOL's TiK client version 0.75, which appears to be the last
one ever published.

	3. What other clients use this protocol?
		There are a few other Unix programs that use it, I think. I
really couldn't tell you though. AOL used to keep a list of them, but no more.
I think some of them are Everybuddy and Jabber. Oh yeah, TiK is still around.

	4. TCP or UDP?
		TCP.

	5. So the buddy list is stored on the server?
		Yep. Fortunately for you, when the server decides to *not* store
it any more, gaim keeps a cached copy.


II. The Client
	1. What does 'gaim' stand for?
		It's basically the letter 'g' tacked on to the beginning of
'AIM' (which is fairly obvious).  G stands for all sorts of good things. 
Girls, Godzilla, GTK, graham crackers, whatever.

	2. How do I make multiple groups?
		There are two ways: Click the "Group" button in the Edit Buddies
tab of the buddy list; or click the "Add" button and simply enter a new group
name.

	3. How come there's no file transfer?
		There is, it's just that you can't request for the transfer to
take place. Only people who use the Oscar protocol can, so you're out of luck
there. At least you can get and send files.

	4. Why no AOL logo?
		AOL's legal staff told us no-no.

	5. Where are my log files stored?
		After you select `log all conversations' you may be wondering
where your log files are stored. Well, they are currently, by default, stored
under $HOME/.gaim/YourScreenName/.  If your screen name is Zilding then you
will find your logs under: $HOME/.gaim/Zilding/.  This will eventually become
configurable.
	
	6. Can I use my Windows 95 buddylist with Gaim?
		Yes. Thanks to a couple great people (S D Erle and BMiller),
gaim can import your Win95 buddylist. Simply select "Import Buddy List" from
the buddy list window.

        7. I'm not a native English speaker and I would like a translated   
           version of gaim.
		There are a few translations of gaim. If you can do a
translation for us, I'd greatly appreciate it!  Just let me know and I'll
give you detailed instructions on how to do it.
 
	8. I'm behind a proxy, and I'd like to use GAIM.
		HTTP, Socks 4, and Socks 5 proxying should be working now.
None of them support authentication yet though.


III. Multiple Connections
	1. What do you mean by "multiple connections"?
		Multiple Connections means that it's possible to connect to
the AOL servers using more than one screenname at a time. When you connect
using more than one screenname, each name will have their own buddy list. Each
will be able to send messages and do all the normal things. It's just a way of
not having to run 3 copies of gaim for each of your screennames.

	2. What's a PRPL?
		PRPL stands for PRotocol PLugin. It's a way to dynamically add
new protocols to gaim. This allows you to use gaim as your AIM client, ICQ
client, Yahoo, client, and even IRC client, all at the same time. Loading a
PRPL is like loading any other plugin - simply load the file from the plugins
dialog.  Then simply add an account using the Account Editor and have it use
that protocol.

	3. What happens when I load a new protocol?
		Gaim keeps track of all the protocols that it knows about.
When you load a new protocol, it lets you add a new account that uses that
protocol. If you loaded the protocol as a plugin, and remove that plugin, gaim
then signs off any connections that were using that protocol, and forgets
about it. If you load a protocol that has already been loaded, it will unload
the original one and load the new one.

	4. So how do I add accounts?
		There is an Account Editor that is accessible from the main
signon window, and also from the Buddy List Tools menu. This brings up a
window that lets you add and remove accounts, modify them, and sign them on
independently of each other.

	5. This sucks. I want my old gaim back.
		Relax, there's a configure option, --disable-multi, that will
remove any way of having multiple connections from the UI. This gives gaim the
old familiar UI, and allow only one connection at a time. It will also benefit
from all of the features added that are not related to multiple connections
(like reporting idle times based on X usage).


IV. Problems
	1. WAAAAAH!  My sound doesn't work!
		./configure should autodetect whether or not you have ESD
libraries.  If you have them it _WILL_ compile with them, if not it won't. 
If it compiles with them, you don't need to be running the ESD daemon, it'll
automatically fallback to using /dev/dsp.  Make sure that gaim has proper
permissions to talk to /dev/dsp and /dev/audio though!

	2. My buddy list disappeared!
		You didn't back up your buddy list, did you?  You never back
anything up!  Oh well.  The TOC server loses lists from time to time, it
happens to me as well.  (And no, I never have a backup ;).  Gaim should have
kept a cache of your buddy list, though, so you shouldn't have this problem any
more.

        3. I click on URLs, but Netscape doesn't popup!
		Netscape either needs to be running on the current display
(gaim should handle remote netscape windows OK.), or 'netscape' needs to be
in your path.

        4. I don't use Netscape. 
		I'm very interested in supporting other web browsers.  Do
send me information on how to send a URL to your browser remotely (or point
me at the source to the browser, I might be able to figure it out.). 

	5. I'm using the GNOME client.  I have a bug.
		GNOME bugs should be reported to Eric Warmenhoven (IM:
EWarmenhoven (how original)), who is now maintaining that part of the code. If
you ask the other guys about it, they'll just point you at him.
	
	6. I have a bug not described here.
		Well, it could be a few things.  Firstly, you MUST HAVE GTK+
VERSION 1.2.3 installed!  Please state in any bug report that you ARE using
1.2.3, otherwise you have a chance of being ignored.  With that said ;)
head over to our page on Sourceforge, http://sourceforge.net/projects/gaim/.

	7. I have Mandrake 6.0 and GAIM doesnt work!

Bob Meyer <meyer_rm@@yahoo.com> writes:

Here's the solution:
        * Get esound-0.2.12-4mdk.i586.rpm and
          esound-devel-0.2.12-4mdk.i586.rpm from any Mandrake mirror.
        * rpm --upgrade esound-0.2.12-4mdk.i586.rpm
        * rpm -- upgrade esound-devel-0.2.12-4mdk.i586.rpm

Don't use EVIL 'updates' tool.  It's broke.. really bad.

	Mandrake 6.1, with its newer libraries, appears to fix this problem.

V. Programming
	1. I have a patch for gaim!
		Nice.  Think about your patch though.  First, does it have
to do with AIM?  I won't apply patches for stock tickers, search engines,
etc.  Rewrite it as a plug-in if you really want bloat like that. 
Second, is it useful?  A lot of patches I get are horribly unuseful except
in very specific situations (ie YOUR situation).  Thirdly, your code 
will not retain your copyright.  All code submitted must be protected by 
the GPL and the copyright will be given to Mark Spencer.  If you don't 
like this, don't send me your patches.  You will be given authorship credit, 
don't worry -- I just want a homogenous copyright on the program.  Lastly,
does your code match the coding style already present in gaim?  I like my
brackets where I like them.  I do NOT like, in fact I positively HATE, I
DESPISE, with a PASSION, the convention of variablesLikeThis.  And 
functionsLikeThis.  If you do that, fine.  It's great.  But guess what?
This is C.  C programmers don't write like that.  I don't write like that.
I don't want to READ code like that.  I want a homogenous coding style
on this program, and it's gonna be MY coding style. :)
	Now, if you've managed to get through all that and I haven't
discouraged you entirely, send your patches to Rob Flynn (rob@@linuxpimps.com).

	2. I have a plugin for gaim!
		Cool. Before you release it to anyone though, make sure you
understand that if it does anything useful, it is necessarily licenced under
the GPL. It's that whole "code that uses GPL'ed code is thus GPL'ed" clause.
Also, don't send it to us. It's not that we don't want it, but there are
better places to put it. Head over to sourceforge.net and submit it there
<http://sourceforge.net/patch/?group_id=235>. It'll be available more quickly
that way. 

	3. Can you teach me how to program GTK?
		Yes, I can.  But no, I'm not going to. There's a really
nice tutorial at http://www.gtk.org.  If you're a fairly experienced 
programmer, and you get stuck on something odd, IM me, I'm usually happy to
help.  If you had a little BASIC experience in high school and are having
trouble making a button widget do anything when you click it, buy a book on
C and read the damn GTK tutorial, I'm a busy person.


VI. Miscellaneous
	1. Can I talk to you on IM?
		Sure.  My IM name is RobFlynn.  The rest of the crew's IM names
can be found in various places.  Keep in mind though, I'm a very busy person. 
This IM name is used for friends as well as for gaim (I don't just log this
guy in when I want to talk to gaim people).  So please, don't IM me just to
chat, or to answer various Linux questions.  I'd like to be able to answer
everyone's questions on whatever (I usually do know the answer, or at least
where to find it!) but I just don't have time.  Things like this will
usually be ignored.  Other things to keep in mind when talking to me:  Don't
start off with 'I have a gaim question', 'Can I ask a question?', 'Hello?',
'Are you there?', 'Is this the gaim guy?', 'gaim doesn't work', 'I can't get
gaim to compile' or anything else like that.  Why?  If you'll notice in all
of the above statements, nothing useful has been said.  I'm often away from
my computer.  I suggest if you are having a serious problem or you have a
question, just ASK THE QUESTION, right off, I don't require any preliminary
stuff.  Simply sending me "gaim segfaults when I do 'blah blah click blah'"
to start a conversation is fine -- I don't consider it rude, please just ask
the question.  If I don't answer within a few minutes, leave your email
address, I will get back to you sooner or later.  Lastly, do NOT abbreviate
'you' as 'u', 'are' as 'r', 'to' as '2', 'for' as '4', or any of those other
annoying AOLisms.  They bother me greatly, and as I work long hours and am
an insomniac (probably because I'm such a mean bastard ;), I'm likely to
make fun of you, or more likely ignore you completely.  I don't require
perfect English but it'd be nice.

	2. I want to write an IM client.  Will you help me?
		No, unless you're writing one commercially.  Email me for
rates -- I'm not all that expensive. :)

	3. I have money.  I need some software written.  Can you help?
		Oh yes.  My email address is rob@@blueridge.net and my
		screen name is RobFlynn.
	
	4. I have hardware that's not being used, or money.  Can you use it?
		Almost always.  I'm a broke college student.  We're all
broke here.  Flat busted.  Money would always help.  If you have some useful
equipment (or even useless equipment!  I like old mainframes and
workstations ;), do send it to us!  I might be able to scratch together
shipping money even. :)

	5. I would like to send you beer.
		OK.

	6. Are you going to port this thing to Windows?
		I've been mulling it over and playing with cygwin on the
tiny Windows partition I do have on my laptop (It's required for school),
but I'm not sure yet.  I actually do have a version of gaim running on it
now, as of 7/20.  However, the Win32 port of GTK has some issues that need
to be resolved before I can even attempt to release this.  Some of my WIN32
patches are included in this release, usually under an #ifdef _WIN32 (which
cygwin and I think other windows compilers set).  
		Update, 8/16/2000, more than one year later: No. The simple
answer is this will never be ported to Windows. I simply dislike windows
too greatly.

	7. Why the GPL?
		I like the GPL.  

	8. I use *BSD and I hate the penguin!  I want daemon images!
		Quit your complaining! They're there already! I still don't
understand why ya'll hate the penguin though, maybe it's just jealousy cause
our OS gets all the media attention? I kinda like the daemon :)

	9. Can I design a logo for you?
		Sure!  Do your best.  Entries may be emailed to: 
gaimlogo@@blueridge.net.  After we get a nice supply of entries we'll sort
through them and pick the winner.

       10. What is a wagii?
		Interesting question that you ask, there.  `Wagii' is the 
official celebratory cry of gaim.  Anytime you are feeling happy or excited,
just remember all of the hard work that we have done to provide you with 
this wonderful, free piece of software -- as the pure, raw, emotion flows
through you, maybe you too will let out the cry of -- Wagii.
		Its also the sound a Penguin Samurai makes :)

       11. Speaking of the penguin, I heard a rumour you have a tattoo of  
           it.  Is that true?
		Hehe.  Yes, that is true.  He's on my left upper arm.  If
you'd like to see a picture, visit <http://www.woodsoup.org/~sbaker/tux/doc/>.
It's a 'history of Tux' and there's a pic of my tattoo at the bottom.  A pic
of my tattoo is also in the LIMP, and linux.remotepoint.com.  There's also a
picture of the two matching Tux tattoos that a husband and wife have in
there.  I've heard a rumour someone at Red Hat has one as well.  BTW -- no,
it really didn't hurt, and yes, I was sober ;)

       12. What Window Manager do you use?  What distribution do you use?
           What other stupid things can you ask me that don't really matter
           but ya'll ask me anyway?
		I use WindowMaker, without any GNOME or KDE bits.  I don't
really use a distro, per se, as it used to be a Red Hat distro a long time
ago, but since then I've custom-installed by hand from one hard drive to
another, so it really doesn't resemble Red Hat anymore, and I've written
most of the rc. scripts from scratch.  Please don't ask me Red Hat
questions, also I hate it when people assume that Red Hat == Linux. 

      13. Is XX a good harddrive, YY a good monitor, and ZZ a good CPU?
               Hmm, we're kinda poor so we cant be positive... if you wanna
send us some hardware we'll use it though and tell you how good it is *wink*
d13 6
a18 2
      14. Who designed the new logo?
	       A good guy named Naru Sundar.
d20 343
a362 2
      15. I want to contribute to the effort.  Where can I send beer to?
               IM RobFlynn or email him at rflynn@@blueridge.net
@


1.8
log
@Blah
@
text
@d33 8
a40 1
III. Problems
d49 1
a49 1
IV. Programming
d54 1
a54 1
V. Miscellaneous
d145 39
a183 1
III. Problems
d233 1
a233 1
IV. Programming
d272 1
a272 1
V. Miscellaneous
@


1.7
log
@Yo
@
text
@d229 1
a229 1
		Sure.  My IM name is Zilding.  The rest of the crew's IM names
d258 2
a259 1
		Oh yes.  My email address is jimduchek@@ou.edu, my IM is Zilding.
@


1.6
log
@just some doc updates
@
text
@d3 11
a13 10
Here's the FAQ.  PLEASE don't bother me about anything on this list.  You
will be ignored or pointed at the FAQ -- I have been extremely short of time
lately!  Feel free to contact any of us with praise or ideas.  If you have
ideas or bug problems, please use email, because I like to keep records of
that kinda stuff and I don't log all my conversations.  Enjoy gaim!
					- Jim Duchek <jimduchek@@ou.edu>

Revision as of 07/17/2000:  Please send all reports to
Rob Flynn (rflynn@@blueridge.net).  Jim Duchek is no longer associated
with the GAIM Project.
@


1.5
log
@Changed around some email addresses for myself, etc.
@
text
@d28 2
a29 2
        7. I'm not a native English speaker and I would like a translated
           version of gaim.
d31 1
a31 1
	
d33 1
a33 1
        1. WAAAAAH!  My sound doesn't work!
d38 1
a38 1
        6. I have a bug not described here.
d47 3
a49 3
        1. Can I talk to you on IM?
        2. I want to write an IM client.  Will you help me?
        3. I have money.  I need some software written.  Can you help?
d51 1
a51 1
           you use it?
d61 2
a62 2
           What other stupid things can you ask me that don't really matter
           but ya'll ask me anyway?
d102 3
a104 2
		When adding a new buddy, you just type in a new group name.
Future versions intend to handle this and renaming groups better.
d121 4
a124 8
       6. Can I use my Windows 95 buddylist with Gaim?
		Well, you are in luck.  As of the 0.9.5 release there is a 
small perl script called 'buddytrans' that is included with the distribution.
If you installed the RPM copy of GAIM then you can find the script in
/usr/bin/buddytrans.  The correct script syntax is: 
buddytrans buddy.lst gaim.list.  You can then import `gaim.list' from inside
gaim.  This will eventually be fully incorporated into GAIM and the script
will no longer be needed.
d128 1
a128 3
		By all means, IM me at 'Zilding' or email me at
jimduchek@@ou.edu.  I'm working on standard GNU locale support for the next
version of gaim, and I'm going to need translations.  If you can do a
d133 2
a134 4
		I *think* HTTP and SOCKS v4 proxy support is completely working.
But since I don't have a SOCKS proxy to test it on, I really couldn't tell you.
If it doesn't work, a temporary solution is to try setting the TOC port to 21,
since a lot of proxies will allow that to pass.
a143 4
		The GNOME client now goes through GNOME for its sounds. If
sounds aren't playing, make sure you've got them turned on in the GNOME
control center. (The reason this was done was to make it more easily
configurable.)
d171 1
a171 3
email me at jimduchek@@ou.edu, I would like to hear your bug reports (but
please, not your problems installing GTK). Also, sourceforge.net has a bug
tracking system for us at <http://sourceforge.net/bugs/?group_id=235>.
a251 1

d277 3
d330 1
a330 1
               IM Zilding or email him at jimduchek@@ou.edu.
@


1.4
log
@here
@
text
@d10 4
@


1.3
log
@File transfer and proxies and libfaim and other updates.
@
text
@d70 2
a71 1
use Oscar, but DON'T USE IT! It's seriously buggy.
d292 1
a292 1
		Quit your complaining! They're there already! I stukk don't
@


1.2
log
@Updates to the FAQ (there's been a few changes since 0.9.5), and found a
new (and presumably the last, since AOL stopped publishing it) copy of the
protocol.
@
text
@d12 1
a12 1
	2. Where can I find info on it?
d69 2
d72 1
a72 1
	2. Where can I find info on it?
d80 1
d86 2
a87 1
		Yep.
d101 3
a103 2
		The TOC server doesn't (yet) support file transfer. Be
patient!  It is coming.
d133 4
a136 4
		Well, I'm planning to add more 'real' proxy support in the
future, but it's not all that high on my priority list.  For now, try
changing the two PORT defines in gaim.h to 21 -- The TOC server listens on
ALL ports, and a lot of proxy servers allow port 21 to pass through.
d154 3
a156 2
happens to me as well.  (And no, I never have a backup ;).  I intend to
support saving lists on your own computer in the future.
d291 3
a293 5
		I do have a nice pixmap of the daemon, and one of these days
I will do a second set of buttons.  You'll have to wait (or send me button
pixmaps yourself).  I still don't understand why ya'll hate the penguin
though, maybe it's just jealousy cause our OS gets all the media attention? 
I kinda like the daemon :)
@


1.1
log
@The other missing files :)
@
text
@d39 2
a40 1
	2. Can you teach me how to program GTK?
d71 3
a73 3
		Go to <http://www.aim.aol.com/tik> and download a copy of TiK.
In it you will find a document called PROTOCOL which describes the protocol in
full.
d76 2
a77 1
		Go to <http://www.aim.aol.com/tik>.  There is a list there.
a120 1

d140 5
a144 1
permissions to talk to /dev/dsp and /dev/audio though!  
d163 3
a165 6
		Too smeggin' bad.  :)  I personally do NOT write any of the
GNOME code.  If you find bugs in the GNOME client, I will accept emails
describing these bugs, so I can pass them on to the correct person.
I will also accept PATCHES to fix these bugs (but not like any of y'all
ever do anything but whine about bugs anyway, who am I kidding ;).  
If you IM me whining about a GNOME bug, you will probably be ignored.
d172 2
a173 1
please, not your problems installing GTK).
d193 1
a193 1
etc.  We're working on plug-ins if you really want bloat like that. 
d208 10
a217 2
discouraged you entirely, my email address is jimduchek@@ou.edu, you can
send your patches there.
d219 1
a219 1
	2. Can you teach me how to program GTK?
@

