117 lines
4.5 KiB
Plaintext
117 lines
4.5 KiB
Plaintext
This is jabber.el 0.8, a Jabber client for Emacs. If you don't know
|
|
what Jabber is, see http://www.jabber.org .
|
|
|
|
Home page: http://emacs-jabber.sourceforge.net
|
|
Project page: http://sourceforge.net/projects/emacs-jabber
|
|
Wiki page: http://www.emacswiki.org/cgi-bin/wiki/JabberEl
|
|
Mailing list: http://lists.sourceforge.net/lists/listinfo/emacs-jabber-general
|
|
and: http://dir.gmane.org/gmane.emacs.jabber.general
|
|
MUC room: jabber.el@conference.jabber.se and emacs@conference.jabber.ru (Russian, English)
|
|
|
|
GNU Emacs
|
|
=========
|
|
|
|
jabber.el depends on GNU Emacs (21, 22, 23 works fine), in particular
|
|
xml.el, and some files from Gnus 5.10. If you don't have Gnus 5.10
|
|
(M-x gnus-version will tell), you can download sha1.el and hex-util.el
|
|
from Gnus CVS at http://quimby.gnus.org/cgi-bin/cvsweb.cgi/gnus/lisp/
|
|
|
|
|
|
XEmacs
|
|
======
|
|
|
|
You need an XEmacs with Mule support, and recent versions of the gnus,
|
|
net-utils and mule-ucs packages. jabber.el basically works on XEmacs,
|
|
but some features are missing (in particular mouse support). Testing
|
|
and patches are very welcome.
|
|
|
|
SASL
|
|
====
|
|
jabber.el will use the SASL library of FLIM (Faithful Library about
|
|
Internet Message; it is also included in newer versions of Gnus) if
|
|
it's present. If not, it will fall back to XEP-0077 authentication.
|
|
|
|
TLS/SSL
|
|
=======
|
|
To get an encrypted connection, the most convenient option is to
|
|
install starttls.el from Gnus (currently only present in the
|
|
development version). This requires GnuTLS to be installed, but
|
|
requires no configuration at all.
|
|
|
|
You can also use either tls.el (from Gnus) or ssl.el. These are
|
|
interfaces to GnuTLS and OpenSSL, respectively; use the appropriate
|
|
one. Recent versions of tls.el support both programs, though. The
|
|
version of ssl.el distributed with Gnus is outdated; use the one from
|
|
W3 CVS instead:
|
|
http://cvs.savannah.gnu.org/viewcvs/w3/lisp/ssl.el?root=w3
|
|
|
|
To actually use encryption with one of these libraries, customize the
|
|
variables jabber-connection-type and jabber-connection-ssl-program.
|
|
|
|
Note that only the connection from you to the server is encrypted;
|
|
there is no guarantee of other connections being encrypted.
|
|
|
|
Installation
|
|
============
|
|
To install, put all .el files somewhere in your load-path (or have
|
|
your load-path include the directory they're in) and put
|
|
(require 'jabber) in your .emacs file. To install the Info
|
|
documentation, copy jabber.info to /usr/local/info and run
|
|
"install-info /usr/local/info/jabber.info".
|
|
|
|
If you've been using a post-0.6 CVS version of jabber.el, you might
|
|
need to remove some redundant hook functions. Make sure that
|
|
jabber-alert-message-hooks doesn't contain jabber-message-history, and
|
|
that jabber-alert-presence-hooks doesn't contain
|
|
jabber-presence-watch.
|
|
|
|
Also, users upgrading from 0.7-0.7.x may meet some configuration
|
|
issues. Please, report them as bugs in tracker, to help update docs.
|
|
|
|
Usage
|
|
=====
|
|
To start using it, type M-x jabber-customize and set your username and
|
|
server. Then, type C-x C-j C-c (or equivalently M-x jabber-connect)
|
|
to connect (with prefix argument, register new account).
|
|
|
|
Your roster is displayed in a buffer called *-jabber-*. To
|
|
disconnect, type C-x C-j C-d or M-x jabber-disconnect.
|
|
|
|
You may want to use the menu bar to execute Jabber commands. To
|
|
enable the Jabber menu, type M-x jabber-menu.
|
|
|
|
For a less terse description, read the enclosed manual.
|
|
|
|
For bug reports, help requests and other feedback, use the trackers
|
|
and forums at the project page mentioned above.
|
|
|
|
Configuration
|
|
=============
|
|
All available configuration options are described in the manual. This
|
|
section only serves to point out the most important ones.
|
|
|
|
To change how you are notified about incoming events, type M-x
|
|
customize-group RET jabber-alerts.
|
|
|
|
To activate logging of all chats, set jabber-history-enabled to t. By
|
|
default, history will be saved in ~/.jabber_global_message_log; make
|
|
sure that this file has appropriate permissions. Type M-x
|
|
customize-group RET jabber-history for more options.
|
|
|
|
By default, jabber.el will send a confirmation when messages sent to
|
|
you are delivered and displayed, and also send "contact is typing"
|
|
notifications. To change this, type M-x customize-group RET
|
|
jabber-events, and set the three jabber-events-confirm-* variables to
|
|
nil.
|
|
|
|
File transfer
|
|
=============
|
|
This release of jabber.el contains support for file transfer. You may
|
|
need to configure some variables to make it work; see the manual for
|
|
details.
|
|
|
|
XMPP URIs
|
|
=========
|
|
It is possible to make various web browsers pass links starting with
|
|
"xmpp:" to jabber.el. See the manual, section "XMPP URIs".
|