annotate plugins/yay/README @ 1106:5bc8fdacd2cb

[gaim-migrate @ 1116] lots of changes. buddy.c: just in general tried to get things to work better. moving things in the edit list window and signing off should be handled better in the main buddy list window (watch out for flashes). gaim.h: removed toc-specific things and moved them to toc.c and rvous.c as needed. gtkhtml.c: possible fix for AOL 6.0 problems (I wasn't able to reproduce the problem before or after the fix, but i fixed what i think might have been causing the problem). multi.c: moved LOGIN_STEPS from gaim.h here and actually use it now oscar.c: moved an oscar-specific struct definition from gaim.h here and also handle problems better perl.c: fix for stupid problem rvous.c: first pass at attempt to be able to remove toc.c and rvous.c (though this will never happen; gaim will support toc as long as aol does) without cruft. gaim is now only dependent on toc.c and rvous.c for toc_build_config and parse_toc_buddy_list, which gaim needs to save and read its buddy list. toc.c: rewrote the signin process so that the read()'s won't block. it's not actually a non-blocking read; it's just that it won't ever get to the read until there's data to be read (thanks to the gdk_input watcher). this means the cancel button should work after it's connected, but it's still not a non-blocking connect. committer: Tailor Script <[e-mail]>

Introduction:
-------------
This is GTKYahoo, a GPL'd GTK Yahoo! Pager client. It is functional
enough to carry on normal conversations. New features, and additional
functionality is being added quite frequently.

Please send me patches/fixes/additions/suggestions... Any help is
appreciated.

I _HIGHLY_ suggest reading the ChangeLog and other files in here to get
some details on what is going on with the program, etc.

This software is not supported or sponsored in any way by Yahoo!. 

Where to get:
-------------
Home Page: http://www.unixtools.org/gtkyahoo/
Download Area: http://www.unixtools.org/gtkyahoo/dist/
Anon-CVS: 
	Root: :pserver:[e-mail]:/cvsroot-gtkyahoo
	Password: cvs
	Module: gtkyahoo

Usage notes:
------------
The first time you run GTKYahoo it will create a configuration directory
and config file. Edit it prior to running the program again.

Look at the sample gtkyahoorc file for info on other options. Note, many
of the features are unimplemented at the moment.

Debugging options are available in the config file, syntax is:
	
	debug "keyword" level

i.e.
	
	debug "yahoolib" 1

Available keywords include: 
	packets: enables tracing of received packets
	yahoolib: enables debugging of yahoolib actions
	sendraw: enables the sendraw facility

Development notes:
------------------
This program makes use of the cfunctions program to build some of it's
header files. This is only done in response to issuing "make proto".
The cfunctions tool is available from the URL:

	http://www.hayamasa.demon.co.uk/cfunctions

The yahoolib files can be pulled out and used to implement the pager
protocol. They are not documented however. The basic functionality of the library is that you give it a pointer to a buffer area, and the size of the buffer, 
and it will return you a raw packet if the buffer contains one. The actual
I/O with the server is up to you.

Other suggested packages include:
	bison, flex, ElectricFence, cvs