README
author hallski <hallski>
Sun, 10 Sep 2006 22:09:45 +0000
changeset 175 5e665ffe3e9c
parent 84 7ae7b690aa89
child 251 05623c3ec249
permissions -rw-r--r--
2006-09-11 Mikael Hallendal <micke@imendio.com> * Release 1.0.5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     1
Introduction:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     2
=============
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     3
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     4
Loudmouth is a lightweight and easy-to-use C library for programming with the
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     5
Jabber protocol. It's designed to be easy to get started with and yet
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     6
extensible to let you do anything the Jabber protocol allows.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     7
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     8
The goal is to fully support Linux, *BSD, Mac OSX and Windows. It has
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
     9
currently only been tested on Linux (Red Hat 8.0, Debian Unstable) and FreeBSD
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    10
that I know of. If someone with access to other machines can provide
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    11
feedback I would be most grateful.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    12
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    13
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    14
Requirements:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    15
=============
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    16
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    17
Glib >= 2.0:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    18
ftp://ftp.gtk.org/pub/gtk/v2.2/
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    19
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    20
gtk-doc (optional, if you want documentation built):
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    21
ftp://ftp.gnome.org/pub/GNOME/sources/gtk-doc/1.0
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    22
29
06a0e0c2e2eb 2003-08-04 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 7
diff changeset
    23
If you want SSL-support you'll also need:
84
7ae7b690aa89 2004-05-28 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 81
diff changeset
    24
GnuTLS >= 1.0.0might have to be built with '--with-included-libtasn1')
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    25
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    26
Building:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    27
=========
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    28
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    29
./configure --prefix=
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    30
make
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    31
make install
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    32
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    33
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    34
Debugging:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    35
==========
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    36
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    37
You can get debug information printed to STDOUT by using the environment 
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    38
variable LM_DEBUG.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    39
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    40
export LM_DEBUG=<keyword>
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    41
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    42
Where keyword is one or more (separated by :) of the following:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    43
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    44
* "NET": Shows all the data sent over the network.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    45
* "PARSER": Shows debug output from the parser.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    46
* "VERBOSE": Shows various verbose output.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    47
* "ALL": Enables all output.
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    48
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    49
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    50
Questions, remarks, bug reports:
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    51
================================
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    52
81
b9dfe6efc011 2004-02-05 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 58
diff changeset
    53
See the web page for more information and issue reporting.
b9dfe6efc011 2004-02-05 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 58
diff changeset
    54
b9dfe6efc011 2004-02-05 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 58
diff changeset
    55
http://projects.imendio.com/loudmouth
1
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    56
50e230cf7818 Initial revision
hallski <hallski>
parents:
diff changeset
    57
Questions and others can be sent to me at:
7
d8eae83450ac 2003-06-13 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 3
diff changeset
    58
email: micke@imendio.com
d8eae83450ac 2003-06-13 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents: 3
diff changeset
    59
jabber: micke@imendio.com