doc,functests: Add documentation

Missing: updates to various lists.

test/functional/lua/commands_spec.lua

@@ -2,8 +2,10 @@
 local helpers = require('test.functional.helpers')(after_each)
 
 local eq = helpers.eq
+local NIL = helpers.NIL
 local clear = helpers.clear
 local meths = helpers.meths
+local funcs = helpers.funcs
 local source = helpers.source
 local dedent = helpers.dedent
 local exc_exec = helpers.exc_exec
@@ -54,4 +56,10 @@ describe(':lua command', function()
     ]])
     eq({'', 'ETTS', 'TTSE', 'STTE'}, curbufmeths.get_lines(0, 100, false))
   end)
+  it('preserves global and not preserves local variables', function()
+    eq('', redir_exec('lua gvar = 42'))
+    eq('', redir_exec('lua local lvar = 100500'))
+    eq(NIL, funcs.luaeval('lvar'))
+    eq(42, funcs.luaeval('gvar'))
+  end)
 end)

test/functional/lua/luaeval_spec.lua

@@ -46,6 +46,7 @@ describe('luaeval()', function()
          funcs.luaeval('{n=1, f=1.5, s="string", l={4, 2}}'))
       -- Not tested: nil inside containers: behaviour will most likely change.
       eq(NIL, funcs.luaeval('nil'))
+      eq({['']=1}, funcs.luaeval('{[""]=1}'))
     end)
   end)
   describe('recursive lua values', function()