This is jabber.el 0.8, a Jabber client for Emacs.  Jabber (also known
as XMPP) is an instant messaging system; see http://www.jabber.org for
more information.

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 get sha1.el and hex-util.el
from the compat subdirectory.  (The configure script tries to detect
this situation and include the files in the build)


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 Emacs (from version 23) or Gnus
(from No Gnus 0.3) 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 use
starttls.el (from Emacs 22 or Gnus 5.10).  This requires GnuTLS (in
particular the command line tool gnutls-cli) to be installed, but
requires no configuration at all.

You can also use either tls.el (from Emacs 22 or Gnus 5.10) 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 use the latter form of encryption, customize jabber-account-list.

Note that only the connection from you to the server is encrypted;
there is no guarantee of other connections being encrypted.

Installation
============
jabber.el can be installed using the commands:
./configure
make
make install

You can specify which emacs you want to use:
./configure EMACS=emacs-or-xemacs-21.4

You can also install jabber.el by hand.  Put all .el files somewhere
in your load-path, or have your load-path include the directory
they're in.  To install the Info documentation, copy jabber.info to
/usr/local/info and run "install-info /usr/local/info/jabber.info".

After installation by either method, add (load "jabber-autoloads") to
your .emacs file.  (If you got the code from GIT, you still need the
makefile to generate jabber-autoloads.el.)

If you are upgrading from 0.7-0.7.x, you need to update your
configuration.  See the section "Account settings" in the manual.

Special notes for GIT version
=============================
If you are running jabber.el from GIT, you need to generate the
jabber-autoloads.el file yourself.  The simplest way to do this is by
using the "./configure && make" process.

To generate the configure script, make sure that autoconf and automake
are installed and run "autoreconf -i".

Usage
=====

To connect to a Jabber server, type C-x C-j C-c (or equivalently M-x
jabber-connect-all) and enter your JID.  With prefix argument,
register a new account.  You can set your JID permanently with M-x
jabber-customize.

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.  In the ideal case, this works right after
running "make install".  Otherwise, see the manual, section "XMPP
URIs".