summaryrefslogtreecommitdiff
path: root/README
blob: 549db8c339cc06df0de519adbeec88530b3f021e (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
This is jabber.el 0.6.1, 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) if it's present.  If not, it will fall back to
JEP-0077 authentication.

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 M-x jabber-connect to connect (with prefix
argument, register new account) and M-x jabber-send-presence to send
presence (when asked for "show", an empty string means "online", and
the other choices can be found via tab completion).

Your roster is displayed in a buffer called *-jabber-*.  To
disconnect, type 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.

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.