# HG changeset patch # User Eric Warmenhoven # Date 1007903938 0 # Node ID ad4057cb228fc63c3e37cd592664be0b0e52f9c5 # Parent 5d7e0a730c7fcea982e8ae26848d71d229f7eb72 [gaim-migrate @ 2875] i'm not like them, but i can pretend. committer: Tailor Script diff -r 5d7e0a730c7f -r ad4057cb228f BUGS --- a/BUGS Sun Dec 09 10:55:24 2001 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,4 +0,0 @@ -No Bugs, only features. Bugs are yummy. - -If you find a feature you think is a bug, report it to -http://sourceforge.net/projects/gaim/ diff -r 5d7e0a730c7f -r ad4057cb228f Makefile.am --- a/Makefile.am Sun Dec 09 10:55:24 2001 +0000 +++ b/Makefile.am Sun Dec 09 13:18:58 2001 +0000 @@ -1,6 +1,6 @@ EXTRA_DIST = gaim.spec.in gaim_applet.gnorba gaim.desktop gaim_applet.desktop \ - HACKING STATUS gaim2blt.pl licq2gaim.pl + HACKING gaim2blt.pl licq2gaim.pl if DISTRIB diff -r 5d7e0a730c7f -r ad4057cb228f README --- a/README Sun Dec 09 10:55:24 2001 +0000 +++ b/README Sun Dec 09 13:18:58 2001 +0000 @@ -7,17 +7,22 @@ Mark Spencer Gaim is an IM client that supports many protocols, including AIM, ICQ, -MSN, IRC, and Jabber. Gaim is NOT endorsed by, nor affiliated with, AOL -nor any other company in ANY way. +MSN, IRC, and Jabber. Gaim is NOT endorsed by, nor affiliated with, +AOL nor any other company in ANY way. -* Build: + +BUILD +===== -./configure ; make -for the stock version. ./configure --help to see what option you can get. -You need to use gmake, BSD make will not work. +Read the 'INSTALL' file for more detailed directions. -You need GTK 1.2.3. I don't wanna hear about it, if you can't get it to -work under a lower version. +Gaim uses the standard ./configure ; make. You need to use gmake, BSD +make probably won't work. Remember, run ./configure --help to see what +build options are available. + +In order to compile Gaim, you need to have GTK+ 1.2.5 installed (as +well as the development files!). The configure script will fail if you +don't. You can get it from http://www.gtk.org/. Gaim will try to compile with Gnome features if you have Gnome on your system. If you don't have them, it will settle for simply GTK. If you @@ -25,62 +30,177 @@ If you want to build as a GNOME applet: ./configure --enable-panel ; make -then su to root and run "make install". +then su to root and run "make install". Afterwards panel->Add applet->Network->Gaim should be there. -* Run: + +RUN +=== -type "./gaim" +You should run 'make install' as root to make sure plugins and other files +get installed into locations they want to be in. Once you've done that, +you only need to run 'gaim'. -To use the other services (such as Yahoo and IRC) which are available as -plugins: +To use the other services (such as Yahoo and IRC) which are available +as plugins: + They are installed in $libdir/gaim, which usually is either /usr/lib/gaim or /usr/local/lib/gaim, and should have a somewhat descriptive name (e.g. libyahoo.so or irc.so). Load those plugins using the normal plugin dialog. Then in the account editor, add a new account; the Protocol option menu -should now have another option for the protocol that you loaded. Then you -can sign that account on. +should now have another option for the protocol that you loaded. Then +you can sign that account on. -ICQ and Zephyr are currently the only two protocols that don't use the -global proxy configuration; however, if you have the proxy set to use a -SOCKS5 proxy, ICQ will use it. If the proxy options aren't robust enough -for you there are several libraries that you can link gaim against. +Read below for protocol-specific information. + -* Plugins: +PLUGINS +======= If you do not wish to enable the plugin support within Gaim, run the ./configure script with the --disable-plugins option and recompile your source code. This will prevent the ability to load plugins. -'make install' puts the plugins in $PREFIX/lib/gaim (PREFIX being what you -specified when you ./configure'd - it defaults to /usr/local). Gaim looks -for the plugins in that directory by default, but they do not have to be -there to use them. Also, plugins have a .so extension by default, though -they do not have to. +'make install' puts the plugins in $PREFIX/lib/gaim (PREFIX being what +you specified when you ./configure'd - it defaults to /usr/local). Gaim +looks for the plugins in that directory by default, but they do not have +to be there to use them. Also, plugins have a .so extension by default, +though they do not have to. + +To build a plugin from a .c file, put it in the plugins/ directory in +the source and run 'make filename.so', e.g. if you have the .c file +'kickass.c', put it in the plugins/ directory, and from that directory, +run 'make kickass.so'. + + +NOTES +===== + +If you manually set a command for your browser or sound player options, +make sure to put double-quotes around the "%s", otherwise bad things may +happen. + +If you come across a bug, please report it to http://gaim.sf.net/bug.php3. + +There always seems to be some iffy-ness by a lot of people about +whether to use the CVS version or stick with a stable release. Use the +CVS version. If you need a version that you know is reliable, then keep +your favorite one in case of an emergency. But for the most part, gaim +is not mission-critical software, and if you can help us find a few bugs +before we release, all the better. (Also, CVS tends to be more stable +than releases, since we get 10 or 12 bug reports right after we make a +release, and all those bugs are fixed within a day or two usually.) Read +http://gaim.sf.net/cvs.php for more information. + + +PROTOCOL INFORMATION +==================== -* Notes: +Each protocol is hacked by both Rob and Eric, though there is one person +that kind of "owns" a protocol (mostly indicating that they were the +person that originally wrote it). Their name will be next to the protocol; +they're the people to complain to when something doesn't work ;). + + +TOC (Rob) +=== + +You shouldn't use TOC, you should use Oscar instead. TOC can sync your +buddy list with the server (if it's not too long), and can respond to file +transfer requests (both sending and receiving). Other than that, there's +nothing it can do that Oscar can't, yet. The TOC protocol doesn't allow +retrieval of away messages; isn't capable of sending or receiving buddy +icons; it also can't make file transfer requests. + -This should now compile under Solaris, Digital Unix, Irix, etc w/o a -problem. +Oscar (Eric) +===== + +Oscar is the default protocol. It is recommended that you use Oscar for +both AIM and ICQ, as TOC isn't very featureful and the old ICQ protocol no +longer works. -This compiles without warnings on Linux-x86 2.2.10 glibc2.1, GTK 1.2.3 system. -If you get warnings on something else, let me know and I'll check it out. -If you get errors, upgrade to the latest GTK-1.2 before bothering me. +For AIM, Oscar can get people's away messages. It can request and accept +Direct IM connections, but it cannot yet transfer files through this (or +through any other means). It can send and receive buddy icons if you have +GdkPixbuf. + +For ICQ, it supports nearly everything that the old ICQ plugin supported, +which isn't much. To use Oscar for ICQ, enter your ICQ UIN as the +screenname. The default host/port will work. + + +Yahoo (Eric) +===== -The resulting executable is standalone, so you can put it in /usr/bin or -whatever. +Yahoo is currently using the new YMSG protocol that newer official Yahoo +clients are using. This protocol is much better than the old one, and +tends to be somewhat more reliable. However, the Yahoo service is still +flaky at best. Group chats aren't supported yet. + + +IRC (Eric) +=== + +There are three ways to join an IRC chat room. The first is the File->Join +A Chat menu option in the Buddy List window. The second is the "Chat" +button at the bottom of the buddy list. The third is to type "/join #name" +in an IM window where the "Send Message As" menu is set to your IRC +account. There are other / commands that work in IM and Chat windows for +IRC, /help will give you a list of them. + -The panel (if you made an applet) requires certain things to be in certain -places, but the Makefile/configure script should figure things out for you. +MSN (Eric) +=== + +With MSN you can join a conversation with several people, but you can't +invite people from the IM window yet. + + +ICQ (Eric) +=== + +The ICQ plugin is deprecated and will probably be removed soon. The +protocol only marginally works. You should use Oscar for ICQ. + + +Jabber (Eric) +====== -If you set a command for your browser or your sound player, make sure to put -quotes around the %s where appropriate; otherwise, bad things could happen. -Remember, you did it to yourself. +Transports aren't currently supported at all, though if you have a +transport already subscribed Gaim will use it (you can't add or remove +transports though). In order to use a server other than jabber.org, set +your username to include the server, e.g. warmenhoven@mycompany.com. This +is the actual format of the Jabber ID anyway; Jabber is email with online +notification. + + +Napster (Rob) +======= + +Heh. Ok, so I (Rob) am on crack! Gaim can sign on/off of Napster, +add/remove people to your hotlist (buddylist) as well as chat privately +and in chat rooms. You can search for files and browse a list of other +user's files. You can currently download files as long as the person +you're retrieving files from is not firewalled. + -Send me bug reports. The web page is http://gaim.sourceforge.net/and the ftp -site is ftp://ftp.sourceforge.net/pub/sourceforge/gaim. We also have a -sourceforge page at http://sourceforge.net/projects/gaim/ +Zephyr (Eric) +====== -Keep your eyes out for updates, and I'll try to keep the program maintained. -Other contributors and patches are welcomed. Please read the FAQ first. You -can come ask questions in #gaim on irc.openprojects.net. +Let me start off by saying how much I really despise Zephyr. They do a +lot of things that make me realize why this never caught on. For those +of you who are unfortunate enough to feel compelling need to use this, +gaim now has a Zephyr plugin. It can currently sign on/off, handles +presence/buddy lists (it even imports your .anyone file!), and can +send/receive personal messages. A lot of stuff is missing, this is just +a real rough first stab at it. + + +Gadu-Gadu (Eric) +========= + +I really shouldn't be taking credit for Gadu-Gadu, I'm just the person who +commits the patches that Arkadiusz Miskiewicz gives me. Gadu-Gadu is an IM +system most similar to ICQ that is quite popular in Poland. It can manage +your server-side buddy list through the Protocol Actions menu. diff -r 5d7e0a730c7f -r ad4057cb228f STATUS --- a/STATUS Sun Dec 09 10:55:24 2001 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,157 +0,0 @@ -STATUS of Gaim CVS tree. Last modified $Date: 2001-10-18 08:12:38 -0400 (Thu, 18 Oct 2001) $ by -$Author: warmenhoven $. - -This file is meant to provide gaim users who use the CVS version to see whether -they actually want to compile what they just checked out. Gaim CVS is usually -relatively stable (we use it all the time), but has tendencies to be quirky at -times. - -There always seems to be some iffy-ness by a lot of people about whether to -use the CVS version or stick with a stable release. Use the CVS version. If -you need a version that you know is reliable, then keep your favorite one in -case of an emergency. But for the most part, gaim is not mission-critical -software, and if you can help us find a few bugs before we release, all the -better. (Also, CVS tends to be more stable than releases, since we get 10 or -12 bug reports right after we make a release, and all those bugs are fixed -within a day or two usually.) - -Each protocol is hacked by both Rob and Eric, though there is one person that -kind of "owns" a protocol (mostly indicating that they were the person that -originally wrote it). Their name will be next to the protocol; they're the -people to complain to when something doesn't work ;). - - -OVERALL -======= - -Everything right now is more or less peachy. I regularly use seven protocols -at the same time and don't have any problems (all of them except Napster and -Zephyr). You shouldn't be using 0.10.3; there are serious bugs in it (including -a remote exploit). Always use CVS, or if not, the most recent release. - - -Buddy List -========== - -The buddy list should now be stable. The only thing that'll be missing is if -you're signed on as more than one name, the tooltips and idle times for buddies -won't display correctly. - - -Applet -====== - -The applet should be stable and completely functional now (as far as the applet -part of it goes). Please, someone send in better icons. And preferably OS- -neutral ones. - - -Plugins -======= - -The plugin system got a good reworking. It's got a few more features now. Nearly -every plugin is going to need to be rewritten. Have fun porting from 0.10.x to -0.11.0 (it's actually very simple). - - -Perl -==== - -Perl has its good side and bad side. It didn't completely survive the transition -to multiple connections, but it was never really intended for more than a chatbot -anyway, which should still work just wonderfully. - - -TOC (Rob) -=== - -TOC is working reasonably well. TOC cannot get people's away messages; TOC also -cannot make requests to send files. It is possible, however, to have an AIM user -request to get a file from or send a file to you. Support for Direct IM, Buddy -Icons, and Voice Chat is being worked on. - - -Oscar (Eric) -===== - -Oscar can get people's away messages, so you should use it if that's what's -important to you. Oscar also supports requesting and accepting Direct IM -connections, but doesn't yet let you send/receive files through this or through -the Get File/Send File method. Permit/Deny lists should work properly now. - -Oscar is the "default" protocol now, because it supports every feature that TOC -supports and more (except file transfer, but TOC doesn't do file transfer very -well), and is in general more reliable than TOC. When you add new accounts it -defaults to using Oscar (you can specify TOC or any other protocol); when gaim -can't figure out which protocol you wanted to use (e.g. when you type in a -screenname into the Login window for an account gaim doesn't know about), it -will sign it on using Oscar. It is also recommended that you use Oscar instead -of TOC. - - -Yahoo (Eric) -===== - -Yahoo currently supports signing on/off, changing status (only to user-defined -so far though), checking other people's status (via right-clicking in the -buddy list), and sending/receiving messages. You can also select your active ID, -though currently you have to just remember what it is since there's nothing in -the UI that'll let you know. Chat and file transfer are planned but not yet -implemented. Yahoo servers are flaky at best so if you're having problems it's -probably not my fault. Make sure to watch the debug window if you're having any -problems. - - -IRC (Eric) -=== - -IRC currently supports signing on/off, sending and receiving messages, -joining chat rooms and holding conversations within them. The buddylist -also works. Several /commands work as well, /help in any window will show -you a full list. - - -MSN (Eric) -=== - -MSN currently supports signing on/off, sending and receiving messages, and going -away/idle. You can also change your friendly name. - - -ICQ (Eric) -=== - -ICQ currently supports signing on/off, changing status, checking other people's -status (but not status message), sending/receiving messages, and receiving URLs. -Keepalives are sent regardless of whether or not you want them; it's necessary -since it's a UDP protocol. Chat and file transfer are planned but not yet -implemented. - - -Jabber (Eric) -====== - -Jabber can sign on/off, send/receive messages, and add/remove buddies. All good -things. If you have a registered transport then you can still use that; however -you won't see it on your buddy list yet; and you can't add or remove transports -yet. Chat is working now. - - -Napster (Rob) -======= - -Heh. Ok, so I (Rob) am on crack! Gaim can sign on/off of Napster, add/remove -people to your hotlist (buddylist) as well as chat privately and in chat rooms. -You can search for files and browse a list of other user's files. You can -currently download files as long as the person you're retrieving files from -is not firewalled. - - -Zephyr (Eric) -====== -Let me start off by saying how much I really despise Zephyr. They do a lot of -things that make me realize why this never caught on. For those of you who are -unfortunate enough to feel compelling need to use this, gaim now has a Zephyr -plugin. It can currently sign on/off, handles presence/buddy lists (it even -imports your .anyone file!), and can send/receive personal messages. A lot of -stuff is missing, this is just a real rough first stab at it. diff -r 5d7e0a730c7f -r ad4057cb228f configure.ac --- a/configure.ac Sun Dec 09 10:55:24 2001 +0000 +++ b/configure.ac Sun Dec 09 13:18:58 2001 +0000 @@ -167,11 +167,11 @@ fi if test "x$enable_gnome" != "xyes" -a "x$enable_gtk2" != "xyes" ; then - AM_PATH_GLIB(1.2.3,,AC_MSG_ERROR([ + AM_PATH_GLIB(1.2.5,,AC_MSG_ERROR([ *** GLib is required to build Gaim; please make sure you have the GLib *** development headers installed. The latest version of GLib is *** always available at http://www.gtk.org/.])) - AM_PATH_GTK(1.2.3,,AC_MSG_ERROR([ + AM_PATH_GTK(1.2.5,,AC_MSG_ERROR([ *** GTK+ is required to build Gaim; please make sure you have the GTK+ *** development headers installed. The latest version of GTK+ is *** always available at http://www.gtk.org/.])) diff -r 5d7e0a730c7f -r ad4057cb228f gaim.spec.in --- a/gaim.spec.in Sun Dec 09 10:55:24 2001 +0000 +++ b/gaim.spec.in Sun Dec 09 13:18:58 2001 +0000 @@ -17,7 +17,7 @@ Source: %{name}-%{version}.tar.gz Packager: Rob Flynn BuildRoot: /var/tmp/%{name}-%{version}-root -Requires: gtk+ >= 1.2.3 +Requires: gtk+ >= 1.2.5 %description Gaim is NOT affiliated with or endorsed by AOL. @@ -38,7 +38,7 @@ %package applet Summary: A Gnome client compatible with AOL's 'Instant Messenger' Group: Applications/Internet -Requires: gtk+ >= 1.2.3 +Requires: gtk+ >= 1.2.5 %description applet Gaim allows you to talk to anyone using AOL's