.TH TELEPATHY-GABBLE "8" "October 2007" "Telepathy" "D-Bus services"
\" This man page was written by Simon McVittie for the Debian project,
\" but may be used by others.
\" Copyright © 2007 Collabora Ltd. <http://www.collabora.co.uk/>
\" It may be distributed under the same terms as telepathy-gabble itself.
.SH NAME
telepathy-gabble \- Telepathy connection manager for XMPP (Jabber)
.SH SYNOPSIS
\fB/usr/lib/telepathy/telepathy\-gabble\fR
.SH DESCRIPTION
Gabble implements the Telepathy D-Bus specification for XMPP (Jabber),
allowing Telepathy clients like
.BR empathy (1)
to connect to XMPP accounts, including Google Talk.
.PP
It is a D-Bus service which runs on the session bus, and should usually be
started automatically by D-Bus activation. However, it might be useful to
start it manually for debugging.
.SH OPTIONS
There are no command-line options.
.SH ENVIRONMENT
.TP
\fBGABBLE_LOGFILE\fR=\fIfilename\fR
If set, debug output will go to the given file rather than to stderr.
If \fB+\fR is prepended to the \fIfilename\fR (e.g.
\fBGABBLE_LOGFILE=+gabble.log\fR), debug output will be appended
to the file; otherwise, any existing file will be replaced.
.TP
\fBGABBLE_DEBUG\fR=\fItype\fR
May be set to "all" for full debug output, or various undocumented options
(which may change from release to release) to filter the output.
.TP
\fBWOCKY_DEBUG\fR=\fItype\fR
May be set to "all" for full debug output from the Wocky XMPP library used
by Gabble, or various undocumented options (which may change from release to
release) to filter the output. For general Gabble debugging, "net" is
recommended.
.TP
\fBGABBLE_PERSIST\fR=\fI1\fR
If set (to any value), Gabble will continue running until killed, rather than
timing out if it has no open connections for a few seconds.
.TP
\fBGABBLE_PLUGIN_DIR\fR=\fIdirectory\fR
If set, and Gabble was compiled with plugin support, plugins will be loaded
from \fIdirectory\fR rather than from the default directory.
.SH SEE ALSO
.IR http://telepathy.freedesktop.org/ ,
.IR http://telepathy.freedesktop.org/wiki/CategoryGabble ,
.BR empathy (1)