# HG changeset patch
# User Matthew Wild <mwild1@gmail.com>
# Date 1523388620 -3600
# Node ID df1ca586c68de438d21406435024f158f18555b2
# Parent  e098c9b2501419400590ad25c5561396b0ad7eb1
mod_bosh: Some additonal comments to improve code readability

diff -r e098c9b25014 -r df1ca586c68d plugins/mod_bosh.lua
--- a/plugins/mod_bosh.lua	Tue Apr 10 20:29:46 2018 +0100
+++ b/plugins/mod_bosh.lua	Tue Apr 10 20:30:20 2018 +0100
@@ -369,13 +369,15 @@
 		if diff ~= 1 then
 			context.sid = sid;
 			context.notopen = nil;
-			if diff == 2 then
+			if diff == 2 then -- Missed a request
 				-- Hold request, but don't process it (ouch!)
 				session.log("debug", "rid skipped: %d, deferring this request", rid-1)
 				context.defer = true;
 				session.bosh_deferred = { context = context, sid = sid, rid = rid, terminate = attr.type == "terminate" };
 				return;
 			end
+			-- Set a marker to indicate that stanzas in this request should NOT be processed
+			-- (these stanzas will already be in the XML parser's buffer)
 			context.ignore = true;
 			if diff == 0 then
 				-- Re-send previous response, ignore stanzas in this request