| 10 valuable aid to developers wishing to write scripts to modify the behavior |
10 valuable aid to developers wishing to write scripts to modify the behavior |
| 11 of their favorite instant messenger. A perl script acts like a normal |
11 of their favorite instant messenger. A perl script acts like a normal |
| 12 plugin, and appears in the list of plugins in Gaim's preferences pane. |
12 plugin, and appears in the list of plugins in Gaim's preferences pane. |
| 13 Until now, they have been very basic, and consisted of only a few |
13 Until now, they have been very basic, and consisted of only a few |
| 14 functions. However, with the latest changes to Gaim's perl API, a much |
14 functions. However, with the latest changes to Gaim's perl API, a much |
| 15 larger part of Gaim is now open. In time, even such things as Gtk+ |
15 larger part of Gaim is now open. In time, even such things as GTK+ |
| 16 preference panes for perl scripts will be possible. |
16 preference panes for perl scripts will be possible. |
| 17 |
17 |
| 18 @section first-script Writing your first perl script |
18 @section first-script Writing your first perl script |
| 19 Enough of that. You want to know how to write a perl script, right? |
19 Enough of that. You want to know how to write a perl script, right? |
| 20 |
20 |
| 60 @endcode |
60 @endcode |
| 61 |
61 |
| 62 |
62 |
| 63 The first thing you see is a hash called @c @%PLUGIN_INFO. It contains |
63 The first thing you see is a hash called @c @%PLUGIN_INFO. It contains |
| 64 the basic information on your plugin. In the future, additional fields |
64 the basic information on your plugin. In the future, additional fields |
| 65 may be allowed, such as ones to setup a Gtk+ preferences pane. |
65 may be allowed, such as ones to setup a GTK+ preferences pane. |
| 66 |
66 |
| 67 The @c plugin_init function is required in all perl scripts. Its job |
67 The @c plugin_init function is required in all perl scripts. Its job |
| 68 is to return the @c @%PLUGIN_INFO hash, which Gaim will use to register |
68 is to return the @c @%PLUGIN_INFO hash, which Gaim will use to register |
| 69 and initialize your plugin. |
69 and initialize your plugin. |
| 70 |
70 |