150 lines
6.2 KiB
Org Mode
150 lines
6.2 KiB
Org Mode
#+TITLE: jabber.el
|
|
#+OPTIONS: num:nil author:nil skip:nil
|
|
|
|
#+BEGIN_HTML
|
|
<a href="http://sourceforge.net">
|
|
<img border="0" src="http://sourceforge.net/sflogo.php?group_id=88346&type=2" width="125" height="37" alt="SourceForge.net Logo" style="position: absolute; top: 0em; right: 0em;"></a>
|
|
#+END_HTML
|
|
|
|
jabber.el is a Jabber client for Emacs.
|
|
|
|
[TABLE-OF-CONTENTS]
|
|
|
|
# <<impatient>>
|
|
For the impatient:
|
|
|
|
- Latest release: [[http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=482983][0.7.1]] (31-Jan-2007)
|
|
- Latest pretest release: [[http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=278300&release_id=662240][0.7.93]] (19-Feb-2009)
|
|
- Full [[list-of-releases][list of releases]], including lists of features and changes
|
|
|
|
External resources:
|
|
|
|
- [[http://sourceforge.net/projects/emacs-jabber/][Sourceforge project page]], containing:
|
|
- trackers for
|
|
[[http://sourceforge.net/tracker/?atid=586350&group_id=88346&func=browse][bugs]],
|
|
[[http://sourceforge.net/tracker/?atid=586353&group_id=88346&func=browse][feature requests]],
|
|
[[http://sourceforge.net/tracker/?atid=586352&group_id=88346&func=browse][patches]] and
|
|
[[http://sourceforge.net/tracker/?atid=586351&group_id=88346&func=browse][support requests]], open for anonymous posters
|
|
- [[http://sourceforge.net/forum/?group_id=88346][forums]], open for anonymous posters
|
|
- [[http://www.emacswiki.org/cgi-bin/wiki/JabberEl][the JabberEl page of EmacsWiki]]
|
|
- Mailing lists (also available at [[http://gmane.net][Gmane]]):
|
|
- [[http://lists.sourceforge.net/lists/listinfo/emacs-jabber-general][emacs-jabber-general]], for posts by humans (also [[http://dir.gmane.org/gmane.emacs.jabber.general][gmane.emacs.jabber.general]])
|
|
- [[http://lists.sourceforge.net/lists/listinfo/emacs-jabber-commit][emacs-jabber-commit]], read-only mailing list of CVS commits (also [[http://dir.gmane.org/gmane.emacs.jabber.scm][gmane.emacs.jabber.scm]])
|
|
- [[http://lists.sourceforge.net/lists/listinfo/emacs-jabber-bugs][emacs-jabber-bugs]], read-only mailing list of bug tracker activity (also [[http://dir.gmane.org/gmane.emacs.jabber.bugs][gmane.emacs.jabber.bugs]])
|
|
- the Jabber chat room
|
|
#+HTML: <a href="xmpp:jabber.el@conference.jabber.se?join">jabber.el@conference.jabber.se</a>
|
|
- the [[file:manual-0.7.1/][manual for jabber.el 0.7.1]] (also included in the release files)
|
|
|
|
* What is Jabber?
|
|
|
|
Jabber is an open instant messaging (IM) system, also known as XMPP.
|
|
It is described in [[http://www.xmpp.org/rfcs/][RFCs 3920-3923]] and a series of [[http://www.xmpp.org/extensions/][XEPs]] (XMPP Extension
|
|
Proposals). That is, unlike legacy IM systems (such as ICQ or MSN
|
|
Messenger), the protocol is published in the open, free for anyone to
|
|
implement. Therefore you shouldn't be surprised that there is a
|
|
Jabber client for Emacs, too. (If you are not of the Emacs
|
|
persuasion, see this [[http://www.jabber.org/software/clients.shtml][list of Jabber clients]].)
|
|
|
|
Jabber is, like e-mail, a decentralised system. A Jabber identifier
|
|
(JID) is of the form =username@server=, just like an e-mail address, and
|
|
every Jabber user whose server is open to Internet connections can
|
|
communicate with any other user. This is in stark contrast to the
|
|
legacy "walled-garden" IM systems, where you need a separate account
|
|
for each system to be able to communicate with its users. Note that
|
|
the [[http://talk.google.com][Google Talk]] service is an XMPP service, so if you have a GMail
|
|
account, you already have a JID ending with =@gmail.com=.
|
|
|
|
In Jabber, you have a "roster", a list of contacts. You can see
|
|
which of them are online at the moment, and chat with them. (You can
|
|
also send messages to an offline contact, and the message will be
|
|
stored on the server for later delivery.) Jabber also supports
|
|
IRC-style chat rooms.
|
|
|
|
* What is jabber.el?
|
|
|
|
jabber.el is a Jabber client for Emacs. It may seem strange to have a
|
|
chat client in an editor, but consider that chatting is, after all,
|
|
just a special case of text editing.
|
|
|
|
* Downloading and installing
|
|
|
|
** Prepackaged
|
|
|
|
Note that jabber.el is available as [[http://packages.debian.org/emacs-jabber][emacs-jabber in Debian]], and in
|
|
[[http://packages.ubuntu.com/emacs-jabber][Ubuntu's "universe" section]].
|
|
|
|
** Dependencies
|
|
|
|
jabber.el requires either GNU Emacs 22, or GNU Emacs 21 combined with
|
|
Gnus 5.10. You should get these from your distribution, or from the
|
|
[[http://www.gnu.org/software/emacs/][Emacs]] and [[http://gnus.org][Gnus]] web sites.
|
|
|
|
However, if you want to connect to servers that use SRV records
|
|
(e.g. Google Talk), it is recommended to use either No Gnus or Gnus
|
|
5.13.
|
|
|
|
If you want encrypted connections (some servers, e.g. Google Talk,
|
|
require it), you need [[http://www.gnu.org/software/gnutls/][GnuTLS]] installed.
|
|
|
|
** Downloading
|
|
|
|
Download the [[impatient][latest release]] and unpack it in a suitable location. Add
|
|
something like the following to your =.emacs= file:
|
|
|
|
#+BEGIN_EXAMPLE
|
|
;; adjust this path:
|
|
(add-to-list 'load-path "/path/to/emacs-jabber")
|
|
;; For 0.7.1 and below:
|
|
(require 'jabber)
|
|
;; For 0.7.90 and above:
|
|
(require 'jabber-autoloads)
|
|
#+END_EXAMPLE
|
|
|
|
Either evaluate those lines, or restart Emacs.
|
|
|
|
** Using
|
|
|
|
See the [[file:manual-0.7.1/Basic-operation.html][Basic Operation]] in the manual.
|
|
|
|
|
|
|
|
* Reporting bugs
|
|
|
|
Bug reports can be sent either to the mailing list
|
|
[[http://lists.sourceforge.net/lists/listinfo/emacs-jabber-general][emacs-jabber-general]] or to the [[http://sourceforge.net/tracker/?group_id=88346&atid=586350][bug tracker]].
|
|
|
|
|
|
* Latest source
|
|
|
|
jabber.el releases are, unfortunately, less frequent than they would
|
|
be in an ideal world. You can get the latest development version
|
|
using various version control systems.
|
|
|
|
** CVS
|
|
|
|
See [[http://sourceforge.net/cvs/?group_id=88346][the Sourceforge CVS page]]. In short, run the following command:
|
|
|
|
#+BEGIN_EXAMPLE
|
|
cvs -z3 -d:pserver:anonymous@emacs-jabber.cvs.sourceforge.net:/cvsroot/emacs-jabber co -P emacs-jabber
|
|
#+END_EXAMPLE
|
|
|
|
** GNU Arch
|
|
|
|
The GNU Arch mirror is no longer being updated.
|
|
|
|
** git
|
|
|
|
#+BEGIN_EXAMPLE
|
|
git-clone git://git.catap.ru/emacs-jabber.git
|
|
#+END_EXAMPLE
|
|
|
|
|
|
* List of releases
|
|
|
|
The list of releases has been moved to a [[file:list-of-releases.org][separate page]].
|
|
|
|
# Local variables:
|
|
# mode: org
|
|
# eval: (progn (add-to-list 'org-link-types "xmpp") (org-make-link-regexps))
|
|
# End:
|