Lua Documentation clarification/fixes

docs/source/reference/lua-scripting/engine_handlers.rst

@@ -39,7 +39,8 @@ Engine handler is a function defined by a script, that can be called by the engi
   * - onNewGame()
     - New game is started.
   * - onPlayerAdded(player)
-    - Player added to the game world. The argument is a `Game object`.
+    - | Player added to the game world. The argument is a `Game object`. 
+      | Note that this is triggered at the start of a game, and when a game is loaded.
   * - onObjectActive(object)
     - Object becomes active.
   * - onActorActive(actor)

files/lua_api/openmw/core.lua

@@ -306,7 +306,7 @@
 -- end
 
 ---
--- Get all objects of given type from the cell.
+-- Get all objects of given type from the cell; Only available from global scripts.
 -- @function [parent=#Cell] getAll
 -- @param self
 -- @param type (optional) object type (see @{openmw.types#types})

files/lua_api/openmw/nearby.lua

@@ -23,7 +23,7 @@
 -- @field [parent=#nearby] openmw.core#ObjectList doors
 
 ---
--- Everything in the nearby that is derived from @{openmw.types#Item}.
+-- Everything nearby that is derived from @{openmw.types#Item}.
 -- @field [parent=#nearby] openmw.core#ObjectList items
 
 ---
@@ -49,7 +49,7 @@
 -- @field [parent=#COLLISION_TYPE] #number Projectile
 -- @field [parent=#COLLISION_TYPE] #number Water
 -- @field [parent=#COLLISION_TYPE] #number Default Used by default: World+Door+Actor+HeightMap
--- @field [parent=#COLLISION_TYPE] #number AnyPhysical : World+Door+Actor+HeightMap+Projectile+Water
+-- @field [parent=#COLLISION_TYPE] #number AnyPhysical World+Door+Actor+HeightMap+Projectile+Water
 -- @field [parent=#COLLISION_TYPE] #number Camera Objects that should collide only with camera
 -- @field [parent=#COLLISION_TYPE] #number VisualOnly Objects that were not intended to be part of the physics world