annotate libpurple/protocols/null/README @ 24389:2b62300d2c19

Use libtool to build static archives when --with-static-prpls is passed to configure. Does anyone know why we weren't using libtool before? We were building old-fashioned .a files. But libtool archives (.la) can contain either static or shared libraries. I found it a lot easier to get static prpl compilation working after making this change (that is to say, it worked). Without this I got this error, which is probably fixable, but consistently using libtool seems like it makes things easier: *** Warning: Linking the shared library libpurple.la against the *** static library ../libpurple/protocols/msn/libmsn.a is not portable! /usr/bin/ld: ../libpurple/protocols/msn/libmsn.a(libmsn_a-msn.o): relocation R_X86_64_32 against `a local symbol' can not be used when making a shared object; recompile with -fPIC ../libpurple/protocols/msn/libmsn.a: could not read symbols: Bad value collect2: ld returned 1 exit status

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.