gtk/plugins/perl/common/Gtk.pm@a6b831ab1d13 (annotated)
gtk/plugins/perl/common/Gtk.pm
Sat, 02 Sep 2006 05:31:10 +0000
- author
- Etan Reisner <deryni@pidgin.im>
- date
- Sat, 02 Sep 2006 05:31:10 +0000
- changeset 14478
- a6b831ab1d13
- permissions
- -rw-r--r--
[gaim-migrate @ 17124]
This is a Gaim::Gtk perl module for use by gaim plugins to get access to the
gtkgaim interface functions. It isn't complete because anything dealing with
Gtk widgets themselves doesn't work yet (I need to figure out the best way to
do that). To use this a perl plugin just needs to include 'use Gaim::Gtk;'
either on top of 'use Gaim;' or instead of it.
I'm not done with this yet.
At the moment you have to 'use Gaim;' or 'use Gaim::Gtk;' which loads all the
parts, I'm planning to let you actually say 'use Gaim::Gtk::Debug;' to just
get the gtkdebug.h functions. Though 'use Gaim' would work the same way as
always.
| 14478 | 1 | package Gaim::Gtk; |
| 2 | ||
| 3 | use 5.008; | |
| 4 | use strict; | |
| 5 | use warnings; | |
| 6 | use Carp; | |
| 7 | ||
| 8 | our $VERSION = '0.01'; | |
| 9 | ||
| 10 | use Gaim; | |
| 11 | ||
| 12 | require XSLoader; | |
| 13 | XSLoader::load('Gaim::Gtk', $VERSION); | |
| 14 | ||
| 15 | 1; | |
| 16 | __END__ | |
| 17 | ||
| 18 | =head1 NAME | |
| 19 | ||
| 20 | Gaim::Gtk - Perl extension for the Gaim instant messenger. | |
| 21 | ||
| 22 | =head1 SYNOPSIS | |
| 23 | ||
| 24 | use Gaim::Gtk; | |
| 25 | ||
| 26 | =head1 ABSTRACT | |
| 27 | ||
| 28 | This module provides the interface for using perl scripts as plugins in | |
| 29 | Gaim, with access to the Gaim Gtk interface functions. | |
| 30 | ||
| 31 | =head1 DESCRIPTION | |
| 32 | ||
| 33 | This module provides the interface for using perl scripts as plugins in Gaim, | |
| 34 | with access to the Gaim Gtk interface functions. With this, developers can | |
| 35 | write perl scripts that can be loaded in Gaim as plugins. The script can | |
| 36 | interact with IMs, chats, accoutns, the buddy list, gaim signals, and more. | |
| 37 | ||
| 38 | The API for the perl interface is very similar to that of the Gaim C API, | |
| 39 | which can be viewed at http://gaim.sourceforge.net/api/ or in the header files | |
| 40 | in the Gaim source tree. | |
| 41 | ||
| 42 | =head1 FUNCTIONS | |
| 43 | ||
| 44 | =over | |
| 45 | ||
| 46 | =back | |
| 47 | ||
| 48 | =head1 SEE ALSO | |
| 49 | Gaim C API documentation - http://gaim.sourceforge.net/api/ | |
| 50 | ||
| 51 | The Gaim perl module. | |
| 52 | ||
| 53 | Gaim website - http://gaim.sourceforge.net/ | |
| 54 | ||
| 55 | =head1 AUTHOR | |
| 56 | ||
| 57 | Etan Reisner, E<lt>deryni@gmail.comE<gt> | |
| 58 | ||
| 59 | =head1 COPYRIGHT AND LICENSE | |
| 60 | ||
| 61 | Copyright 2006 by Etan Reisner |
