misc: started documenting the lua api, refs #610