Add documentation for runtime persistent cache

Rename AsLua to AsTable

LuaValue.cpp

@@ -73,7 +73,7 @@ void LuaVal::Register(lua_State* L) {
     lua_pushcfunction(L, &LuaVal::lua_AsLuaVal);
     lua_setfield(L, -2, "New");
     lua_pushcfunction(L, &LuaVal::lua_asLua);
-    lua_setfield(L, -2, "AsLua");
+    lua_setfield(L, -2, "AsTable");
 
     lua_setglobal(L, "LuaVal");
 }

TrinityCore/MapMethods.h

@@ -337,6 +337,27 @@ namespace LuaMap
         return 1;
     }
 
+    /**
+     * Returns a runtime-persistent cache tied to the [Map].
+     * This data will remain for as long as the [Map] exists, or until a server restart.
+     *
+     * A reload of the Lua state will NOT clear this cache.
+     *
+     * This cache can be added to and read from with the following sub-methods.
+     * <pre>
+     * -- Sets the key-value pair in the cache
+     * Map:Data():Set("key", val)
+     *
+     * -- Returns the value from the cache using the key
+     * local val = Map:Data():Get("key")
+     *
+     * -- Removes the key-value pair from the cache
+     * Map:Data():Set("key", nil)
+     *
+     * -- Returns all the key-value pairs as a Lua table indexed by the keys
+     * local table = Map:Data():AsTable()
+     * </pre>
+     */
     int Data(Eluna* E, Map* map)
     {
         return LuaVal::PushLuaVal(E->L, map->lua_data);

TrinityCore/WorldObjectMethods.h

@@ -1130,6 +1130,27 @@ namespace LuaWorldObject
         return 0;
     }
 
+    /**
+     * Returns a runtime-persistent cache tied to the [WorldObject].
+     * This data will remain for as long as the [WorldObject] exists, or until a server restart.
+     *
+     * A reload of the Lua state will NOT clear this cache.
+     *
+     * This cache can be added to and read from with the following sub-methods.
+     * <pre>
+     * -- Sets the key-value pair in the cache
+     * WorldObject:Data():Set("key", val)
+     *
+     * -- Returns the value from the cache using the key
+     * local val = WorldObject:Data():Get("key")
+     *
+     * -- Removes the key-value pair from the cache
+     * WorldObject:Data():Set("key", nil)
+     *
+     * -- Returns all the key-value pairs as a Lua table indexed by the keys
+     * local table = WorldObject:Data():AsTable()
+     * </pre>
+     */
     int Data(Eluna* E, WorldObject* obj)
     {
         return LuaVal::PushLuaVal(E->L, obj->lua_data);