diff mod_smacks_noerror/README.markdown @ 2392:d1e975c24545

mod_smacks_noerror: Initial commit
author tmolitor <thilo@eightysoft.de>
date Tue, 22 Nov 2016 21:14:47 +0100
parents
children ea6b5321db50
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_smacks_noerror/README.markdown	Tue Nov 22 21:14:47 2016 +0100
@@ -0,0 +1,37 @@
+---
+labels:
+- 'Stage-Alpha'
+summary: Monkeypatch mod_smacks to silently discard unacked message stanzas when a hibernation times out
+...
+
+Introduction
+============
+
+By default mod_smacks sends back error stanzas for every unacked message
+stanza when the hibernation times out.
+This leads to "message not delivered" errors displayed in clients.
+
+When you are certain that *all* your clients use MAM, this is unneccessary and
+confuses users (the message will eventually be delivered via MAM).
+
+This module therefore monkeypatches mod_smacks to silently drop those
+unacked message stanzas instead of sending error replies.
+Unacked iq stanzas are still answered with an error reply though.
+
+Warning
+=======
+
+You most certainly *should not* use this module if you cannot be certain
+that *all* your clients support and use MAM!
+
+Compatibility
+=============
+
+  ----- -------------------------------------------------------------------
+  trunk Untested
+  0.10  Works
+  0.9   Untested but should work
+  0.8   Untested but should work, use version [7693724881b3] of mod_smacks
+  ----- -------------------------------------------------------------------
+
+[7693724881b3]: //hg.prosody.im/prosody-modules/raw-file/7693724881b3/mod_smacks/mod_smacks.lua