comparison plugins/PERL-HOWTO @ 3456:b48065e52337

[gaim-migrate @ 3503] A few patches. Brian--tell me what your last name is, and I'll put it in. ;) committer: Tailor Script <tailor@pidgin.im>
author Sean Egan <seanegan@gmail.com>
date Wed, 28 Aug 2002 02:38:19 +0000
parents c98c1e0281ff
children cd938f18f3f8
comparison
equal deleted inserted replaced
3455:8de4f34a1bd7 3456:b48065e52337
129 read perl.c to figure out what they are. The arguments are passed after the 129 read perl.c to figure out what they are. The arguments are passed after the
130 plugins have had their way with them. Perl scripts cannot modify the values 130 plugins have had their way with them. Perl scripts cannot modify the values
131 so that gaim knows what the changes are. 131 so that gaim knows what the changes are.
132 132
133 Perl scripts can short-circuit certain events (namely event_im_send, 133 Perl scripts can short-circuit certain events (namely event_im_send,
134 event_im_recv, event_chat_send, and event_chat_recv). To short-circuit an 134 event_im_recv, event_chat_send, event_chat_recv and event_set_info). To
135 event simply return a non-0 value. This will cause all subsequent scripts 135 short-circuit an event simply return a non-0 value. This will cause all
136 and the event itself to never happen (i.e. the user won't see it happen, 136 subsequent scripts and the event itself to never happen (i.e. the user
137 and _send events won't actually send). 137 won't see it happen, and _send events won't actually send).
138
139 GAIM::remove_event_handler(event, function)
140 This removes the event handler for the specified event that
141 calls "function" as its handler. The event handler must have been
142 previously added with GAIM::add_event_handler.
138 143
139 GAIM::add_timeout_handler(integer, function, args) 144 GAIM::add_timeout_handler(integer, function, args)
140 This calls function after integer number of seconds. It only calls function 145 This calls function after integer number of seconds. It only calls function
141 once, so if you want to keep calling function, keep readding the handler. 146 once, so if you want to keep calling function, keep readding the handler.
142 Args is a string that you'd like to have passed to your timeout handler; it's 147 Args is a string that you'd like to have passed to your timeout handler; it's