summaryrefslogtreecommitdiff
path: root/README
blob: 225b089310825ca706e5c764f47e1387ff7edc3c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
===============
telepathy-salut
===============

Salut is a link-local XMPP (XEP-0174) connection manager for the Telepathy
framework, currently supporting presence and single-user chats with iChat
interoperability, and multi-user chats and Tubes using the Clique protocol
<http://telepathy.freedesktop.org/wiki/Clique>.

Telepathy is a D-Bus framework for unifying real time communication,
including instant messaging, voice calls and video calls. It abstracts
differences between protocols to provide a unified interface for
applications.

Requirements
============

telepathy-salut requires:
  telepathy-glib <http://telepathy.freedesktop.org/releases/telepathy-glib/>
  libxml2 <http://xmlsoft.org/>
  GLib, GObject <http://ftp.gnome.org/pub/GNOME/sources/glib/>
  libdbus <http://dbus.freedesktop.org/releases/dbus/>
  The D-Bus GLib bindings <http://dbus.freedesktop.org/releases/dbus-glib/>
and optionally uses:
  libasyncns <http://0pointer.de/lennart/projects/libasyncns/>

For the Avahi backend on Linux:
  avahi-gobject <http://avahi.org/download/>

For the Bonjour backend on Windows/mingw32:
  dns-sd client library with mingw support
    <http://cgit.collabora.com/git/libdnssd-ytstenut.git/>

At build time, it also requires:
  GNU make <http://www.gnu.org/software/make/>
  pkg-config <http://ftp.gnome.org/pub/GNOME/sources/pkg-config/>
  libxslt, xsltproc <http://xmlsoft.org/XSLT/>
  Python <http://www.python.org/>

See configure.ac for full details, including versions required.

Building from Git also requires the GNU build system (Autoconf, Automake,
libtool).

Bugs, feature requests and to-do list
=====================================

Report all bugs, feature requests and "to-do" items here:
  <https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=telepathy-salut>

Versioning policy
=================

We use an "odd/even" versioning scheme where the minor version (the y in
x.y.z) determines stability - stable branches have y even, development
branches have y odd.

Unreleased builds straight from Darcs identify themselves as version
"x.y.z.1". These are compiled with -Werror, so they might stop working
if your gcc version issues more warnings than ours. If this is a problem
for you, use a release tarball.

Contact info
============

This package is maintained by the Telepathy project:
  <http://telepathy.freedesktop.org/>
  <mailto:telepathy@lists.freedesktop.org>
  <irc://irc.freenode.net/telepathy>

Telepathy development is supported by Collabora Ltd.
  <http://www.collabora.co.uk/>.

Hacking
=======

The current version of telepathy-salut is always available from:
  <http://git.collabora.co.uk/?p=telepathy-salut.git>

Please follow <http://telepathy.freedesktop.org/wiki/Style> in new code.