This is jabber.el 0.7, 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
GNU Emacs
=========
jabber.el depends on GNU Emacs 21, 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 JEP-0077 authentication.
TLS/SSL
=======
To get an encrypted connection, you need 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, 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.
StartTLS is not supported in this version of jabber.el.
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.
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 experimental support for file
transfer. It is not enabled by default. See the file
filetransfer.txt for details.
