annotate PLUGIN_HOWTO @ 15279:fbfdbde296b0

[gaim-migrate @ 18069] Patch from Graham Booker which prevents the following crash: Thread 0 Crashed: 0 Libgaim 0x0fbbbe3a flap_connection_send + 17 (flap_connection.c:977) 1 Libgaim 0x0fbb2c04 aim_srv_setidle + 61 (family_oservice.c:588) 2 Libgaim 0x0fb1470e set_account_unidle + 122 (idle.c:93) 3 Libgaim 0x0fafd75c gaim_signal_emit_vargs + 234 (signals.c:485) 4 Libgaim 0x0fafd7c4 gaim_signal_emit + 90 (signals.c:435) 5 Libgaim 0x0fb1da57 gaim_connection_destroy + 186 (connection.c:180) 6 Libgaim 0x0fb2cb46 gaim_account_disconnect + 119 (account.c:1017) 7 Libgaim 0x0fb1d3ee gaim_connection_disconnect_cb + 37 (connection.c:425) committer: Tailor Script <[e-mail]>

For information on writing a plugin for Gaim, go
http://gaim.sourceforge.net/api/ and see the HOWTOs in the
"Related Pages" section.

You can also generate this documentation locally by installing
doxygen and graphviz dot, then running "make docs" in the Gaim
source tree.  The documentation will be in the docs/html directory.

This next paragraph is old and possibly out of date:
Compilation of the plugins is fairly straight-forward; there is a
Makefile in this directory that has a rule for making the .so file
from a .c file. No modification of the Makefile should be necessary,
unless if you simply want to type 'make' to have it made; otherwise,
'make filename.so' will take filename.c and make the .so plugin from
it. If you need to link in with extra libraries, you can set the
environment variable PLUGIN_LIBS to be the libraries you want to link
with.

It should be possible to compile plugins outside of the Gaim source
tree, which is a much cleaner solution.