annotate doc/FAQ @ 329:e2f9fb72fb92

[gaim-migrate @ 339] here committer: Tailor Script <[e-mail]>

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

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 <[e-mail]>

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

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

V. 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?
		When adding a new buddy, you just type in a new group name.
Future versions intend to handle this and renaming groups better.

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

        7. I'm not a native English speaker and I would like a translated   
           version of gaim.
		By all means, IM me at 'Zilding' or email me at
[e-mail].  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
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.
		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.


III. 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!
		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.)

	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 ;)
email me at [e-mail], 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>.

	7. I have Mandrake 6.0 and GAIM doesnt work!

Bob Meyer <[e-mail]> 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.

IV. 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 ([e-mail]).

	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.


V. Miscellaneous
	1. Can I talk to you on IM?
		Sure.  My IM name is Zilding.  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 [e-mail], my IM is Zilding.
	
	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).  

	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: 
[e-mail].  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*

      14. Who designed the new logo?
	       A good guy named Naru Sundar.

      15. I want to contribute to the effort.  Where can I send beer to?
               IM Zilding or email him at [e-mail].