# Loudmouth interface for lua

This interface to loudmouth XMPP client library for lua 5.1.

Main loudmouth project is now unmaintained, but mcabber community keeps
working version with some improvements at
<http://github.com/mcabber/loudmouth>.

Test script depends on my glib module, and thus is unusable as is.
Still, it is a good example of how things are working.

This module should be used as follows:
lm = require 'lm'
i.e., you should assign return value of *require* to some variable.

Loudmouth uses glib main loop to work, thus you should use this module 
in a glib loop environment, provided either by your glib-based program
or by some other module, eg lua binding for gtk+ or my glib module.

# Installation

To install it, you need:

 * lua (optional, to run test)
 * liblua headers and library
 * glib headers and library
 * loudmouth headers and library
 * cmake
 * c compiler (gcc)
 * linker (binutils)
 * pkg-config (to detect glib and loudmouth)
 * perl (optional, to generate documentation)

Then do: 

    $ mkdir build
    $ cd build
    $ cmake ..
    $ cmake edit_cache
    $ make
    # make install

Debian users can instead of make install do:

    $ make package
    # dpkg -i liblua5.1-loudmouth_*.deb

Users of other systems can set other CPack generator using cache editor.

# License

This code underlies terms of GNU GPL v2 or later. You can find it in
file COPYING from this distribution or on a GNU web-site
<http://www.gnu.org/licenses/>.

# Contact

I will be happy to get feedback, patches, suggestions, etc.
You can send me email or contact via jabber <isbear@unixzone.org.ua>.

  -- Myhailo Danylenko <isbear@ukrpost.net>