Mercurial > pidgin.yaz
view libpurple/protocols/null/README @ 20357:d8a47f12a3c4
applied changes from c6a89223516b0abb6cbb399c2066e3b6a7b69d19
through 63a37bce425022f4c52fab82e7169ed73f50a49e
applied changes from 63a37bce425022f4c52fab82e7169ed73f50a49e
through 8d61a119c53ac77e595d5ec300d30482b914bdf7
applied changes from 8d61a119c53ac77e595d5ec300d30482b914bdf7
through 300feed94260af48cd2026be3fd424eeb742fb77
applied changes from 300feed94260af48cd2026be3fd424eeb742fb77
through 39954083d38f554f75dac0d4fe8b2f7bac3cd0c8
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Sun, 21 Oct 2007 04:59:23 +0000 |
parents | afee8b840d91 |
children | 0edd1e140b6e |
line wrap: on
line source
nullprpl -------- OVERVIEW -------- Nullprpl is a mock protocol plugin for Pidgin and libpurple. You can create accounts with it, sign on and off, add buddies, and send and receive IMs, all without connecting to a server! Beyond that basic functionality, nullprpl supports presence and away/available messages, offline messages, user info, typing notification, privacy allow/block lists, chat rooms, whispering, room lists, and protocol icons and emblems. Notable missing features are file transfer and account registration and authentication. Nullprpl is intended as an example of how to write a libpurple protocol plugin. It doesn't contain networking code or an event loop, but it does demonstrate how to use the libpurple API to do pretty much everything a prpl might need to do. Nullprpl is also a useful tool for hacking on Pidgin, Finch, and other libpurple clients. It's a full-featured protocol plugin, but doesn't depend on an external server, so it's a quick and easy way to exercise test new code. It also allows you to work while you're disconnected. ----------------------- BUILDING AND INSTALLING ----------------------- To build, just run ./configure as usual in the root directory of the pidgin source distribution. Then cd libpurple/protocols/null and type make. To install, copy libnull.la and .libs/libnull.so into your ~/.purple/plugins directory. Then run Pidgin. To build nullprpl on Windows (with Cygwin/MinGW), use Makefile.mingw. ----- USAGE ----- To add a nullprpl account, go to the account editor window and click Add. Select Nullprpl from the protocol drop-down list, and enter any username you want. Now, use Pidgin like normal. You can add buddies, send IMs, set away messages, etc. If you send IMs to your own username, they will be echoed back to you.