index.org

   1 #+TITLE: jabber.el
   2 #+OPTIONS: num:nil author:nil skip:nil
   3
   4 #+BEGIN_HTML
   5 <a href="http://sourceforge.net">
   6 <img border="0" src="http://sourceforge.net/sflogo.php?group_id=88346&amp;type=2" width="125" height="37" alt="SourceForge.net Logo" style="position: absolute; top: 0em; right: 0em;"></a>
   7 #+END_HTML
   8
   9 jabber.el is a Jabber client for Emacs.
  10
  11 [TABLE-OF-CONTENTS]
  12
  13 # <<impatient>>
  14 For the impatient:
  15
  16  - Latest release: [[http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=482983][0.7.1]] (31-Jan-2007)
  17  - Latest pretest release: [[http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=278300&release_id=662240][0.7.93]] (19-Feb-2009)
  18  - Full [[list-of-releases][list of releases]], including lists of features and changes
  19
  20 External resources:
  21
  22  - [[http://sourceforge.net/projects/emacs-jabber/][Sourceforge project page]], containing:
  23    - trackers for
  24      [[http://sourceforge.net/tracker/?atid=586350&group_id=88346&func=browse][bugs]],
  25      [[http://sourceforge.net/tracker/?atid=586353&group_id=88346&func=browse][feature requests]],
  26      [[http://sourceforge.net/tracker/?atid=586352&group_id=88346&func=browse][patches]] and
  27      [[http://sourceforge.net/tracker/?atid=586351&group_id=88346&func=browse][support requests]], open for anonymous posters
  28    - [[http://sourceforge.net/forum/?group_id=88346][forums]], open for anonymous posters
  29  - [[http://www.emacswiki.org/cgi-bin/wiki/JabberEl][the JabberEl page of EmacsWiki]]
  30  - Mailing lists (also available at [[http://gmane.net][Gmane]]):
  31    - [[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]])
  32    - [[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]])
  33    - [[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]])
  34  - the Jabber chat room
  35 #+HTML:  <a href="xmpp:jabber.el@conference.jabber.se?join">jabber.el@conference.jabber.se</a>
  36  - the [[file:manual-0.7.1/][manual for jabber.el 0.7.1]] (also included in the release files)
  37
  38 * What is Jabber?
  39
  40 Jabber is an open instant messaging (IM) system, also known as XMPP.
  41 It is described in [[http://www.xmpp.org/rfcs/][RFCs 3920-3923]] and a series of [[http://www.xmpp.org/extensions/][XEPs]] (XMPP Extension
  42 Proposals).  That is, unlike legacy IM systems (such as ICQ or MSN
  43 Messenger), the protocol is published in the open, free for anyone to
  44 implement.  Therefore you shouldn't be surprised that there is a
  45 Jabber client for Emacs, too.  (If you are not of the Emacs
  46 persuasion, see this [[http://www.jabber.org/software/clients.shtml][list of Jabber clients]].)
  47
  48 Jabber is, like e-mail, a decentralised system.  A Jabber identifier
  49 (JID) is of the form =username@server=, just like an e-mail address, and
  50 every Jabber user whose server is open to Internet connections can
  51 communicate with any other user.  This is in stark contrast to the
  52 legacy "walled-garden" IM systems, where you need a separate account
  53 for each system to be able to communicate with its users.  Note that
  54 the [[http://talk.google.com][Google Talk]] service is an XMPP service, so if you have a GMail
  55 account, you already have a JID ending with =@gmail.com=.
  56
  57 In Jabber, you have a "roster", a list of contacts.  You can see
  58 which of them are online at the moment, and chat with them.  (You can
  59 also send messages to an offline contact, and the message will be
  60 stored on the server for later delivery.)  Jabber also supports
  61 IRC-style chat rooms.
  62
  63 * What is jabber.el?
  64
  65 jabber.el is a Jabber client for Emacs.  It may seem strange to have a
  66 chat client in an editor, but consider that chatting is, after all,
  67 just a special case of text editing.
  68
  69 * Downloading and installing
  70
  71 ** Prepackaged
  72
  73 Note that jabber.el is available as [[http://packages.debian.org/emacs-jabber][emacs-jabber in Debian]], and in
  74 [[http://packages.ubuntu.com/emacs-jabber][Ubuntu's "universe" section]].
  75
  76 ** Dependencies
  77
  78 jabber.el requires either GNU Emacs 22, or GNU Emacs 21 combined with
  79 Gnus 5.10.  You should get these from your distribution, or from the
  80 [[http://www.gnu.org/software/emacs/][Emacs]] and [[http://gnus.org][Gnus]] web sites.
  81
  82 However, if you want to connect to servers that use SRV records
  83 (e.g. Google Talk), it is recommended to use either No Gnus or Gnus
  84 5.13.
  85
  86 If you want encrypted connections (some servers, e.g. Google Talk,
  87 require it), you need [[http://www.gnu.org/software/gnutls/][GnuTLS]] installed.
  88
  89 ** Downloading
  90
  91 Download the [[impatient][latest release]] and unpack it in a suitable location.  Add
  92 something like the following to your =.emacs= file:
  93
  94 #+BEGIN_EXAMPLE
  95 ;; adjust this path:
  96 (add-to-list 'load-path "/path/to/emacs-jabber")
  97 ;; For 0.7.1 and below:
  98 (require 'jabber)
  99 ;; For 0.7.90 and above:
 100 (require 'jabber-autoloads)
 101 #+END_EXAMPLE
 102
 103 Either evaluate those lines, or restart Emacs.
 104
 105 ** Using
 106
 107 See the [[file:manual-0.7.1/Basic-operation.html][Basic Operation]] in the manual.
 108
 109
 110
 111 * Reporting bugs
 112
 113 Bug reports can be sent either to the mailing list
 114 [[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]].
 115
 116
 117 * Latest source
 118
 119 jabber.el releases are, unfortunately, less frequent than they would
 120 be in an ideal world.  You can get the latest development version
 121 using various version control systems.
 122
 123 ** CVS
 124
 125 See [[http://sourceforge.net/cvs/?group_id=88346][the Sourceforge CVS page]].  In short, run the following command:
 126
 127 #+BEGIN_EXAMPLE
 128 cvs -z3 -d:pserver:anonymous@emacs-jabber.cvs.sourceforge.net:/cvsroot/emacs-jabber co -P emacs-jabber
 129 #+END_EXAMPLE
 130
 131 ** GNU Arch
 132
 133 The GNU Arch mirror is no longer being updated.
 134
 135 ** git
 136
 137 #+BEGIN_EXAMPLE
 138 git-clone git://git.catap.ru/emacs-jabber.git
 139 #+END_EXAMPLE
 140
 141
 142 * List of releases
 143
 144 The list of releases has been moved to a [[file:list-of-releases.org][separate page]].
 145
 146 # Local variables:
 147 # mode: org
 148 # eval: (progn (add-to-list 'org-link-types "xmpp") (org-make-link-regexps))
 149 # End: