comparison plugins/PERL-HOWTO @ 806:67bdecdecbb7

[gaim-migrate @ 816] yay, i think perl is finally working well committer: Tailor Script <[e-mail]>

805:2f0655e185b8

Plugins are more powerful as they can directly access gaim's functions and
variables; as such they should be used for things like modifying the UI or
when something takes quite a bit of trickery not offered by perl. But for
the most part things should be written in Perl. It's more stable than
plugins.

Everything available in normal perl scripts should be available in gaim's
perl interface, so I'm not going to bother describing that. The important
things are the functions provided by gaim's internal AIM module, which is
what most of this document is about. So, onto the functions.

	plugins have had their way with them. Perl scripts cannot modify the values
	so that gaim knows what the changes are. Unlike X-Chat, perl scripts cannot
	short-circut gaim (that is, your script will be called in order it was added,
	despite what other scripts do, and afterwards, execution will continue as
	normal). Names of buddies and chat rooms will be in quotes, and all other
	values (like text messages) will not be.

AIM::add_timeout_handler(integer, function)
	This calls function after integer number of seconds. It only calls function
	once, so if you want to keep calling function, keep reading the handler.

806:67bdecdecbb7

Plugins are more powerful as they can directly access gaim's functions and
variables; as such they should be used for things like modifying the UI or
when something takes quite a bit of trickery not offered by perl. But for
the most part things should be written in Perl. It's more stable than
plugins.

There's a really quick simple perl script in this directory, gaim.pl, that
should show most of the functions. Most things should be self-explanatory.

Everything available in normal perl scripts should be available in gaim's
perl interface, so I'm not going to bother describing that. The important
things are the functions provided by gaim's internal AIM module, which is
what most of this document is about. So, onto the functions.

	plugins have had their way with them. Perl scripts cannot modify the values
	so that gaim knows what the changes are. Unlike X-Chat, perl scripts cannot
	short-circut gaim (that is, your script will be called in order it was added,
	despite what other scripts do, and afterwards, execution will continue as
	normal). Names of buddies and chat rooms will be in quotes, and all other
	values (like text messages) will not be. (Watch the debug window to get a
	better feel for this, or better yet, look at the bottom of plugins.c.)

AIM::add_timeout_handler(integer, function)
	This calls function after integer number of seconds. It only calls function
	once, so if you want to keep calling function, keep readding the handler.