index.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   2                "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml"
   4 lang="en" xml:lang="en">
   5 <head>
   6 <title>jabber.el</title>
   7 <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/>
   8 <meta name="generator" content="Org-mode"/>
   9 <meta name="generated" content="2009/02/19 1:31:21 AM"/>
  10 <meta name="author" content=""/>
  11 <style type="text/css">
  12   html {
  13         font-family: Times, serif;
  14         font-size: 12pt;
  15   }
  16   .title { text-align: center; }
  17   .todo  { color: red; }
  18   .done { color: green; }
  19   .timestamp { color: grey }
  20   .timestamp-kwd { color: CadetBlue }
  21   .tag { background-color:lightblue; font-weight:normal }
  22   .target { background-color: lavender; }
  23   pre {
  24         border: 1pt solid #AEBDCC;
  25         background-color: #F3F5F7;
  26         padding: 5pt;
  27         font-family: courier, monospace;
  28   }
  29   table { border-collapse: collapse; }
  30   td, th {
  31         vertical-align: top;
  32         <!--border: 1pt solid #ADB9CC;-->
  33   }
  34 </style>
  35 </head><body>
  36 <h1 class="title">jabber.el</h1>
  37 <a href="http://sourceforge.net">
  38 <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>
  39
  40 jabber.el is a Jabber client for Emacs.
  41
  42 <div id="table-of-contents">
  43 <h2>Table of Contents</h2>
  44 <ul>
  45 <li><a href="#sec-1">What is Jabber?</a></li>
  46 <li><a href="#sec-2">What is jabber.el?</a></li>
  47 <li><a href="#sec-3">Downloading and installing</a>
  48 <ul>
  49 <li><a href="#sec-4">Prepackaged</a></li>
  50 <li><a href="#sec-5">Dependencies</a></li>
  51 <li><a href="#sec-6">Downloading</a></li>
  52 <li><a href="#sec-7">Using</a></li>
  53 </ul>
  54 </li>
  55 <li><a href="#sec-8">Reporting bugs</a></li>
  56 <li><a href="#sec-9">Latest source</a>
  57 <ul>
  58 <li><a href="#sec-10">CVS</a></li>
  59 <li><a href="#sec-11">GNU Arch</a></li>
  60 <li><a href="#sec-12">git</a></li>
  61 </ul>
  62 </li>
  63 <li><a href="#sec-13">List of releases</a></li>
  64 </ul>
  65 </div>
  66
  67 <p>
  68 <a name="impatient">&nbsp;</a>
  69 For the impatient:
  70 </p>
  71 <ul>
  72 <li>
  73 Latest release: <a href="http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=92339&release_id=482983">0.7.1</a> (31-Jan-2007)
  74 </li>
  75 <li>
  76 Latest pretest release: <a href="http://sourceforge.net/project/showfiles.php?group_id=88346&package_id=278300&release_id=662240">0.7.93</a> (19-Feb-2009)
  77 </li>
  78 <li>
  79 Full <a href="#list-of-releases">list of releases</a>, including lists of features and changes
  80
  81 </li>
  82 </ul>
  83 <p>External resources:
  84 </p>
  85 <ul>
  86 <li>
  87 <a href="http://sourceforge.net/projects/emacs-jabber/">Sourceforge project page</a>, containing:
  88 <ul>
  89 <li>
  90 trackers for
  91 <a href="http://sourceforge.net/tracker/?atid=586350&group_id=88346&func=browse">bugs</a>,
  92 <a href="http://sourceforge.net/tracker/?atid=586353&group_id=88346&func=browse">feature requests</a>,
  93 <a href="http://sourceforge.net/tracker/?atid=586352&group_id=88346&func=browse">patches</a> and
  94 <a href="http://sourceforge.net/tracker/?atid=586351&group_id=88346&func=browse">support requests</a>, open for anonymous posters
  95 </li>
  96 <li>
  97 <a href="http://sourceforge.net/forum/?group_id=88346">forums</a>, open for anonymous posters
  98 </li>
  99 </ul></li>
 100 <li>
 101 <a href="http://www.emacswiki.org/cgi-bin/wiki/JabberEl">the JabberEl page of EmacsWiki</a>
 102 </li>
 103 <li>
 104 Mailing lists (also available at <a href="http://gmane.net">Gmane</a>):
 105 <ul>
 106 <li>
 107 <a href="http://lists.sourceforge.net/lists/listinfo/emacs-jabber-general">emacs-jabber-general</a>, for posts by humans (also <a href="http://dir.gmane.org/gmane.emacs.jabber.general">gmane.emacs.jabber.general</a>)
 108 </li>
 109 <li>
 110 <a href="http://lists.sourceforge.net/lists/listinfo/emacs-jabber-commit">emacs-jabber-commit</a>, read-only mailing list of CVS commits (also <a href="http://dir.gmane.org/gmane.emacs.jabber.scm">gmane.emacs.jabber.scm</a>)
 111 </li>
 112 <li>
 113 <a href="http://lists.sourceforge.net/lists/listinfo/emacs-jabber-bugs">emacs-jabber-bugs</a>, read-only mailing list of bug tracker activity (also <a href="http://dir.gmane.org/gmane.emacs.jabber.bugs">gmane.emacs.jabber.bugs</a>)
 114 </li>
 115 </ul></li>
 116 <li>
 117 the Jabber chat room
 118 <a href="xmpp:jabber.el@conference.jabber.se?join">jabber.el@conference.jabber.se</a>
 119 </li>
 120 <li>
 121 the <a href="manual-0.7.1/">manual for jabber.el 0.7.1</a> (also included in the release files)
 122
 123 </li>
 124 </ul>
 125 <div class="outline-2">
 126 <h2 id="sec-1">What is Jabber?</h2>
 127
 128
 129 <p>
 130 Jabber is an open instant messaging (IM) system, also known as XMPP.
 131 It is described in <a href="http://www.xmpp.org/rfcs/">RFCs 3920-3923</a> and a series of <a href="http://www.xmpp.org/extensions/">XEPs</a> (XMPP Extension
 132 Proposals).  That is, unlike legacy IM systems (such as ICQ or MSN
 133 Messenger), the protocol is published in the open, free for anyone to
 134 implement.  Therefore you shouldn't be surprised that there is a
 135 Jabber client for Emacs, too.  (If you are not of the Emacs
 136 persuasion, see this <a href="http://www.jabber.org/software/clients.shtml">list of Jabber clients</a>.)
 137 </p>
 138 <p>
 139 Jabber is, like e-mail, a decentralised system.  A Jabber identifier
 140 (JID) is of the form <code>username@server</code>, just like an e-mail address, and
 141 every Jabber user whose server is open to Internet connections can
 142 communicate with any other user.  This is in stark contrast to the
 143 legacy "walled-garden" IM systems, where you need a separate account
 144 for each system to be able to communicate with its users.  Note that
 145 the <a href="http://talk.google.com">Google Talk</a> service is an XMPP service, so if you have a GMail
 146 account, you already have a JID ending with <code>@gmail.com</code>.
 147 </p>
 148 <p>
 149 In Jabber, you have a "roster", a list of contacts.  You can see
 150 which of them are online at the moment, and chat with them.  (You can
 151 also send messages to an offline contact, and the message will be
 152 stored on the server for later delivery.)  Jabber also supports
 153 IRC-style chat rooms.
 154 </p>
 155 </div>
 156
 157 <div class="outline-2">
 158 <h2 id="sec-2">What is jabber.el?</h2>
 159
 160
 161 <p>
 162 jabber.el is a Jabber client for Emacs.  It may seem strange to have a
 163 chat client in an editor, but consider that chatting is, after all,
 164 just a special case of text editing.
 165 </p>
 166 </div>
 167
 168 <div class="outline-2">
 169 <h2 id="sec-3">Downloading and installing</h2>
 170
 171
 172
 173 <div class="outline-3">
 174 <h3 id="sec-4">Prepackaged</h3>
 175
 176
 177 <p>
 178 Note that jabber.el is available as <a href="http://packages.debian.org/emacs-jabber">emacs-jabber in Debian</a>, and in
 179 <a href="http://packages.ubuntu.com/emacs-jabber">Ubuntu's "universe" section</a>.
 180 </p>
 181 </div>
 182
 183 <div class="outline-3">
 184 <h3 id="sec-5">Dependencies</h3>
 185
 186
 187 <p>
 188 jabber.el requires either GNU Emacs 22, or GNU Emacs 21 combined with
 189 Gnus 5.10.  You should get these from your distribution, or from the
 190 <a href="http://www.gnu.org/software/emacs/">Emacs</a> and <a href="http://gnus.org">Gnus</a> web sites.
 191 </p>
 192 <p>
 193 However, if you want to connect to servers that use SRV records
 194 (e.g. Google Talk), it is recommended to use either No Gnus or Gnus
 195 5.13.
 196 </p>
 197 <p>
 198 If you want encrypted connections (some servers, e.g. Google Talk,
 199 require it), you need <a href="http://www.gnu.org/software/gnutls/">GnuTLS</a> installed.
 200 </p>
 201 </div>
 202
 203 <div class="outline-3">
 204 <h3 id="sec-6">Downloading</h3>
 205
 206
 207 <p>
 208 Download the <a href="#impatient">latest release</a> and unpack it in a suitable location.  Add
 209 something like the following to your <code>.emacs</code> file:
 210 </p>
 211 <p>
 212 <pre>
 213  ;; adjust this path:
 214  (add-to-list 'load-path "/path/to/emacs-jabber")
 215  ;; For 0.7.1 and below:
 216  (require 'jabber)
 217  ;; For 0.7.90 and above:
 218  (require 'jabber-autoloads)
 219 </pre>
 220 </p>
 221 <p>
 222 Either evaluate those lines, or restart Emacs.
 223 </p>
 224 </div>
 225
 226 <div class="outline-3">
 227 <h3 id="sec-7">Using</h3>
 228
 229
 230 <p>
 231 See the <a href="manual-0.7.1/Basic-operation.html">Basic Operation</a> in the manual.
 232 </p>
 233
 234
 235 </div>
 236 </div>
 237
 238 <div class="outline-2">
 239 <h2 id="sec-8">Reporting bugs</h2>
 240
 241
 242 <p>
 243 Bug reports can be sent either to the mailing list
 244 <a href="http://lists.sourceforge.net/lists/listinfo/emacs-jabber-general">emacs-jabber-general</a> or to the <a href="http://sourceforge.net/tracker/?group_id=88346&atid=586350">bug tracker</a>.
 245 </p>
 246
 247 </div>
 248
 249 <div class="outline-2">
 250 <h2 id="sec-9">Latest source</h2>
 251
 252
 253 <p>
 254 jabber.el releases are, unfortunately, less frequent than they would
 255 be in an ideal world.  You can get the latest development version
 256 using various version control systems.
 257 </p>
 258
 259 <div class="outline-3">
 260 <h3 id="sec-10">CVS</h3>
 261
 262
 263 <p>
 264 See <a href="http://sourceforge.net/cvs/?group_id=88346">the Sourceforge CVS page</a>.  In short, run the following command:
 265 </p>
 266 <p>
 267 <pre>
 268  cvs -z3 -d:pserver:anonymous@emacs-jabber.cvs.sourceforge.net:/cvsroot/emacs-jabber co -P emacs-jabber
 269 </pre>
 270 </p>
 271 </div>
 272
 273 <div class="outline-3">
 274 <h3 id="sec-11">GNU Arch</h3>
 275
 276
 277 <p>
 278 The GNU Arch mirror is no longer being updated.
 279 </p>
 280 </div>
 281
 282 <div class="outline-3">
 283 <h3 id="sec-12">git</h3>
 284
 285
 286 <p>
 287 <pre>
 288  git-clone git://git.catap.ru/emacs-jabber.git
 289 </pre>
 290 </p>
 291
 292 </div>
 293 </div>
 294
 295 <div class="outline-2">
 296 <h2 id="sec-13">List of releases</h2>
 297
 298
 299 <p>
 300 The list of releases has been moved to a <a href="list-of-releases.html">separate page</a>.
 301 </p>
 302 </div>
 303 <div id="postamble"><p class="date"> Date: 2009/02/19 1:31:21 AM</p>
 304 </div></body>
 305 </html>