doc: use LDoc @object type for std.list

* lib/std/list.lua: Improve documentation.

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