4905dbbe6c
Currently, add-ons are disconnected when ChatProtocol::Shutdown() is called, which the add-on can do by itself― but there is no standard way for add-ons to notify the app about their Shutdown. Because of this, they tend to not call Shutdown()― instead (as in the case of the Jabber add-on), they display a BAlert (IM_ERROR) notifying the user of the connection error, but the account is considered active by Cardie (and its threads are still existant, including its ProtocolLooper). Zombies are bad, so this is redesigned somewhat with this commit: Protocols should no longer call ChatProtocol::Shutdown() themselves, they must send an IM_MESSAGE of IM_PROTOCOL_DISABLE to the app. This will delete its ProtocolLooper, which in turn will send a notification to the user and delete the ChatProtocol, and so calling ChatProtocol::Shutdown(). In the included protocols, an IM_ERROR is sent right before IM_PROTOCOL_DISABLE is sent if due to a connection error. This is not required, but it is courteous to inform your user about the "why." :) |
||
|---|---|---|
| application | ||
| data | ||
| libs | ||
| protocols | ||
| smileys | ||
| Contributors | ||
| License | ||
| Makefile | ||
| Makefile.common | ||
| README.md | ||
Cardie
A multi-protocol chat program.
Building
You can make Cardie and its protocols with:
$ make
Or one-by-one:
$ make libs; make app; make protocols
Cardie itself requires the expat_devel package, the XMPP protocol requires
gloox_devel, and the libpurple add-on requires libpurple_devel and
glib2_devel.
The (provisional) IRC protocol requires libircclient_devel, openssl_devel,
and zlib_devel, though you have to build it specifically:
$ make -f protocols/irc/Makefile
License
Cardie itself is under the MIT license, but licenses vary for the included libraries and add-ons.
The xmpp and purple add-ons are under the GPLv2+, and irc the MIT license.
libsupport is under the MIT license, though containing some PD code.
librunview contains code from Vision, and is under the MPL.
libinterface is under the MIT license.