diff -r 8692a6fbe415 -r ea30cf6c5bea docs/readme.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/readme.mdwn Tue Aug 21 15:32:19 2012 +0300 @@ -0,0 +1,57 @@ + +# Lua scripting for MCabber + +This module creates lua interpreter environment and puts some lua +functions in it to interact with mcabber. Module provides command 'lua' +to run lua expressions in that environment. + +Lua interface is available in api reference, built with 'docgen' help. +It is also available online. + +In 'examples' dir there are some example scripts, that may be used as +is or for reference. See also 'README' in 'examples' dir. + +# Installation + +To install it, you need: + + * mcabber headers + * liblua + * glib + * gmodule + * docgen (optional, for documentation) + * cmake + * make + * c compiler (gcc) + * linker (binutils) + +Then do: + + $ mkdir build + $ cd build + $ cmake .. + $ make edit_cache + $ make + # make install + +Debian users can instead of make install do: + + $ make package + # dpkg -i libmcabber-lua_*.deb + +Users of other distributions can select appropriate package 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 +. + +# Contact + +I will be happy to get feedback, patches, suggestions, etc. +You can send me email or contact via jabber . + + -- Myhailo Danylenko +