+
What is Jabber?
+
+
+
+Jabber is an open instant messaging (IM) system, also known as XMPP.
+It is described in RFCs 3920-3923 and a series of 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 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 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.
+
+
+
+ Date: 2009/02/19 1:31:21 AM
+
+
diff --git a/www/index.org b/www/index.org
new file mode 100644
index 0000000..2be4e8d
--- /dev/null
+++ b/www/index.org
@@ -0,0 +1,149 @@
+#+TITLE: jabber.el
+#+OPTIONS: num:nil author:nil skip:nil
+
+#+BEGIN_HTML
+>
+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: jabber.el@conference.jabber.se
+ - 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:
diff --git a/www/list-of-releases.html b/www/list-of-releases.html
new file mode 100644
index 0000000..b46edef
--- /dev/null
+++ b/www/list-of-releases.html
@@ -0,0 +1,200 @@
+
+
+
+List of releases - jabber.el
+
+
+
+
+
+
+List of releases - jabber.el
+Back to main page
+
+
+
+
+
+
+- STARTTLS
+- SRV records (requires No Gnus)
+- Message composition buffer
+- XMPP URIs are handled (see manual for setup)
+- Autoaway
+- MUC improvements
+
+
+- Don't display alerts for your own messages
+- Presence changes are sent to MUC rooms too
+- Check room features before joining
+
+
+ - Avatars
+
+- File transfer
+
+- Sound files per contact for alerts
+
+- New function: jabber-send-directed-presence
+
+- Entity time supported (XEP-0090)
+
+- Last activity supported (XEP-0012)
+
+
+Read the manual.
+
+
+
+
+
+- SSL connections possible
+- Chat buffers rewritten
+- MUC improved
+- Global key bindings under C-x C-j
+- Vcard viewer and editor
+- Roster export
+- Message events (JEP-0022)
+- Easy way to define external notifiers
+- Activity mode improved
+- Roster display optimized
+- Optionally use per-contact history files
+- Jabber menu in menubar not enabled by default
+- Flyspell in chat buffers
+- Different time formats for instant and delayed messages
+- Chat buffers in inactive windows are scrolled
+- Roster is sorted by name also
+- Countless bugfixes
+
+
+Read the manual.
+
+
+
+
+- Now works with ejabberd
+- Message history (Mathias Dahl)
+- Backlogs
+- Activity tracking on the mode line (Carl Henrik Lunde)
+- Receive an alert when a specific person goes online (Mathias Dahl)
+- Support for /me in chats (Nolan Eakins)
+- Message alerts for current buffer can be disabled
+- Basic moderation support in MUC
+- MUC alerts are separated from ordinary message alerts
+
+
+Read the
+manual,
+in which there is now a section on
+protocol support.
+
+
+
+
+- Chat buffers no longer use the minibuffer, making it easier to use
+ ordinary editor commands and to pause writing halfway
+- The roster display and the chat buffer prompts are now customizable
+- The online status of the contact is displayed in the chat buffer
+ (Emacs only)
+- The connect function automatically sends presence after connecting
+- The names of the roster buffer and chat buffers are customizable
+- RET and C-k do what you would expect in the roster buffer
+
+
+Read the manual.
+
+
+
+
+- Nicknames are accepted whenever a JID is asked for.
+- Roster entry spacing is customizable (default is none)
+- Bug fix regarding mixed-case JIDs
+- Experimental code for receiving files - see the README
+- Read the manual
+
+
+
+
+
+- Modular design; plugins easier to write
+- Support for Ad-Hoc Commands and setting presence remotely
+- Browse documentation here
+
+
+
+
+- XEmacs support - basically works, needs testing and care.
+- "Set status" menu fixed
+
+
+version 0.4 - 05-February-2004
+
+- SHA-1 password hashing
+- customisation hooks
+- browsing improved
+- added service discovery
+- added in-band registration
+- added searching
+- new manual
+
+version 0.3 - 21-April-2002
+
+- improved groupchat support (thanks to nimrod for tip)
+- improved roster (buddy-list) display
+- infoquery rewritten - great improvement
+- improved minimal browsing support !
+- added customizable faces
+- added more customizable variables
+- more (helpful) comments in code
+- added explicit licensing (GPL, like emacs itself)
+
+version 0.2 - 05-April-2002
+
+- added groupchat support !
+- added minimal browsing support !
+- fixed bug in chat mode
+- abolished message mode (i only use chat mode anyway)
+- fixed some problems with incoming xml
+- added a pull-down menu
+- added customizable variables
+
+
+features currently missing (TODO)
+
+- global keymaps
+- logging (history)
+- overall exception handling
+- sanity checks (for incoming xml, and for myself :)
+- clickable URLs in messages
+- support for versions other than gnu-emacs-21 (older emacs, xemacs, jemacs)
+- and more...
+
+
+ Date: 2009/01/31 3:00:13 AM
+
+
diff --git a/www/list-of-releases.org b/www/list-of-releases.org
new file mode 100644
index 0000000..0e6f807
--- /dev/null
+++ b/www/list-of-releases.org
@@ -0,0 +1,167 @@
+#+TITLE: List of releases - jabber.el
+#+OPTIONS: author:nil skip:nil
+
+[[file:index.org][Back to main page]]
+
+#+BEGIN_HTML
+
+
+
+- STARTTLS
+- SRV records (requires No Gnus)
+- Message composition buffer
+- XMPP URIs are handled (see manual for setup)
+- Autoaway
+- MUC improvements
+
+
+- Don't display alerts for your own messages
+- Presence changes are sent to MUC rooms too
+- Check room features before joining
+
+
+ - Avatars
+
+- File transfer
+
+- Sound files per contact for alerts
+
+- New function: jabber-send-directed-presence
+
+- Entity time supported (XEP-0090)
+
+- Last activity supported (XEP-0012)
+
+
+Read the manual.
+
+
+
+
+
+- SSL connections possible
+- Chat buffers rewritten
+- MUC improved
+- Global key bindings under C-x C-j
+- Vcard viewer and editor
+- Roster export
+- Message events (JEP-0022)
+- Easy way to define external notifiers
+- Activity mode improved
+- Roster display optimized
+- Optionally use per-contact history files
+- Jabber menu in menubar not enabled by default
+- Flyspell in chat buffers
+- Different time formats for instant and delayed messages
+- Chat buffers in inactive windows are scrolled
+- Roster is sorted by name also
+- Countless bugfixes
+
+
+Read the manual.
+
+
+
+
+- Now works with ejabberd
+- Message history (Mathias Dahl)
+- Backlogs
+- Activity tracking on the mode line (Carl Henrik Lunde)
+- Receive an alert when a specific person goes online (Mathias Dahl)
+- Support for /me in chats (Nolan Eakins)
+- Message alerts for current buffer can be disabled
+- Basic moderation support in MUC
+- MUC alerts are separated from ordinary message alerts
+
+
+Read the
+manual,
+in which there is now a section on
+protocol support.
+
+
+
+
+- Chat buffers no longer use the minibuffer, making it easier to use
+ ordinary editor commands and to pause writing halfway
+- The roster display and the chat buffer prompts are now customizable
+- The online status of the contact is displayed in the chat buffer
+ (Emacs only)
+- The connect function automatically sends presence after connecting
+- The names of the roster buffer and chat buffers are customizable
+- RET and C-k do what you would expect in the roster buffer
+
+
+Read the manual.
+
+
+
+
+- Nicknames are accepted whenever a JID is asked for.
+- Roster entry spacing is customizable (default is none)
+- Bug fix regarding mixed-case JIDs
+- Experimental code for receiving files - see the README
+- Read the manual
+
+
+
+
+
+- Modular design; plugins easier to write
+- Support for Ad-Hoc Commands and setting presence remotely
+- Browse documentation here
+
+
+
+
+- XEmacs support - basically works, needs testing and care.
+- "Set status" menu fixed
+
+
+version 0.4 - 05-February-2004
+
+- SHA-1 password hashing
+- customisation hooks
+- browsing improved
+- added service discovery
+- added in-band registration
+- added searching
+- new manual
+
+version 0.3 - 21-April-2002
+
+- improved groupchat support (thanks to nimrod for tip)
+- improved roster (buddy-list) display
+- infoquery rewritten - great improvement
+- improved minimal browsing support !
+- added customizable faces
+- added more customizable variables
+- more (helpful) comments in code
+- added explicit licensing (GPL, like emacs itself)
+
+version 0.2 - 05-April-2002
+
+- added groupchat support !
+- added minimal browsing support !
+- fixed bug in chat mode
+- abolished message mode (i only use chat mode anyway)
+- fixed some problems with incoming xml
+- added a pull-down menu
+- added customizable variables
+
+
+features currently missing (TODO)
+
+- global keymaps
+- logging (history)
+- overall exception handling
+- sanity checks (for incoming xml, and for myself :)
+- clickable URLs in messages
+- support for versions other than gnu-emacs-21 (older emacs, xemacs, jemacs)
+- and more...
+
+#+END_HTML
+
+# Local variables:
+# mode: org
+# End:
diff --git a/www/oldindex.html b/www/oldindex.html
new file mode 100644
index 0000000..57f2408
--- /dev/null
+++ b/www/oldindex.html
@@ -0,0 +1,217 @@
+
+
+
+jabber.el
+
+
+jabber.el
+a minimal jabber client for emacs
+
+
+
+
+see also the
+JabberEl page of EmacsWiki,
+the mailing list and the chat room (it's jabber.el@conference.jabber.se, if your web browser is not configured for XMPP URIs).
+
+if you use GNU Arch, you can use the
+Arch mirror of the CVS repository. these commands get it for you:
+
+tla register-archive http://www.dtek.chalmers.se/~henoch/archive-2005
+tla get mange@freemail.hu--2005/emacs-jabber--cvs-head--0 emacs-jabber
+
+it's manually maintained, so bug Magnus (JID: legoscia@jabber.cd.chalmers.se) if it
+doesn't seem up to date.
+
+
+
+
+- STARTTLS
+- SRV records (requires No Gnus)
+- Message composition buffer
+- XMPP URIs are handled (see manual for setup)
+- Autoaway
+- MUC improvements
+
+
+- Don't display alerts for your own messages
+- Presence changes are sent to MUC rooms too
+- Check room features before joining
+
+
+ - Avatars
+
+- File transfer
+
+- Sound files per contact for alerts
+
+- New function: jabber-send-directed-presence
+
+- Entity time supported (XEP-0090)
+
+- Last activity supported (XEP-0012)
+
+
+Read the manual.
+
+
+
+
+
+- SSL connections possible
+- Chat buffers rewritten
+- MUC improved
+- Global key bindings under C-x C-j
+- Vcard viewer and editor
+- Roster export
+- Message events (JEP-0022)
+- Easy way to define external notifiers
+- Activity mode improved
+- Roster display optimized
+- Optionally use per-contact history files
+- Jabber menu in menubar not enabled by default
+- Flyspell in chat buffers
+- Different time formats for instant and delayed messages
+- Chat buffers in inactive windows are scrolled
+- Roster is sorted by name also
+- Countless bugfixes
+
+
+Read the manual.
+
+
+
+
+- Now works with ejabberd
+- Message history (Mathias Dahl)
+- Backlogs
+- Activity tracking on the mode line (Carl Henrik Lunde)
+- Receive an alert when a specific person goes online (Mathias Dahl)
+- Support for /me in chats (Nolan Eakins)
+- Message alerts for current buffer can be disabled
+- Basic moderation support in MUC
+- MUC alerts are separated from ordinary message alerts
+
+
+Read the
+manual,
+in which there is now a section on
+protocol support.
+
+
+
+
+- Chat buffers no longer use the minibuffer, making it easier to use
+ ordinary editor commands and to pause writing halfway
+- The roster display and the chat buffer prompts are now customizable
+- The online status of the contact is displayed in the chat buffer
+ (Emacs only)
+- The connect function automatically sends presence after connecting
+- The names of the roster buffer and chat buffers are customizable
+- RET and C-k do what you would expect in the roster buffer
+
+
+Read the manual.
+
+
+
+
+- Nicknames are accepted whenever a JID is asked for.
+- Roster entry spacing is customizable (default is none)
+- Bug fix regarding mixed-case JIDs
+- Experimental code for receiving files - see the README
+- Read the manual
+
+
+
+
+
+- Modular design; plugins easier to write
+- Support for Ad-Hoc Commands and setting presence remotely
+- Browse documentation here
+
+
+
+
+- XEmacs support - basically works, needs testing and care.
+- "Set status" menu fixed
+
+
+version 0.4 - 05-February-2004
+
+- SHA-1 password hashing
+- customisation hooks
+- browsing improved
+- added service discovery
+- added in-band registration
+- added searching
+- new manual
+
+version 0.3 - 21-April-2002
+
+- improved groupchat support (thanks to nimrod for tip)
+- improved roster (buddy-list) display
+- infoquery rewritten - great improvement
+- improved minimal browsing support !
+- added customizable faces
+- added more customizable variables
+- more (helpful) comments in code
+- added explicit licensing (GPL, like emacs itself)
+
+version 0.2 - 05-April-2002
+
+- added groupchat support !
+- added minimal browsing support !
+- fixed bug in chat mode
+- abolished message mode (i only use chat mode anyway)
+- fixed some problems with incoming xml
+- added a pull-down menu
+- added customizable variables
+
+
+features currently missing (TODO)
+
+- global keymaps
+- logging (history)
+- overall exception handling
+- sanity checks (for incoming xml, and for myself :)
+- clickable URLs in messages
+- support for versions other than gnu-emacs-21 (older emacs, xemacs, jemacs)
+- and more...
+
+
+installation
+get the module emacs-jabber from Sourceforge CVS.
+additionally, if you don't have Gnus 5.10 (M-x gnus-version will tell), you will need hex-util.el
+and sha1-el.el from Gnus CVS.
+copy these to a directory in your emacs load path.
+in your .emacs file add the call (require 'jabber). you can also use auto-load.
+set your account details with M-x jabber-customize. then, type M-x jabber-connect to connect,
+and M-x jabber-send-presence to send initial presence.
+please note that the current version is dependant on gnu-emacs-21 - it depends on xml.el (which you can download separately) and on some newer functions.
+howto
+as jabber.el is still very young, you'll have to be rather emacs-savvy to use it (or at least have the willingness to learn a little).
+to connect to the server, call (jabber-connect).
+call it from the pull-down menu or call interactively : [M-x jabber-connect RET] and enter the parameters from the minibuffer.
+after a successful connection, a new buffer should appear, named *-jabber-*. this buffer is your roster view. click any user with the mouse to start a 1-on-1 chat.
+alternatively, you can also call (jabber-chat-with jid).
+for example : (jabber-chat-with "object@magaf.org")
+or [M-x jabber-chat-with RET]. in that case you will be asked for a jid. use the TAB key to complete a partial jid from the roster. (nice, eh?)
+to send a message, call (jabber-send-message to body subject type)
+for example : (jabber-send-message "object@magaf.org" "hi there" "" "") will appear as an instant message.
+(jabber-send-message "object@magaf.org" "tom, you are the best" "the truth, nothing but the truth" "normal") too.
+(jabber-send-message "object@magaf.org" "hya" "" "chat") will appear as a 1-on-1 chat
+of course, this too can be called interactively : [M-x jabber-send-message RET] (with jid completion, like anywhere else).
+to change your status, call (jabber-send-presence show status).
+for example : (jabber-send-presence "" "Online") to appear online, or (jabber-send-presence "dnd" "copulating") to appear lucky.
+needless to say, this can be called from the minibuffer too. do [M-x jabber-send-presence RET] and enjoy TAB completion from "", "away", "xa", "dnd" or "chat" for the first parameter (show).
+when a new chat message arrives, it is sent to the chat buffer ("*jabber-chat-:-user*"). if such a buffer does not exist it is created. in this buffer, all straight keystrokes are being captured for starting the reply command. to send a line, simply start typing...
+all messages are converted to 1-on-1 chats (simply because i find that more convinient).
+contact
+jabber.el is written by Tom Berger (Jabber: object@jabber.org.uk) and
+Magnus Henoch (Jabber: legoscia@jabber.cd.chalmers.se). feel free to contact us. you can also report bugs at the
+Sourceforge project page.
+
+
diff --git a/www/upload.sh b/www/upload.sh
new file mode 100644
index 0000000..4065ae8
--- /dev/null
+++ b/www/upload.sh
@@ -0,0 +1,14 @@
+#!/bin/sh
+
+# In ~/.ssh/config, include the following
+#
+# Host emacs-jabber-www
+# HostName web.sourceforge.net
+# User SFUSERNAME,emacs-jabber
+
+if [ ! -f index.org ]; then
+ echo "Error: must be run in www checkout root" 1>&2
+ exit 1
+fi
+
+rsync -v *.html emacs-jabber-www:htdocs/