Gyach is a Yahoo! chat program with a GTK+ interface.  It was originally
based upon the yahmini program (see AUTHORS file).  All yahmini code
has since been replaced.  Gyach was written for a few reasons:

    1 - I run Linux at home and I couldn't stand the yahoo java interface.
    2 - I didn't want to run qt unless absolutely necessary.
    3 - I wanted to occasionally have something a little more fancy than
	the text-based interface that a few others are working on.
    4 - I'm impatient and didn't want to wait for someone else to write a
	simple GTK-based interface.

So, I got the source to yahmini and created a GTK+ interface for it using
Glade.  Functionality was limited in the early stages, but I continue to
add new features.  Yahmini code has now been totally replaced as well as
conversion from Yahoo's older YCHT protocol to their newer YMSG protocol.

Current features:

    * Auto-updated userlist of chatters in the current room.
    * The following commands are supported:
	/away   /follow     /alias     /invite     /mute
	/goto   /ignore     /unalias   /tell       /unmute
	/join   /unignore   /cls       /roll       /history
	/quit   /think      /clear     /autoaway   /exec
	/tell   /invite     /profile   /regex      /friends
	/friend /execlocal
    * Supports Aliases (with different emote/alias for everyone or individual).
    * Send/receive PMs.
    * PM chat in separate windows.
    * Editable list of favorite rooms.
    * Supports list of usernames to use to login.
	* Supports connect/disconnect/auto-reconnect.

A sample gyachrc file is included in this directory.  You can copy that
to ~/.gyach/gyachrc. A generic aliases.dat file will be created for you
when you first run Gyach.

Also included are sample ignore lists and regex files (sample.ignore.list
and sample.ignore.regex respectively).

To see a list of items planned or currently being worked on, look at the
TODO file in this directory.

------------------------------------------------------------------------------
Graphical "Emoticons" aka Smileys

As of version 0.9.0, Gyach supports graphical emoticons (aka smileys) if you
compile Gyach with Gtk v2.x support.  Gyach v0.9.0 and up supports
Gtk v2 and uses the GtkTextView widget instead of the older GtkText widget.
GtkTextView supports inline images so smileys and avatars can be displayed
right along with the text.

You will need to download the emoticon graphics separately since they are
not included in the Gyach tarball.  The emoticons are stored in files
named like NN.gif where NN is a 0-padded number starting at 01.  Each number
corresponds to a different smiley so don't mix them up.

You can get your emoticon graphics from various places around the net,
either from the original Yahoo Messenger v5.5 program or by downloading a
zipfile that someone has created.  Here are a few links to smiley zipfiles.
I take no responsibility to the content of these smileys as they are
maintained by someone else.

	Default smileys included with Yahoo Messenger v5.5.
	http://www.sector101.fsnet.co.uk/yahoo/matamerah/files/defaultsmileys_v55.zip

	Phil somebody's version.
	http://www.sector101.fsnet.co.uk/yahoo/matamerah/files/philsv31_55.zip

If these links are not working or if you prefer, try "yahoo smileys" in
your favorite search engine to locate a zip or tarball of the smiley
graphics.

The emoticon/smiley files should be located in ~/.gyach/smileys (or
./smileys/ for cygwin users) and should be named as indicated above (01.gif,
02.gif, etc.).  Once you place the files in Gyach and turn on the
"Show Emoticons" option in the setup screen, you should start seeing graphical
smileys displayed instead of the :) characters.  Gyach does not currently have
a window to make sending graphical smileys easier, but that will come
in the future sometime.  You can send them manually by typing in the proper
character sequence in the text entry box.
------------------------------------------------------------------------------

Gyach has been tested on:

	RedHat v5.x, v6.x, v7.x, v8.x
	SuSE v6.4 & v7.0
	Mandrake v7.x, v8.x, v9.x
	DragonLinux v2.1
	Debian 2.x, 3.x
	Gentoo Linux 1.2, 1.4
	FreeBSD 4.1.1   (see README.FreeBSD)
	NetBSD v?   (see README.NetBSD)
	OpenBSD v?
	Solaris 8 for Intel/x86 (gcc & gtk v1.2.8)
	Solaris 9 for SPARC w/ (gcc, gtk v1.2.10, & make installed)
	Mac OS X   (see README.MacOSX)
	Windows 98, NT, 2000 under CygWin (see README.Win32 for requirements)


