Add documentation to Table methods. Fixes #951.

A rebased version of #1592