README
author Mikael Hallendal <micke@imendio.com>
Sat, 24 Feb 2007 16:51:06 +0100
changeset 245 df2655dbe873
parent 84 7ae7b690aa89
child 251 05623c3ec249
permissions -rw-r--r--
Make LmConnection accept not having a server set as long as JID is set. Extracted the server from JID code into connection_get_server_from_jid. Also make connection_do_connect accept that server is not set as long as it can extract this from a set JID.

Introduction:
=============

Loudmouth is a lightweight and easy-to-use C library for programming with the
Jabber protocol. It's designed to be easy to get started with and yet
extensible to let you do anything the Jabber protocol allows.

The goal is to fully support Linux, *BSD, Mac OSX and Windows. It has
currently only been tested on Linux (Red Hat 8.0, Debian Unstable) and FreeBSD
that I know of. If someone with access to other machines can provide
feedback I would be most grateful.


Requirements:
=============

Glib >= 2.0:
ftp://ftp.gtk.org/pub/gtk/v2.2/

gtk-doc (optional, if you want documentation built):
ftp://ftp.gnome.org/pub/GNOME/sources/gtk-doc/1.0

If you want SSL-support you'll also need:
GnuTLS >= 1.0.0might have to be built with '--with-included-libtasn1')

Building:
=========

./configure --prefix=
make
make install


Debugging:
==========

You can get debug information printed to STDOUT by using the environment 
variable LM_DEBUG.

export LM_DEBUG=<keyword>

Where keyword is one or more (separated by :) of the following:

* "NET": Shows all the data sent over the network.
* "PARSER": Shows debug output from the parser.
* "VERBOSE": Shows various verbose output.
* "ALL": Enables all output.


Questions, remarks, bug reports:
================================

See the web page for more information and issue reporting.

http://projects.imendio.com/loudmouth

Questions and others can be sent to me at:
email: micke@imendio.com
jabber: micke@imendio.com