From cebf8c245139065242f63f1a125f8b6ab2d0f481 Mon Sep 17 00:00:00 2001 From: JC Brand Date: Tue, 2 Sep 2014 16:53:44 +0200 Subject: [PATCH] See below... * Update docs on message carbons and stanza forwarding. * Mention latest bug fix. --- docs/CHANGES.rst | 2 ++ docs/source/index.rst | 31 +++++++++++++++++++++++++------ 2 files changed, 27 insertions(+), 6 deletions(-) diff --git a/docs/CHANGES.rst b/docs/CHANGES.rst index be4b8d6da..5339c9355 100644 --- a/docs/CHANGES.rst +++ b/docs/CHANGES.rst @@ -5,6 +5,8 @@ Changelog ------------------ * Converse.js now responds to XEP-0030: Service Discovery requests. [jcbrand] +* Bugfix. Roster groups all appear offline after page reload (with prebind). + See http://librelist.com/browser//conversejs/2014/8/26/problem-with-contact-list-everyone-is-offline/ [heban and jcbrand] * #212 Bugfix. Groups weren't being show again after the live filter was cleared. [jcbrand] * #215 (and also #75) XEP-0249: Direct MUC Invitations. [jcbrand] * #216 Contacts tab empty when using xhr_user_search. [hcderaad and jcbrand] diff --git a/docs/source/index.rst b/docs/source/index.rst index c98b21618..a080261aa 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -899,12 +899,26 @@ Default: ``false`` If set to true, debugging output will be logged to the browser console. message_carbons ----------------------- +--------------- Default: ``false`` Support for `XEP-0280: Message Carbons `_ +In order to keep all IM clients for a user engaged in a conversation, +outbound messages are carbon-copied to all interested resources. + +This is especially important in webchat, like converse.js, where each browser +tab serves as a separate IM client. + +Both message_carbons and `forward_messages`_ try to solve the same problem +(showing sent messages in all connected chat clients aka resources), but go about it +in two different ways. + +Message carbons is the XEP (Jabber protocol extension) specifically drafted to +solve this problem, while `forwarded_messages`_ uses +`stanza forwarding `_ + expose_rid_and_sid ------------------ @@ -922,13 +936,18 @@ forward_messages Default: ``false`` -If set to ``true``, sent messages will also be forwarded to other connected -XMPP resources (e.g. chat clients) of the same user. +If set to ``true``, sent messages will also be forwarded to the sending user's +bare JID (their Jabber ID independent of any chat clients aka resources). -This is useful for example if converse.js is running in multiple tabs of the -browser and you want sent messages to appear in all of them. +This means that sent messages are visible from all the user's chat clients, +and not just the one from which it was actually sent. -See also `XEP 0297: Stanza Forwarding `_ +This is especially important for web chat, such as converse.js, where each +browser tab functions as a separate chat client, with its own resource. + +This feature uses Stanza forwarding, see also `XEP 0297: Stanza Forwarding `_ + +For an alternative approach, see also `message carbons`_. fullname --------