doc: overhaul LDocs for std.table.

* lib/std/table.lua: Tidy up LDocs, and add @usage examples.

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