doc: add LDocs for functional.lambda return functables.

* lib/std/functional.lua (Lambda): Add LDocs.
(lambda): Document return type correctly.

Signed-off-by: Gary V. Vaughan <gary@gnu.org>