PLUGIN_HOWTO

Wed, 10 Jan 2007 03:47:57 +0000

author
Nathan Walp <nwalp@pidgin.im>
date
Wed, 10 Jan 2007 03:47:57 +0000
changeset 15370
ec2add2105cb
parent 14567
633cd2adce3c
child 15998
294277e634fc
child 20470
77693555855f
permissions
-rw-r--r--

[gaim-migrate @ 18099]
do utf8 validation on string and string list prefs

add new path and path list pref types
these aren't used yet...we need to audit our prefs, and replace as appropriate, but I'm too tired to do that tonight

14566
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
1 For information on writing a plugin for Gaim, go
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
2 http://gaim.sourceforge.net/api/ and see the HOWTOs in the
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
3 "Related Pages" section.
93
a62ef5a64629 [gaim-migrate @ 103]
Eric Warmenhoven <warmenhoven@yahoo.com>
parents:
diff changeset
4
14566
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
5 You can also generate this documentation locally by installing
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
6 doxygen and graphviz dot, then running "make docs" in the Gaim
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
7 source tree. The documentation will be in the docs/html directory.
93
a62ef5a64629 [gaim-migrate @ 103]
Eric Warmenhoven <warmenhoven@yahoo.com>
parents:
diff changeset
8
14566
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
9 This next paragraph is old and possibly out of date:
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
10 Compilation of the plugins is fairly straight-forward; there is a
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
11 Makefile in this directory that has a rule for making the .so file
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
12 from a .c file. No modification of the Makefile should be necessary,
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
13 unless if you simply want to type 'make' to have it made; otherwise,
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
14 'make filename.so' will take filename.c and make the .so plugin from
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
15 it. If you need to link in with extra libraries, you can set the
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
16 environment variable PLUGIN_LIBS to be the libraries you want to link
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
17 with.
93
a62ef5a64629 [gaim-migrate @ 103]
Eric Warmenhoven <warmenhoven@yahoo.com>
parents:
diff changeset
18
14566
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
19 It should be possible to compile plugins outside of the Gaim source
373d653d0733 [gaim-migrate @ 17223]
Mark Doliner <markdoliner@pidgin.im>
parents: 14253
diff changeset
20 tree, which is a much cleaner solution.

mercurial