annotate doc/FAQ @ 3893:b35b68d19829

[gaim-migrate @ 4045] some broken editors can't handle comments that start on a line with code and extend down beyond the code. committer: Tailor Script <[e-mail]>

Gaim: The Pimpin' Penguin IM Clone Thats Good For The Soul

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:

     ./au2h.c BuddyArrive.h
     open: No such file or directory

  You're not using gmake, are you? You need to be using gmake


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. 

  If you have Slackware, 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.


1.5  I have a question about GTK2.

  Don't ask untill the changelog says it works.


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

2.1  How do I register for a new account?

  This depends on the protocol.

	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.

	MSN: Go to http://registernet.passport.com.

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

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


2.2  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 are using a version newer than 0.55 and gaim still crashes, please
  let us know.


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

4.1  How do I use ICQ?

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


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


+--------------------------------------------------------------------------
| 5  AIM/ICQ (Oscar) Protocol
+--------------------------------------------------------------------------

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

  AOL has set a limit for the maximum number of people you can have in your
  buddy list. This number is currently 200. Gaim 0.58 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
  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.


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?

  The Jabber server name is part of your Jabber I.D., such as
  [e-mail]. 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"?

  When you create your account in Gaim, simply append the desired resource
  identifier to your Jabber I.D. For example: [e-mail]/resource 


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

  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.


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


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

  where filename is the file you downloaded.

  After you have a Gaim source code tree, either through tarballs or CVS:

	1. Change to the resulting directory and run the command:

	   ./configure

	   This will create the necessary make files.

	2. Move the plugin you wish to compile into the plugins/ directory in
	   the Gaim source code tree.

	3. Change to the plugins/ directory.
	4. Type:

	   make name.so

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

	   Note well the difference in the extensions. If you type make name.c
	   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?

  No.


10.2  Is Gaim affected by the vulnerability found in Windows AIM or Yahoo
      Instant Messenger clients?

  No.


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