# HG changeset patch
# User Matthew Wild <mwild1@gmail.com>
# Date 1221683585 -3600
# Node ID 23cab333d014a1992f5b1fb3d4ee85c2e81badc5
# Parent  2856dfc1f5ccf352030835e01513b0d8d54dbfce# Parent  ceca8faf23b105203e40e5ca941d8ac04ba7c0df
Merged Paul's branch

diff -r 2856dfc1f5cc -r 23cab333d014 doc/.directory
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/.directory	Wed Sep 17 21:33:05 2008 +0100
@@ -0,0 +1,3 @@
+[Dolphin]
+Timestamp=2008,9,15,21,41,28
+ViewMode=1
diff -r 2856dfc1f5cc -r 23cab333d014 doc/lxmppd_core_offlinemessages.txt
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/lxmppd_core_offlinemessages.txt	Wed Sep 17 21:33:05 2008 +0100
@@ -0,0 +1,12 @@
+lxmppd -> core -> offlinemessages.lua
+	requires	"util.datamanager"
+	module		"offlinemessage"
+
+function new(user, host, stanza)
+	returns a function that stores the offline message it received
+
+This module offers storing of offline messages.
+
+Description:	If the user that is supposed to get the message is not online,
+		we store the messages locally as offline messages for later
+		processing.
\ No newline at end of file
diff -r 2856dfc1f5cc -r 23cab333d014 doc/lxmppd_core_rostermanager.txt
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/lxmppd_core_rostermanager.txt	Wed Sep 17 21:33:05 2008 +0100
@@ -0,0 +1,9 @@
+lxmppd -> core -> rostermanager.lua
+	requires	"util.datamanager"
+	module		"rostermanager"
+	
+function log(type, message)
+	logs a message of type "rostermanager"
+
+function getroster(username, host)
+	Retrieves the user's roster from the server and loads it with the datamanager
\ No newline at end of file
diff -r 2856dfc1f5cc -r 23cab333d014 doc/lxmppd_core_stanz_dispatch.txt
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/lxmppd_core_stanz_dispatch.txt	Wed Sep 17 21:33:05 2008 +0100
@@ -0,0 +1,26 @@
+lxmppd -> core -> stanza_dispatch
+	requires	"util.stanza"
+	requires	"core.usermanager"
+	
+function init_stanza_dispatcher(session)
+	Initialises the stanza dispatcher which handles different stanza according
+	to their type and XML namespace, dispatching to required handlers.
+	
+	iq_handlers["jabber:iq:auth"]
+		A list of handlers for "jabber:iq:auth" stanzas -- authentication
+		(request) stanzas.
+		
+		function (stanza)
+			If one of username, password and resource are missing then it ????.
+			If not, then it validates the credentials and replies with the
+			appropriate stanza.
+			
+	iq_handlers["jabber:iq:roster"]
+		A list of handlers for "jabber:iq:roster" stanzas -- roster management
+		
+		function (stanza)
+			Parses the type of stanza for roster management and does what is
+			requested (roster retrieval, etc.)
+	
+	function (stanza)
+		Validates the stanza and calls the required handler
diff -r 2856dfc1f5cc -r 23cab333d014 util/stanza.lua
--- a/util/stanza.lua	Wed Sep 03 02:24:28 2008 +0100
+++ b/util/stanza.lua	Wed Sep 17 21:33:05 2008 +0100
@@ -1,6 +1,6 @@
 local t_insert      =  table.insert;
 local t_remove      =  table.remove;
-local format        = string.format;
+local s_format      = string.format;
 local tostring      =      tostring;
 local setmetatable  =  setmetatable;
 local pairs         =         pairs;
@@ -97,10 +97,10 @@
 
 	local attr_string = "";
 	if t.attr then
-		for k, v in pairs(t.attr) do if type(k) == "string" then attr_string = attr_string .. format(" %s='%s'", k, tostring(v)); end end
+		for k, v in pairs(t.attr) do if type(k) == "string" then attr_string = attr_string .. s_format(" %s='%s'", k, tostring(v)); end end
 	end
 
-	return format("<%s%s>%s</%s>", t.name, attr_string, children_text, t.name);
+	return s_format("<%s%s>%s</%s>", t.name, attr_string, children_text, t.name);
 end
 
 function stanza_mt.__add(s1, s2)