annotate PLUGIN_HOWTO @ 20633:4c910fcb5b0a

Consider offline contacts when calculating the priority buddy. I was seeing assertion failures when aliasing a guy in my blist because gtk_blist_renderer_edited_cb() called gtk_blist_auto_personize() which iterates through everyone in that group (whether online or not) and calls purple_contact_get_alias() to determine whether it should prompt to merge the buddies. purple_contact_get_alias() calls purple_contact_get_priority_buddy() which returns NULL if all buddies in that contact are offline. Might as well just return the first PurpleBuddy if they're all offline, right?

For information on writing a plugin for Purple, Pidgin or Finch, go
http://developer.pidgin.im and click on API.  From there, 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
source tree.  The documentation will be in the docs/html directory.