Merge 0.10->trunk

[prosody.git] / util / events.lua

diff --git a/util/events.lua b/util/events.lua
index d19da98b9165587659166ee2233b95f951fc9bf9..073d2a60fd84b9f317dbf8ace3863eb7cd1556dc 100644 (file)
--- a/util/events.lua
+++ b/util/events.lua
@@ -14,13 +14,18 @@ local t_sort = table.sort;
 local setmetatable = setmetatable;
 local next = next;
 
-module "events"
+local _ENV = nil;
 
-function new()
+local function new()
+       -- Map event name to ordered list of handlers (lazily built): handlers[event_name] = array_of_handler_functions
        local handlers = {};
+       -- Array of wrapper functions that wrap all events (nil if empty)
        local global_wrappers;
+       -- Per-event wrappers: wrappers[event_name] = wrapper_function
        local wrappers = {};
+       -- Event map: event_map[handler_function] = priority_number
        local event_map = {};
+       -- Called on-demand to build handlers entries
        local function _rebuild_index(handlers, event)
                local _handlers = event_map[event];
                if not _handlers or next(_handlers) == nil then return; end
@@ -151,4 +156,6 @@ function new()
        };
 end
 
-return _M;
+return {
+       new = new;
+};