pidgin/plugins/perl/common/Pidgin.pm@5dbd0617a27d (annotated)
pidgin/plugins/perl/common/Pidgin.pm
Thu, 30 Oct 2008 22:40:49 +0000
- author
- Richard Laager <rlaager@pidgin.im>
- date
- Thu, 30 Oct 2008 22:40:49 +0000
- changeset 24569
- 5dbd0617a27d
- parent 16623
- 5d685c111d7b
- child 16661
- f3d9a3646735
- child 18068
- b6554e3c8224
- child 33955
- 55aa58076485
- permissions
- -rw-r--r--
Build everything with the *_DISABLE_DEPRECATED flags set. This allows us
to detect when we're still using deprecated functions internally (and by
extension, when we've deprecated something we shouldn't have). In the
course of developing this changeset, I fixed a few such cases.
Given that the plan is to switch from PURPLE_HIDE_STRUCTS to
PURPLE_DISABLE_DEPRECATED as each struct is fully dealt with, this will
also ensure we have no regressions on the struct hiding work.
Deprecated functions are still available to the respective .c file, to
avoid missing prototype errors. Also, Perl and DBus undef the
*_DISABLE_DEPRECATED defines as appropriate so that deprecated functions
will still be exported to Perl plugins and via DBus. (Otherwise, we'd
be breaking backwards compatibility.)
|
16529
1d0da9270ff9
This is mostly moving Purple::GtkUI:: -> Pidgin:: which has the side effect of
Etan Reisner <deryni@pidgin.im>
parents:
15899
diff
changeset
|
1 | package Pidgin; |
| 14478 | 2 | |
| 3 | use 5.008; | |
| 4 | use strict; | |
| 5 | use warnings; | |
| 6 | use Carp; | |
| 7 | ||
| 8 | our $VERSION = '0.01'; | |
| 9 | ||
|
15899
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
10 | use Purple; |
| 14478 | 11 | |
| 12 | require XSLoader; | |
|
16529
1d0da9270ff9
This is mostly moving Purple::GtkUI:: -> Pidgin:: which has the side effect of
Etan Reisner <deryni@pidgin.im>
parents:
15899
diff
changeset
|
13 | XSLoader::load('Pidgin', $VERSION); |
| 14478 | 14 | |
| 15 | 1; | |
| 16 | __END__ | |
| 17 | ||
| 18 | =head1 NAME | |
| 19 | ||
|
16529
1d0da9270ff9
This is mostly moving Purple::GtkUI:: -> Pidgin:: which has the side effect of
Etan Reisner <deryni@pidgin.im>
parents:
15899
diff
changeset
|
20 | Pidgin - Perl extension for the Pidgin instant messenger. |
| 14478 | 21 | |
| 22 | =head1 SYNOPSIS | |
| 23 | ||
|
16529
1d0da9270ff9
This is mostly moving Purple::GtkUI:: -> Pidgin:: which has the side effect of
Etan Reisner <deryni@pidgin.im>
parents:
15899
diff
changeset
|
24 | use Pidgin; |
| 14478 | 25 | |
| 26 | =head1 ABSTRACT | |
| 27 | ||
| 28 | This module provides the interface for using perl scripts as plugins in | |
|
15899
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
29 | Pidgin, with access to the Pidgin Gtk interface functions. |
| 14478 | 30 | |
| 31 | =head1 DESCRIPTION | |
| 32 | ||
|
15899
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
33 | This module provides the interface for using perl scripts as plugins in Pidgin, |
|
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
34 | with access to the Pidgin Gtk interface functions. With this, developers can |
|
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
35 | write perl scripts that can be loaded in Pidgin as plugins. The script can |
|
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
36 | interact with IMs, chats, accounts, the buddy list, pidgin signals, and more. |
| 14478 | 37 | |
|
15899
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
38 | The API for the perl interface is very similar to that of the Pidgin C API, |
|
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
39 | which can be viewed at http://developer.pidgin.im/doxygen/ or in the header files |
|
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
40 | in the Pidgin source tree. |
| 14478 | 41 | |
| 42 | =head1 FUNCTIONS | |
| 43 | ||
| 44 | =over | |
| 45 | ||
| 46 | =back | |
| 47 | ||
| 48 | =head1 SEE ALSO | |
|
15899
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
49 | Pidgin C API documentation - http://developer.pidgin.im/doxygen/ |
| 14478 | 50 | |
|
15899
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
51 | The Pidgin perl module. |
| 14478 | 52 | |
|
15899
75f0041f72b8
Pidgin perl fixes for s/gaim/purple/.
Daniel Atallah <datallah@pidgin.im>
parents:
15435
diff
changeset
|
53 | Pidgin website - http://pidgin.im/ |
| 14478 | 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 |
